Agenti

Un agente Dialogflow è un agente virtuale che gestisce le conversazioni simultanee con gli utenti finali. È un modulo di comprensione del linguaggio naturale che capisce le sfumature del linguaggio umano. Dialogflow converte il testo o l'audio dell'utente finale durante una conversazione in dati strutturati comprensibili dalle tue app e dai tuoi servizi. Puoi progettare e creare un agente Dialogflow per gestire i tipi di conversazioni richiesti per il sistema.

Un agente Dialogflow è simile a un agente di call center umano. Li addestri a entrambi per gestire gli scenari di conversazione previsti, senza che la tua formazione sia eccessivamente esplicita.

Crea un agente

Nota: puoi creare più agenti CX per un progetto Google Cloud.

Per creare un agente:

Console

1. Apri la console Dialogflow CX.
2. Crea o scegli un progetto Google Cloud.
3. Fai clic su Crea agente.
4. Seleziona Genera automaticamente per creare un agente del datastore oppure seleziona Crea il tuo per creare altri tipi di agenti.
5. Compila il modulo per le impostazioni di base dell'agente:
   1. Puoi scegliere qualsiasi nome visualizzato.
   2. Seleziona la località preferita. Fai clic sul pulsante Modifica per modificare le impostazioni di geolocalizzazione avanzate.
   3. Seleziona il fuso orario che preferisci.
   4. Seleziona la lingua predefinita per l'agente. Non puoi cambiare la lingua predefinita di un agente dopo averlo creato.
6. Fai clic su Salva.

API

Se non hai ancora configurato le impostazioni di geolocalizzazione per il progetto, devi configurarle con la console prima di creare gli agenti con l'API. Al momento, non puoi configurare le impostazioni di geolocalizzazione con l'API.

Per creare un agente, consulta il metodo create per il tipo Agent. Vai al riferimento dell'API Agent

Seleziona un protocollo e una versione per il riferimento dell'agente:

Protocollo	V3	V3beta1
REST	Risorsa agente	Risorsa agente
RPC	Interfaccia agente	Interfaccia agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Go	AgentsClient	Non disponibile
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Non disponibile	Non disponibile
Python	AgentsClient	AgentsClient
Ruby	Non disponibile	Non disponibile

Close

Dati agente

Gli agenti Dialogflow fungono da container di primo livello per le impostazioni e i dati degli agenti virtuali.

Per accedere ai dati di un agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il progetto Google Cloud per l'agente.
3. Trova l'agente nell'elenco.
4. Fai clic sul nome visualizzato dell'agente.
5. Aggiorna flussi, pagine ecc. come descritto in altre guide.

API

Consulta le guide per i dati che vuoi aggiornare.

I seguenti dati sono associati agli agenti:

• Intent
• Tipi di entità
• Webhook
• Flussi
• Pagine
• Gruppi di route

Per ulteriori informazioni su come i dati vengono applicati a vari livelli, consulta Livelli di applicazione dei dati.

Impostazioni dell'agente

Per accedere alle impostazioni dell'agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Fai clic su Impostazioni agente.
5. Aggiorna le impostazioni come preferisci.
6. Fai clic su Salva.

API

Visualizza i metodi get e patch/update per il tipo Agent. Vai al riferimento dell'API Agent

Seleziona un protocollo e una versione per il riferimento dell'agente:

Protocollo	V3	V3beta1
REST	Risorsa agente	Risorsa agente
RPC	Interfaccia agente	Interfaccia agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Go	AgentsClient	Non disponibile
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Non disponibile	Non disponibile
Python	AgentsClient	AgentsClient
Ruby	Non disponibile	Non disponibile

Close

Le seguenti sottosezioni descrivono le diverse categorie di impostazioni dell'agente.

Impostazioni generali

Per gli agenti sono disponibili le seguenti impostazioni generali:

• Nome visualizzato

  Un nome leggibile per l'agente.

