Agenti

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

Un agente Dialogflow è simile a un agente umano di call center. Devi addestrare entrambi a gestire gli scenari di conversazione previsti, e non è necessario che sia eccessivamente esplicita.

Crea un agente

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 una agente del datastore o 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 il tuo preferito. location. Fai clic sul pulsante Modifica se vuoi cambiare le impostazioni impostazioni di geolocalizzazione.
    3. Seleziona il fuso orario che preferisci.
    4. Seleziona la lingua predefinita per l'agente. Non puoi cambiare la lingua predefinita per un agente una volta creato.
  6. Fai clic su Salva.

API

Se non lo hai già configurato impostazioni di geolocalizzazione per il tuo progetto, devi configurare queste impostazioni con la console prima di creare 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.

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
Vai AgentsClient Non disponibile
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP Non disponibile Non disponibile
Python AgentsClient AgentsClient
Ruby Non disponibile Non disponibile

Dati agente

Gli agenti Dialogflow fungono da container di primo livello impostazioni e dati per gli 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 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:

Per ulteriori informazioni su come i dati vengono applicati a diversi livelli, vedi 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.

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
Vai AgentsClient Non disponibile
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP Non disponibile Non disponibile
Python AgentsClient AgentsClient
Ruby Non disponibile Non disponibile

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 nel Formato JSON.
    2. Decomprimi il file scaricato.
    3. Individua il file agent.json.
    4. Aggiorna defaultLanguageCode e supportedLanguageCodes campi con i valori desiderati.
    5. Ripristina lo stesso agente o uno diverso nel 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 se è abilitato per l'agente.

    • Attivare il logging delle interazioni

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

    • Attivare l'oscuramento dell'input utente finale basato sul consenso

      Se questa impostazione è abilitata, puoi utilizzare un parametro di sessione speciale per controllare se l'input e i parametri dell'utente finale vengono oscurati dalla cronologia delle conversazioni e da Cloud Logging. Per impostazione predefinita, il parametro di sessione è true. Se questa impostazione viene disattivata, non viene oscurato.

      Il consenso degli utenti viene raccolto utilizzando un parametro di sessione booleano: $session.params.conversation-redaction. Se questa impostazione è attivata e il parametro sessione è impostato su false, non si verifica alcun oscuramento (vengono ancora applicate altre strategie di oscuramento). Se questa impostazione è attivata e il parametro della sessione è impostato su true, si verifica l'oscuramento.

      Un esempio di flusso di richiesta di consenso potrebbe essere: chiedere innanzitutto all'utente se vuole mantenere l'input utente finale e abbinare la risposta a due intent, uno dei quali è "sì intenzione" e l'altro è "senza intent". Poi, imposta il parametro di sessione su false (nessun oscuramento) nei valori preimpostati dei parametri dell'opzione "yes intent" route in fulfillment e a true (l'oscuramento si verifica) nel valore preimpostato di "nessun intent" percorso.

  • Esportazione in BigQuery

    • Abilitare l'esportazione in BigQuery

      Indica se Esportazione in BigQuery sia abilitato.

    • Set di dati BigQuery

      Il nome del set di dati BigQuery.

    • Tabella BigQuery

      Il nome della tabella BigQuery.

  • Suggerimenti relativi all'intenzione

    Puoi attivare suggerimenti di intent.

  • Modello di payload personalizzato

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

Impostazioni ML

Dialogflow utilizza algoritmi di machine learning (ML) per comprendere gli input dell'utente finale, associarli agli intent, ed estrarre dati strutturati. Dialogflow impara frasi di addestramento da te forniti e i modelli linguistici integrati in Dialogflow. In base a questi dati, crea un modello per prendere decisioni su quale intent dovrebbe essere abbinato a un input utente finale. Puoi applicare impostazioni 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 impostazione è attiva 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 digita "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 entità personalizzate.

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

    Avvisi e best practice:

    • La correzione ortografica non può correggere il riconoscimento vocale automatico (ASR) di conseguenza, 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 alla esempi di parole chiave escluse.
    • 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 NLU

    Le opzioni possibili sono:

  • Addestramento automatico

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

  • Soglia di classificazione

    Per filtrare i risultati falsi positivi e continuare a variare l'attività corrispondenti input in linguaggio naturale per il tuo agente, puoi ottimizzare la soglia di classificazione del machine learning. Questa impostazione controlla l'affidabilità minima del rilevamento dell'intento necessaria per un corrispondenza dell'intenzione.

    Se il punteggio di confidenza per un'intenzione corrisponde è inferiore al valore di soglia, poi a evento senza corrispondenza verrà richiamato.

  • Stato addestramento

    Indica se il flusso è stato addestrato dall'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

    • Selezione del modello generativo

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

  • Fallback generativo

  • 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 attivare la Voce personalizzata per l'agente selezionando l'opzione della voce personalizzata dalla voce di selezione e specificare il nome della voce personalizzata nella casella . 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 service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com è concesso con "AutoML Predictor" nel tuo progetto Voice personalizzato.
      • Per le normali chiamate API, assicurati che l'account di servizio utilizzato per chiamare Dialogflow sia concesso con "AutoML Predictor" nel tuo progetto Voice personalizzato.
  • Speech-to-Text

    • Attiva l'adattamento vocale automatico

      Vedi Adattamento vocale automatico.

    • Impostazioni vocali avanzate

      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 di flusso (si applica 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 degli ordini (si applica al completamento e sostituisce le impostazioni di pagina, flusso e agente). È disponibile un sottoinsieme di queste impostazioni per ogni livello, a seconda della pertinenza dell'impostazione per il livello.

      Le impostazioni a livello di agente aggiornate non si propagano a flusso, pagina e di completamento quando è selezionata l'opzione Personalizza in queste diversi. Se l'opzione Personalizza comprende più impostazioni e vuoi aggiornarne solo alcuni, potresti dover aggiornare anche altre impostazioni se vuoi che siano uguali alle impostazioni 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, in modo da poter selezionare modelli diversi per lingue diverse. Puoi anche controllare Override del modello vocale a livello di richiesta, che determina 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 la fine della sintesi vocale nell'input audio dell'utente finale. I valori vanno da 0 (sensibilità bassa, meno probabilità di terminare la voce) a 100 (sensibilità elevata, maggiore probabilità di terminare la conversazione).

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

        Se questa impostazione è attiva, Il valore dell'impostazione Sensibilità vocale di fine. viene utilizzato come indicatore per stabilire un timeout relativo del silenzio audio per determinare la fine del discorso.

        Se questa impostazione è disattivata (impostazione predefinita), Il valore dell'impostazione Sensibilità vocale di fine. è utilizzato per determinare la fine del discorso dal modello ML fornito Google Cloud Speech-to-Text.

        L'impostazione Sensibilità vocale di fine supporta solo il tag en-US language per impostazione predefinita, l'impostazione Attiva la fine della sensibilità della voce basata sul timeout avanzato consente di configurare la sensibilità di fine 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 degli utenti input per determinare la fine del discorso. Ad esempio, se l'utente dice "Vorrei" e mette in pausa, Dialogflow attende l'utente per continuare la frase.

        Ciò è particolarmente utile per la raccolta di parametri numerici, dove l'utente potrebbe dire "1234" e fermati 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 per i quali Dialogflow smetterà di attendere l'input audio dell'utente finale. Il valore predefinito è 5 secondi, mentre il valore massimo è 60 secondi. Per questo timeout, Dialogflow richiama una evento senza input.

      • Barge-in

        Se questa opzione è abilitata, un utente finale può interrompere l'audio della risposta di Dialogflow. Quando viene interrotto, Dialogflow interrompe l'invio di audio, ed elaborerà il successivo input utente finale.

        Se ci sono 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 in coda avranno il 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 risposta parziale sia abilitato, questa impostazione consente di annullare la riproduzione di una risposta parziale. Se un messaggio nella sezione coda di messaggi viene creato da un fulfillment che consente l'annullamento, la riproduzione del messaggio viene annullata se un altro messaggio viene aggiunto alla coda. È utile quando vuoi un messaggio iniziale per avviare la riproduzione, ma affinché 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, i dati audio associati a una richiesta verranno salvate 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 al seguente 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 del partner.

        • All'account di servizio del formato service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com se utilizzi Dialogflow CX Phone Gateway e integrazione. Per trovare questo account di servizio in IAM, controlla 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, vedi lingua di riferimento.

Rilevamento automatico della lingua

Quando configuri rilevamento automatico della lingua, l'agente della chat rileverà automaticamente la lingua dell'utente finale e passerà quella lingua. Consulta le documentazione relativa al rilevamento automatico della lingua per maggiori dettagli.

Impostazioni di sicurezza

Vedi Impostazioni di sicurezza.

Impostazioni avanzate

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

Esporta e ripristina un agente

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 Flow: Nel file vengono esportati solo i flussi in bozza.
  • Ambienti: Gli ambienti personalizzati non vengono esportati nei 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. 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 flussi inattivi non sono elencate o selezionabili le versioni del flusso per l'agente.
  • App Vertex AI Agents: L'associazione a un'app Vertex AI Agents rimane invariata nell'agente target. (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, perché anche l'agente risultante deve per avere un'associazione a un'app Vertex AI Agents.
  • Datastore di Vertex AI Agents: Tutti i riferimenti ai datastore verranno sovrascritti nell'agente di destinazione in base alle seguenti regole:

    • Se l'agente target non è associato a un'app, non è possibile per ripristinare un agente con riferimenti al datastore. Risultati in prova in un messaggio di errore. Per risolvere il problema, puoi crea un nuovo agente del datastore da zero. (In alternativa, può trasformare l'agente esistente in un agente del datastore aggiungendo un datastore gestore dello stato che le sono assegnati. In questo caso ti guideremo attraverso l'aggiunta di un'app associata a il tuo agente.)
    • Se l'agente target è associato a un'app, allora tutto il datastore i riferimenti verranno aggiornati al momento del ripristino: il relativo ID progetto Google Cloud e verrà aggiornata in modo da corrispondere all'app dell'agente target. La l'ID raccolta e l'ID datastore rimarranno invariati. Ciò significa che Devi aggiungere datastore per tutti gli ID con tipi di corrispondenza 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

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, dovresti 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 sull'opzione per un agente nell'elenco.
  4. Fai clic sul pulsante Esporta o Ripristina.
  5. Segui le istruzioni per completare l'operazione.

API

Visualizza i metodi export e restore per il tipo 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
Vai AgentsClient Non disponibile
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP Non disponibile Non disponibile
Python AgentsClient AgentsClient
Ruby Non disponibile Non disponibile

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

Se usi GitHub, consulta anche Guida all'esportazione/ripristino di GitHub.

Elimina un agente

Per eliminare un agente, devi avere un ruolo che fornisca accesso completo o accesso in modifica. Consulta le guida al controllo dell'accesso per ulteriori informazioni.

Per eliminare un agente:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il progetto Google Cloud per l'agente.
  3. Fai clic sull'opzione 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.

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
Vai AgentsClient Non disponibile
Java AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP Non disponibile Non disponibile
Python AgentsClient AgentsClient
Ruby Non disponibile Non disponibile

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