Agenti

Un agente Dialogflow CX è un agente virtuale che gestisce le conversazioni in parallelo con i tuoi utenti finali. È un modulo di comprensione del linguaggio naturale che comprende tutte le sfumature del linguaggio umano. Dialogflow traduce il testo o l'audio degli utenti finali durante una conversazione in dati strutturati comprensibili per le tue app e i tuoi servizi. Progetta e crea un agente Dialogflow per gestire i tipi di conversazioni richieste per il tuo sistema.

Un agente Dialogflow è simile a un agente umano di call center. Devi addestrare entrambi i metodi per gestire gli scenari di conversazione previsti e non deve essere eccessivamente esplicita.

Crea un agente

Nota: puoi creare più agenti CX per un singolo 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à che preferisci. Fai clic sul pulsante Modifica se vuoi modificare le impostazioni di geolocalizzazione avanzate.
   3. Seleziona il fuso orario che preferisci.
   4. Seleziona la lingua predefinita per l'agente. Non puoi modificare la lingua predefinita per un agente dopo averlo creato.
6. Fai clic su Salva.

API

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

Per creare un agente, vedi 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 dell'agente	Interfaccia dell'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.

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 e così via come descritto in altre guide.

API

Consulta le guide per i dati che vuoi aggiornare.

I seguenti dati sono associati agli agenti:

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

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

Impostazioni dell'agente

Per accedere alle impostazioni dell'agente:

Console