• Fuso orario

  Il fuso orario predefinito dell'agente.

• Lingua predefinita

  La lingua predefinita supportata dall'agente. Una volta creato un agente, la lingua predefinita non può essere modificata. Tuttavia, puoi eseguire le seguenti operazioni:

  1. Esporta l'agente in formato JSON.
  2. Decomprimi il file scaricato.
  3. Trova il file agent.json.
  4. Aggiorna i campi defaultLanguageCode e supportedLanguageCodes con i valori desiderati.
  5. Ripristina l'agente nello stesso agente o in un altro agente del passaggio 1.
  6. Aggiorna le frasi di addestramento e i valori delle entità specifiche per la lingua, se necessario.

• Blocco agente

  • Blocca l'agente

    Indica se l'agente è bloccato. Impossibile modificare un agente bloccato.

• Impostazioni di logging

  • Abilita Cloud Logging

    Indica se Cloud Logging è abilitato per l'agente.

  • Attivare il logging delle interazioni

    Indica se vuoi che Google raccolga e memorizzi le query degli utenti finali oscurate per migliorare la qualità.

    Nota: alcune funzionalità, come Esperimenti, Cronologia delle conversazioni, Esportazione in BigQuery, Analytics e il miglioramento del modello NLU, richiedono l'attivazione di questa impostazione poiché si basano sui log del traffico.

• Esportazione in BigQuery

  • Abilitare BigQuery Export

    Indica se l'esportazione in BigQuery è abilitata.

  • Set di dati BigQuery

    Il nome del set di dati BigQuery.

  • Tabella BigQuery

    Il nome della tabella BigQuery.

• Suggerimenti per intenzione

  Puoi attivare i suggerimenti di intent.

• Modello di payload personalizzato

  In questa sezione puoi creare descrizioni e payload per i modelli di payload personalizzati.

Impostazioni ML

Dialogflow utilizza algoritmi di machine learning (ML) per comprendere gli input degli utenti finali, abbinarli agli intent ed estrarre i dati strutturati. Dialogflow apprende dalle frasi di addestramento da te fornite e dai modelli linguistici integrati in Dialogflow. Sulla base di questi dati, crea un modello per prendere decisioni in merito a quale intent deve essere abbinato a un input utente finale. Puoi applicare impostazioni ML univoche per ogni flusso di un agente e il modello creato da Dialogflow è univoco per ogni flusso.

Sono disponibili le seguenti impostazioni ML a livello di agente:

• Consenti al machine learning di correggere l'ortografia

  Se questa impostazione è abilitata e l'input utente finale contiene un errore ortografico o grammaticale, un intent verrà abbinato come se fosse scritto correttamente. La risposta di rilevamento dell'intent conterrà l'input corretto dell'utente finale. Ad esempio, se un utente finale inserisce "Voglio un'applicazione", verrà elaborato come se l'utente finale avesse inserito "Voglio una mela". Questo vale anche per le corrispondenze che coinvolgono sia entità di sistema che personalizzate.

  La correzione ortografica è disponibile in inglese, francese, tedesco, spagnolo e italiano. È disponibile in tutte le regioni di Dialogflow CX.

  Nota: se l'input utente finale originale e quello corretto corrispondono a intent diversi, viene selezionato l'intent corrispondente all'input originale dell'utente finale.

  Avvisi e best practice:

  • La correzione ortografica non è in grado di correggere gli errori ASR (riconoscimento vocale automatico), pertanto non è consigliabile abilitarla per gli agenti che utilizzano input ASR.
  • È possibile che l'input corretto corrisponda all'intent sbagliato. Puoi risolvere il problema aggiungendo frasi comunemente non corrispondenti a esempi negativi.
  • La correzione ortografica aumenta leggermente il tempo di risposta dell'agente.
  • Se un agente viene definito utilizzando un gergo specifico del dominio, le correzioni potrebbero essere indesiderate.

Sono disponibili le seguenti impostazioni ML specifiche per il flusso:

• Tipo di NLU

  Può trattarsi di:

  • NLU avanzata (impostazione predefinita): tecnologia NLU avanzata. Questo tipo di NLU funziona meglio dello standard, soprattutto per agenti e flussi di grandi dimensioni.
  • NLU standard: tecnologia NLU standard. Non riceverai più miglioramenti della qualità o nuove funzionalità.

• Addestramento automatico

  Se abilitato, il flusso viene addestrato ogni volta che viene aggiornato con la console. Per i flussi di grandi dimensioni, ciò potrebbe causare ritardi nell'interfaccia utente della console, quindi devi disabilitare questa impostazione e addestrare manualmente i flussi in base alle necessità.

• Soglia di classificazione

  Per filtrare i risultati falsi positivi e ottenere comunque una varietà di input di linguaggio naturale corrispondenti per il tuo agente, puoi ottimizzare la soglia di classificazione del machine learning. Questa impostazione controlla l'affidabilità minima del rilevamento dell'intento richiesta per una corrispondenza dell'intent.

  Se il punteggio di affidabilità per una corrispondenza di intent è inferiore al valore della soglia, verrà richiamato un evento senza corrispondenza.

  Nota: prima di modificare questo valore, devi provare ad aggiungere esempi negativi.

• Stato addestramento

  Indica se il flusso è stato addestrato dall'ultimo aggiornamento dei dati del flusso.

• Addestra NLU

  Utilizza questo pulsante per addestrare manualmente il flusso.

Impostazioni IVR e Voce

Sono disponibili le seguenti impostazioni IVR e vocali:

• Sintesi vocale

  • Selezione voce

    Puoi selezionare la lingua e la voce utilizzate per la sintesi vocale.

    Puoi attivare l'opzione Voce personalizzata per il tuo agente selezionando l'opzione relativa alla voce personalizzata dalla casella personale per la selezione della voce e specificare il nome della voce personalizzata nel campo corrispondente. Il nome della voce personalizzata deve avere il seguente pattern: projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME.

    • Se utilizzi un gateway di telefonia, assicurati che all'account di servizio dell'agente di servizio Dialogflow [e-mail] sia concesso "AutoML Predictor" nel tuo progetto vocale personalizzato.
    • Per le chiamate API standard, assicurati che all'account di servizio utilizzato per chiamare Dialogflow sia stato concesso il ruolo "AutoML Predictor" (Predittore AutoML) nel tuo progetto vocale personalizzato.