1. Apri la console Dialogflow CX.
2. Scegli il progetto Google Cloud.
3. Seleziona l'agente.
4. Fai clic su Agent Settings (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 dell'agente	Interfaccia dell'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 degli agenti.

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 per l'agente.

• Lingua predefinita

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

  1. Esporta l'agente in formato JSON.
  2. Decomprimi il file scaricato.
  3. Individua 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 agente diverso dal passaggio 1.
  6. Aggiorna le frasi di addestramento specifiche per la lingua e i valori delle entità, 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, BigQuery Export, Analisi e il miglioramento dei modelli NLU richiedono l'attivazione di questa impostazione, poiché si basano sui log del traffico.

• Esportazione in BigQuery

  • Abilitare l'esportazione in BigQuery

    Indica se l'esportazione BigQuery è abilitata.

  • Set di dati BigQuery

    Il nome del set di dati BigQuery.

  • Tabella BigQuery

    Il nome della tabella BigQuery.

• Suggerimenti relativi all'intenzione

  Puoi attivare i suggerimenti di intent.

• Modello di payload personalizzato

  In questa sezione puoi creare descrizioni e payload per 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 dati strutturati. Dialogflow apprende dalle frasi di addestramento che fornisci e dai modelli linguistici integrati in Dialogflow. In base a questi dati, crea un modello per prendere decisioni su quale intent deve essere abbinato a uinput utentete finale. Puoi applicare impostazioni di ML univoche a ciascun flusso di un agente e il modello creato da Dialogflow è univoco per ogni flusso.

Sono disponibili le seguenti impostazioni di ML a livello di agente:

• Consenti all'ML di correggere l'ortografia

  Se questa funzionalità è attivata e l'input utente dell'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 digita "voglio un applle", 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 entità 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 a quello originale.

  Avvisi e best practice:

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

Sono disponibili le seguenti impostazioni ML specifiche per il flusso:

• Tipo NLU

  Le opzioni possibili sono:

  • Advanced NLU (opzione predefinita): tecnologia NLU avanzata. Questo tipo di NLU funziona meglio di quello 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 flussi di grandi dimensioni, ciò potrebbe causare ritardi nell'interfaccia utente della console, perciò dovresti disabilitare questa impostazione e addestrare manualmente in base alle esigenze per i flussi di grandi dimensioni.

• Soglia di classificazione

  Per filtrare i risultati falsi positivi e continuare a ottenere vari input in linguaggio naturale corrispondenti per il tuo agente, puoi ottimizzare la soglia di classificazione del machine learning. Questa impostazione controlla il livello di confidenza minimo del rilevamento dell'intent necessario per una corrispondenza dell'intent.

  Se il punteggio di confidenza per una corrispondenza di intent è inferiore al valore della soglia, viene 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 dopo l'ultimo aggiornamento ai dati del flusso.

• Addestra NLU

  Utilizza questo pulsante per addestrare manualmente il flusso.

Impostazioni dell'AI generativa

Sono disponibili le seguenti impostazioni di AI generativa:

• Generale

  • Frasi escluse

    Elenco di frasi vietate per l'AI generativa. Se nel prompt o nella risposta generata viene visualizzata una frase vietata, la generazione non andrà a buon fine.

• Agente generativo

  Nota: questa impostazione ha accesso limitato.

  • Selezione del modello generativo

    Seleziona il modello utilizzato dalle caratteristiche generative. Per maggiori informazioni, vedi versioni del modello.

• Fallback generativo

  • Configurazione prompt di testo

    Consulta Generato di riserva: definisci il tuo prompt.

• Datastore

  Consulta Impostazioni dell'agente del datastore.

Impostazioni Voce e IVR

Sono disponibili le seguenti impostazioni vocale e IVR:

• Sintesi vocale

  • Selezione voce

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

    Puoi abilitare Voce personalizzata per l'agente selezionando l'opzione Voce personalizzata dalla casella personale di selezione della voce e specificare il nome della voce personalizzata nel campo corrispondente. Il nome della voce personalizzata deve seguire il seguente pattern: projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME.

    • Se utilizzi un gateway di telefonia, assicurati che l'account di servizio dell'agente di servizio Dialogflow [e-mail] sia concesso con "AutoML Predictor" nel tuo progetto vocale personalizzato.
    • Per le normali chiamate API, assicurati che all'account di servizio utilizzato per chiamare Dialogflow sia concesso il ruolo "AutoML Predictor" 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 applicano all'intero agente), impostazioni del flusso (si applicano all'intero flusso e sostituisce le impostazioni dell'agente), impostazioni della pagina (si applica alla pagina e sostituisce le impostazioni di flusso e agente) e impostazioni di evasione (si applica alle impostazioni di evasione e override di pagina, flusso e agente). È disponibile un sottoinsieme di queste impostazioni per ogni livello, a seconda della pertinenza dell'impostazione.

    Le impostazioni a livello di agente aggiornate non si propagano al livello di flusso, pagina e completamento quando l'opzione Personalizza è selezionata sui livelli inferiori. Se l'opzione Personalizza include più impostazioni e vuoi aggiornarne solo alcune, potresti dover aggiornare anche altre impostazioni se vuoi che siano uguali a quelle a livello di agente.

    • Selezione del modello (Speech-to-Text)

      Imposta il modello vocale utilizzato per il riconoscimento vocale. Questa impostazione è specifica per la lingua, quindi puoi selezionare modelli diversi per lingue diverse. Puoi anche selezionare Ignora modello vocale a livello di richiesta, che consente l'utilizzo del modello selezionato anche se una chiamata API runtime specifica un modello diverso.

      Per il gateway telefonico Dialogflow CX, consulta limitazioni.

      Per ulteriori informazioni, vedi Modelli vocali.

    • Sensibilità alla fine della voce

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

      Nota: questa impostazione supporta solo il tag en-US lingua, a meno che non selezioni l'impostazione Abilita la fine della sensibilità vocale avanzata basata sul timeout.

    • Attiva la fine della sensibilità vocale avanzata basata sul timeout

      Se questa impostazione è abilitata, il valore dell'impostazione Sensibilità della voce di fine viene utilizzato come indicatore per stabilire un timeout relativo al silenzio dell'audio e determinare la fine della conversazione.

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

      Mentre l'impostazione Sensibilità della sintesi vocale supporta solo il tag lingua en-US per impostazione predefinita, l'impostazione Abilita la sensibilità di fine della sintesi vocale basata sul timeout avanzato consente di configurare la fine della sensibilità della voce per tutte le lingue e i modelli vocali supportati da Dialogflow.

    • Abilita l'endpoint intelligente

      Se questa impostazione è abilitata, Dialogflow analizzerà una parte dell'input utente per determinare la fine del parlato. Ad esempio, se l'utente dice "Vorrei" e mette in pausa, Dialogflow attende che l'utente continui la frase.

      Ciò è particolarmente utile per la raccolta di parametri numerici, dove l'utente potrebbe dire "1234" e fermarsi prima di dire "5678". Per applicare questa impostazione a un parametro specifico, devi configurare l'endpoint intelligente nel formato 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 in cui Dialogflow smetterà di attendere l'input audio dell'utente finale. Il valore predefinito è 5 secondi e il valore massimo è 60 secondi. Per questo timeout, Dialogflow richiama un evento senza input.

    • Barge-in

      Se questa opzione è abilitata, un utente finale può interrompere l'audio della risposta di Dialogflow. Dopo l'interruzione, Dialogflow interrompe l'invio dell'audio ed elabora il successivo input utente finale.

      Se sono presenti più messaggi nella coda di 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 l'opzione barge-in abilitato. In questo caso, l'integrazione interromperà la riproduzione dell'audio per tutti i messaggi in coda con barge-in abilitato.

    • Consenti l'annullamento della riproduzione delle risposte parziali

      Quando è abilitata la risposta parziale, questa impostazione consente di annullare la riproduzione di una risposta parziale. Se un messaggio in coda di messaggi viene creato da un completamento che consente l'annullamento, la riproduzione del messaggio viene annullata se un altro messaggio viene aggiunto alla coda. Questo è utile quando vuoi che un messaggio iniziale avvii la riproduzione, ma che la riproduzione venga annullata se un webhook funzionante produce un altro messaggio prima del completamento della riproduzione del messaggio iniziale.

    • Bucket Esportazione audio

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

      Audio salvato	Richieste applicabili
      Input audio dell'utente finale	DetectIntent, StreamingDetectIntent, AnalyzeContent, StreamingAnalyzeContent
      Audio sintetizzato per la sintesi vocale (TTS) per una risposta	AnalyzeContent, StreamingAnalyzeContent

      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 della telefonia integrata dei partner.

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

    • DTMF: vedi DTMF per le integrazioni di telefonia.

Multimodale

Vedi Chiamata complementare.

Impostazioni di condivisione

Vedi Controllo dell'accesso.

Impostazioni della lingua

Aggiungi un'ulteriore assistenza linguistica per il tuo agente. Per l'elenco completo delle lingue, consulta il riferimento linguistico.

Rilevamento automatico della lingua

Quando configuri il rilevamento automatico della lingua, l'agente chat rileva automaticamente la lingua dell'utente finale e passa a quella lingua. Per i dettagli, consulta la documentazione relativa al rilevamento automatico della lingua.

Impostazioni di sicurezza

Vedi Impostazioni di sicurezza.

Impostazioni avanzate

Attualmente, l'unica impostazione avanzata riguarda l'analisi del sentiment.

Esporta e ripristina 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 flusso: vengono esportati solo i flussi in bozza.
• Ambienti: gli ambienti personalizzati non vengono esportati nel file.

Un ripristino dell'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 del flusso a cui fanno riferimento gli ambienti personalizzati nell'agente di destinazione continueranno a esistere, finché esistono gli ambienti associati. Tuttavia, queste versioni di flusso inattive non sono elencate o non sono selezionabili per l'agente.
• App Vertex AI Agents: l'associazione a un'app Vertex AI Agents 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 esistenti del datastore, poiché anche l'agente risultante deve avere un'associazione a un'app Vertex AI Agents.

• Data Store di Vertex AI Agents: 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 con riferimenti al datastore. Se provi a farlo, visualizzerai un messaggio di errore. Per risolvere il problema, puoi creare un nuovo agente del datastore da zero. In alternativa, puoi convertire l'agente esistente in un agente del datastore aggiungendovi un gestore dello stato del datastore. In questo caso, ti guideremo attraverso l'aggiunta di 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 progetto e la località di 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 del 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 Vertex AI Agents è chiamata GenAppBuilder Engine. Ad esempio, in un pacchetto JSON esportato puoi trovare il nome del motore nel file agent.json sotto la chiave genAppBuilderSettings.engine.

Durante l'esportazione, puoi selezionare il formato file di esportazione. Se utilizzi il controllo delle versioni del controllo del codice sorgente per i dati dell'agente, devi eseguire l'esportazione in 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 delle opzioni per 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 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 dell'agente	Interfaccia dell'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 dell'agente.

Se utilizzi GitHub, consulta anche la guida all'esportazione/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 fornisca accesso completo o accesso 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 delle opzioni per 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 dell'agente	Interfaccia dell'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 e i dati di Dialogflow CX associati al progetto vengono eliminati immediatamente.