• Speech-to-Text

  • Attiva l'adattamento vocale automatico

    Vedi Adattamento vocale automatico.

  • Impostazioni vocali avanzate

    Nota: le impostazioni vocali avanzate sono supportate solo dalle integrazioni di telefonia.

    Questa sezione fornisce impostazioni avanzate aggiuntive per le funzionalità vocali. Puoi attivare e disattivare queste impostazioni avanzate.

    Queste impostazioni sono disponibili nelle impostazioni dell'agente (si applica all'intero agente), nelle impostazioni del flusso (si applica all'intero flusso e sostituisce le impostazioni dell'agente), nelle impostazioni della pagina (si applica alla pagina e sostituisce le impostazioni del flusso e dell'agente) e nelle impostazioni di fulfillment (si applica alle impostazioni di fulfillment e override di pagina, flusso e agente). A ogni livello è disponibile un sottoinsieme di queste impostazioni, a seconda della pertinenza dell'impostazione per il livello.

    Le impostazioni aggiornate a livello di agente non si propagano a livello di flusso, pagina e fulfillment quando è selezionata l'opzione Personalizza in questi livelli inferiori. Se l'opzione Personalizza comprende più impostazioni e vuoi aggiornarne solo alcune, potresti dover aggiornare anche altre se vuoi che corrispondano a quelle a livello di agente.

    • Selezione del modello (Speech-to-Text)

      Imposta il modello vocale utilizzato per il riconoscimento vocale. La scelta è specifica per la lingua, quindi puoi selezionare modelli diversi per lingue diverse. Puoi anche selezionare Esegui l'override del modello vocale a livello di richiesta per utilizzare il modello selezionato anche se una chiamata API di runtime specifica un modello diverso.

      Per il gateway telefonico Dialogflow CX, consulta le limitazioni.

      Per maggiori informazioni, consulta Modelli vocali.

    • Sensibilità vocale finale

      controlla la sensibilità per il riconoscimento della fine del parlato nell'input audio dell'utente finale. Il valore va da 0 (bassa sensibilità, meno probabilità di terminare la voce) a 100 (alta sensibilità, più probabilità di terminare la voce).

      Nota: questa impostazione supporta solo il tag en-US language, a meno che non selezioni l'impostazione Abilita la sensibilità vocale per fine della conversazione basata su timeout avanzato.

    • Attiva la sensibilità vocale per la fine della voce in base al timeout avanzato

      Se questa impostazione è attivata, il valore dell'impostazione Fine della sensibilità vocale viene utilizzato come indicatore per stabilire un timeout relativo del silenziamento audio per determinare la fine del parlato.

      Se questa impostazione è disabilitata (impostazione predefinita), il valore dell'impostazione Sensibilità fine della voce viene utilizzato per determinare la fine del parlato da parte del modello ML fornito da Google Cloud Speech-To-Text.

      Sebbene l'impostazione Sensibilità fine della voce supporti solo il tag lingua en-US per impostazione predefinita, l'impostazione Attiva sensibilità alla fine della voce in base a timeout avanzato consente di configurare la sensibilità alla fine della voce per tutte le lingue e tutti i modelli vocali supportati da Dialogflow.

    • Attiva gli endpoint intelligenti

      Se questa impostazione è abilitata, Dialogflow analizzerà l'input parziale dell'utente per determinare la fine del discorso. Ad esempio, se l'utente dice "Mi piacerebbe" e mette in pausa, Dialogflow attenderà che l'utente continui la frase.

      Questa funzionalità è particolarmente utile per la raccolta di parametri numerici, in cui l'utente può pronunciare "1234" e fare una pausa prima di dire "5678". Per applicare questa impostazione a un parametro specifico, devi configurare l'endpoint intelligente nel modulo del parametro.

      Questa opzione è disponibile solo per il tag lingua en-US.

      Questa impostazione è disattivata per impostazione predefinita.

    • Nessun timeout della voce

      La durata in secondi per cui Dialogflow smette di attendere l'input audio dell'utente finale. Il valore predefinito è 5 secondi, il valore massimo è 60 secondi. Per questo timeout, Dialogflow richiama un evento senza input.

    • Accesso

      Quando questa opzione è abilitata, un utente finale può interrompere l'audio della risposta di Dialogflow. All'interruzione, Dialogflow non invia più l'audio ed elaborerà l'input utente finale.

      Se sono presenti più messaggi nella coda dei messaggi e un messaggio è stato messo in coda da un fulfillment associato a una pagina, un flusso o un agente con barge-in abilitato, anche tutti i messaggi seguenti nella coda avranno questo tipo di funzionalità abilitato. In questo caso, l'integrazione interromperà la riproduzione dell'audio per tutti i messaggi in coda con la funzionalità barge-in abilitata.

    • Consenti l'annullamento della riproduzione della risposta parziale

      Se è abilitata la risposta parziale, questa impostazione consente l'annullamento della riproduzione della risposta parziale. Se un messaggio nella coda dei messaggi viene creato da un fulfillment che consente l'annullamento, la riproduzione del messaggio viene annullata se viene aggiunto un altro messaggio alla coda. Questo è utile quando vuoi che la riproduzione di un messaggio iniziale avvii la riproduzione, ma affinché la riproduzione venga annullata se un webhook funzionante genera un altro messaggio prima del completamento della riproduzione del messaggio iniziale.

    • Bucket di esportazione audio

      Se specificati, tutti i dati audio associati a una richiesta verranno salvati nel bucket Cloud Storage:

      Audio salvato	Richieste applicabili
      Input audio utente finale	DetectIntent, StreamingDetectIntent, cinque_analisi_dei_contenuti, StreamingAnalizzaContent
      Audio di sintesi vocale (TTS) sintetizzato per una risposta	AnalizziamoContent, StreamingAnalizzaContent

      Concedi il ruolo Creatore oggetti Storage ai seguenti account di servizio nel tuo progetto:

      • All'account di servizio del formato one-click@df-cx-ALPHANUMERIC_VALUE-ALPHANUMERIC_VALUE.iam.gserviceaccount.com se utilizzi un'integrazione di telefonia integrata di un partner.

      • All'account di servizio del formato [e-mail] se utilizzi l'integrazione Dialogflow CX Phone Gateway. Per trovare questo account di servizio in IAM, seleziona l'opzione Includi concessioni di ruoli fornite da Google.

    • DTMF: consulta DTMF per le integrazioni di telefonia.

Multimodale

Vedi Chiamata complementare.

Impostazioni di condivisione

Vedi Controllo dell'accesso.

Impostazioni lingua

Aggiungi ulteriore supporto linguistico all'agente. Per l'elenco completo delle lingue, consulta la documentazione di riferimento sulle lingue.

Rilevamento automatico della lingua

Quando configuri il rilevamento automatico della lingua, l'agente chat rileverà automaticamente la lingua dell'utente finale e passerà a quella lingua. Per i dettagli, consulta la documentazione sul rilevamento automatico della lingua.

Impostazioni di sicurezza

Vedi Impostazioni di sicurezza.

Impostazioni avanzate

Attualmente, l'unica impostazione avanzata è per l'analisi del sentiment.

Esportare e ripristinare un agente

Nota: i tipi di agenti Dialogflow ES e Dialogflow CX non sono compatibili. Non puoi ripristinare un agente non compatibile.

Puoi esportare un agente in un file e ripristinare un agente con quel file.

Un'esportazione dell'agente include tutti i dati dell'agente, ad eccezione di quanto segue:

• Versioni di flusso: solo i flussi di bozza vengono esportati in un file.
• Ambienti: gli ambienti personalizzati non vengono esportati su file.

Il ripristino di un agente sovrascrive tutti i dati dell'agente di destinazione (incluse tutte le versioni del flusso), ad eccezione di quanto segue:

• Ambienti: tutti gli ambienti personalizzati rimangono invariati nell'agente di destinazione. Le versioni di flusso a cui fanno riferimento gli ambienti personalizzati nell'agente di destinazione continueranno a esistere, purché esistano gli ambienti associati. Tuttavia, queste versioni del flusso inattivo non sono elencate o possono essere selezionate per l'agente.
• App Vertex AI Conversation: l'associazione a un'app Vertex AI Conversation rimane invariata nell'agente di destinazione. (In altre parole, il valore di engine in GenAppBuilderSettings). Ciò significa che gli agenti del datastore possono essere ripristinati solo in altri agenti del datastore esistenti, poiché anche l'agente risultante deve avere un'associazione a Vertex AI Conversation App.

• Vertex AI Conversation Data Store: tutti i riferimenti ai datastore verranno sovrascritti nell'agente di destinazione in base alle seguenti regole:

  • Se l'agente di destinazione non è associato a un'app, non è possibile ripristinare un agente contenente riferimenti al datastore. Se provi a farlo, verrà visualizzato un messaggio di errore. Per risolvere il problema, puoi creare un nuovo agente del datastore da zero. In alternativa, puoi trasformare l'agente esistente in un agente del datastore aggiungendo un gestore dello stato di datastore. In questo caso ci sarà una procedura guidata per aggiungere un'app associata al tuo agente.
  • Se l'agente di destinazione è associato a un'app, tutti i riferimenti del datastore verranno aggiornati al momento del ripristino: l'ID e la località del progetto Google Cloud verranno aggiornati in modo che corrispondano all'app dell'agente di destinazione. L'ID raccolta e l'ID datastore rimarranno invariati. Ciò significa che devi aggiungere datastore per tutti gli ID con tipi corrispondenti nell'app dell'agente di destinazione prima dell'operazione di ripristino.

  Esempio: se l'agente di origine fa riferimento a un datastore denominato projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 e l'app dell'agente di destinazione è denominata projects/321/locations/us-east1/collections/default_collections/engines/app123, il riferimento al datastore risultante nell'agente di destinazione diventerà: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Nota: nell'API e nei contenuti dei dati esportati, un'app di conversazione Vertex AI è denominata GenAppBuilder Engine. Ad esempio, in un pacchetto JSON esportato puoi trovare il nome del motore nel file agent.json nella chiave genAppBuilderSettings.engine.

Durante l'esportazione, puoi selezionare il formato di file di esportazione. Se utilizzi il controllo delle versioni del controllo del codice sorgente per i dati dell'agente, devi esportare nel formato JSON. Quando ripristini un agente, Dialogflow determina automaticamente il formato file.

Per esportare o ripristinare un agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il progetto Google Cloud per l'agente.
3. Fai clic sul menu opzioni di un agente nell'elenco.
4. Fai clic sul pulsante Esporta o Ripristina.
5. Segui le istruzioni per completare l'operazione.

Nota: per ripristinare un agente del datastore, assicurati che l'agente di destinazione sia stato creato come agente del datastore.

API

Visualizza i metodi export e restore per il tipo Agent. Vai al riferimento dell'API Agent

Seleziona un protocollo e una versione per il riferimento dell'agente:

Protocollo	V3	V3beta1
REST	Risorsa agente	Risorsa agente
RPC	Interfaccia agente	Interfaccia agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Go	AgentsClient	Non disponibile
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Non disponibile	Non disponibile
Python	AgentsClient	AgentsClient
Ruby	Non disponibile	Non disponibile

Close

Se le dimensioni dell'agente superano il limite massimo, utilizza l'opzione Cloud Storage per l'esportazione e il ripristino degli agenti.

Se utilizzi GitHub, consulta anche la guida per l'esportazione/il ripristino di GitHub.

Elimina un agente

Attenzione: l'eliminazione di un agente non può essere annullata. Esporta l'agente per conservare un backup, se necessario.

Per eliminare un agente, devi avere un ruolo che offra accesso completo o in modifica. Per ulteriori informazioni, consulta la guida al controllo dell'accesso.

Per eliminare un agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il progetto Google Cloud per l'agente.
3. Fai clic sul menu opzioni di un agente nell'elenco.
4. Fai clic sul pulsante Elimina .
5. Conferma l'eliminazione nella finestra di dialogo.

API

Visualizza il metodo delete per il tipo Agent. Vai al riferimento dell'API Agent

Seleziona un protocollo e una versione per il riferimento dell'agente:

Protocollo	V3	V3beta1
REST	Risorsa agente	Risorsa agente
RPC	Interfaccia agente	Interfaccia agente
C++	AgentsClient	Non disponibile
C#	AgentsClient	Non disponibile
Go	AgentsClient	Non disponibile
Java	AgentsClient	AgentsClient
Node.js	AgentsClient	AgentsClient
PHP	Non disponibile	Non disponibile
Python	AgentsClient	AgentsClient
Ruby	Non disponibile	Non disponibile

Close

Se elimini il progetto, tutti gli agenti Dialogflow CX e i dati associati al progetto vengono eliminati immediatamente.