Impostazioni dell'agente

Gli agenti hanno molte impostazioni che influiscono sul comportamento. Ogni console offre impostazioni diverse.

Impostazioni dell'agente della console Dialogflow CX

Per accedere alle impostazioni dell'agente:

Console

  1. Apri la console di 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

Consulta i metodi get e patch/update per il tipo Agent.

Seleziona un protocollo e una versione per il riferimento all'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 le seguenti operazioni:

    1. Esporta l'agente in formato JSON.
    2. Decomprimi il file scaricato.
    3. Trova il file agent.json.
    4. Aggiorna defaultLanguageCode e supportedLanguageCodes campi con i valori desiderati.
    5. Ripristina lo stesso agente o un agente 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. Un agente bloccato non può essere modificato.

  • Impostazioni di logging

    • Abilita Cloud Logging

      Indica se Cloud Logging è 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 è disattivata, non viene applicata alcuna oscuratura.

      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". Imposta quindi il parametro sessione su false (nessuna oscurazione) nei valori preimpostati dei parametri del percorso "intent yes" in Esecuzione e su true (si verifica l'oscuramento) nel valore preimpostato del parametro del percorso "intent no".

  • BigQuery Export

    • 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 per le intenzioni

    Puoi attivare suggerimenti di intent.

  • Modello di payload personalizzato

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

Impostazioni ML

Gli agenti conversazionali (Dialogflow CX) utilizzano algoritmi di machine learning (ML) per comprendere gli input dell'utente finale, associarli agli intent, ed estrarre dati strutturati. Gli agenti conversazionali (Dialogflow CX) imparano frasi di addestramento forniti e i modelli linguistici integrati negli agenti conversazionali (Dialogflow CX). In base a questi dati, viene creato un modello per prendere decisioni su quale intent deve essere associato all'input di un utente finale. Puoi applicare impostazioni di ML univoche per ogni flusso di un agente e il modello creato dagli agenti conversazionali (Dialogflow CX) è 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 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 entità di sistema e personalizzate.

    La correzione ortografica è disponibile in inglese, francese, tedesco, spagnolo e Italiano. È disponibile in tutte le regioni degli agenti conversazionali (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 gli 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 è definito utilizzando un gergo specifico del dominio, le correzioni potrebbero non essere auspicabili.

Sono disponibili le seguenti impostazioni ML specifiche per il flusso:

  • Tipo NLU

    Le opzioni possibili sono:

  • Autotreno

    Se attivata, la formazione del flusso viene eseguita ogni volta che viene aggiornato con la console. Per i flussi di grandi dimensioni, questo potrebbe causare ritardi nell'interfaccia utente della console, pertanto ti consigliamo di disattivare questa impostazione e di addestrare manualmente in base alle esigenze per i flussi di grandi dimensioni.

  • Soglia di classificazione

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

    Se il punteggio di confidenza per una corrispondenza dell'intento è inferiore al valore della soglia, verrà invocato un evento di mancata corrispondenza.

    Puoi impostare un valore di soglia di classificazione separato per ogni flusso lingua attivata per l'agente. per adattarsi a lingue diverse con un rendimento migliore con diverse soglie di classificazione. Per ulteriori informazioni sulla creazione di un agente multilingue, consulta le documentazione relativa agli agenti multilingue.

  • 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 di IA generativa

Sono disponibili le seguenti impostazioni di AI generativa:

  • Generale

    • Frasi vietate

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

    • Filtri di sicurezza

      Configura i livelli di sensibilità dei filtri di sicurezza in base alle diverse categorie di AI responsabile (RAI). I contenuti verranno valutati in base alle seguenti quattro categorie:

      Categoria Descrizione
      Incitamento all'odio Commenti negativi o dannosi che hanno come target l'identità e/o attributi protetti.
      Contenuti pericolosi Promuovono o consentono l'accesso a beni, servizi e attività dannosi
      Contenuti sessualmente espliciti Riferimenti ad atti sessuali o ad altri contenuti osceni
      Molestie Commenti dannosi, intimidatori, prepotenti o illeciti rivolti a un altro individuo

      I contenuti vengono bloccati in base alla probabilità di essere dannosi. Il livello di sensibilità può essere personalizzato scegliendo una delle opzioni Blocca pochi, Blocca alcuni e Blocca più per ogni categoria. Puoi anche accedere all'opzione limitata Non bloccare, che disattiva i controlli RAI per la categoria dopo aver inviato una richiesta di conferma del rischio per il tuo progetto e aver ricevuto l'approvazione.

      Per ulteriori informazioni, consulta la sezione Configurare gli attributi di sicurezza.

    • Richiedi sicurezza

      Puoi controllare l'impostazione Attiva controllo di sicurezza rapido per attivare i controlli di sicurezza rapidi. Quando l'opzione è attiva, l'agente tenterà di impedire attacchi di prompt injection. Questi attacchi possono essere usati per rivelare parti del prompt dell'agente o di fornire risposte che l'agente non dovrebbe fornire. A questo scopo, invia un prompt LLM aggiuntivo che verifica se la query dell'utente è potenzialmente dannosa.

      Questa impostazione è abilitata per impostazione predefinita per i nuovi agenti. Se l'agente è stato creato prima del rilascio di questa impostazione, l'impostazione non è attivata.

  • Agente generativo

    • Selezione del modello generativo

      Seleziona il modello utilizzato dalle funzionalità di generazione. Per ulteriori informazioni, vedi le versioni del modello.

  • Fallback generativo

  • Datastore

    Consulta Impostazioni dell'agente del datastore.

Impostazioni di IVR e voce

Sono disponibili le seguenti impostazioni di sintesi 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 all'account di servizio Agente di servizio Dialogflow service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com sia stato concesso il ruolo "Predictore AutoML" nel tuo progetto vocale personalizzato.
      • Per le chiamate API regolari, assicurati che all'account di servizio utilizzato per chiamare gli agenti conversazionali (Dialogflow CX) sia stato concesso il ruolo "Predictore AutoML" nel progetto vocale personalizzato.

  • Speech-to-Text

DTMF

Consulta DTMF per le integrazioni di telefonia per ulteriori informazioni.

Multimodale

Vedi Chiamata complementare.

Impostazioni di condivisione

Consulta 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 rileva automaticamente la lingua dell'utente finale e passa quella lingua. Per maggiori dettagli, consulta la documentazione sul rilevamento automatico della lingua.

Impostazioni di sicurezza

Vedi Impostazioni di sicurezza.

Impostazioni avanzate

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

Impostazioni della console di Agent Builder

Questa sezione descrive le impostazioni disponibili per le app agente.

Generale

Per le app agente sono disponibili le seguenti impostazioni generali:

  • Nome visualizzato

    Un nome leggibile per l'app dell'agente.

  • Località

    La regione dell'app dell'agente.

  • Blocco app

    Se è attivata, non sono consentite modifiche all'app agente.

Logging

Per le app agente sono disponibili le seguenti impostazioni di logging:

  • Abilita Cloud Logging

    Se attivata, i log verranno inviati a Cloud Logging.

  • Attivare la cronologia conversazioni

    Se attivata, cronologia delle conversazioni saranno disponibili. Indica se vuoi che Google raccolga e memorizzi le query degli utenti finali oscurate. per migliorare la qualità. Questa impostazione non influisce sull'utilizzo della cronologia delle conversazioni per generare le risposte degli agenti.

  • Abilita BigQuery Export

    Se attivata, viene esportata in BigQuery. È necessario attivare anche l'impostazione Attiva cronologia conversazione.

GenAI

Per le app agente sono disponibili le seguenti impostazioni di AI generativa:

  • Selezione del modello generativo

    Seleziona il modello generativo che gli agenti devono usare per impostazione predefinita.

  • Limite di token di input

    Seleziona il limite di token di input per il modello generativo. Questa è la dimensione massima del token per l'input inviato al modello. A seconda del modello, token può essere compreso tra un carattere e una parola. I limiti di token più piccoli hanno una latenza minore, ma la dimensione di input del modello è limitata. Limiti di token più ampi hanno una latenza maggiore, ma la dimensione di input del modello può essere maggiore.

  • Limite di token di output

    Seleziona il limite di token di output per il modello generativo. Si tratta della dimensione massima del token per l'output ricevuto dal modello. A seconda del modello, token può essere compreso tra un carattere e una parola. I limiti di token più piccoli hanno una latenza minore, ma la dimensione dell'output del modello è limitata. I limiti di token più elevati hanno una latenza maggiore, ma le dimensioni dell'output del modello possono essere maggiori.

  • Temperatura

    La temperatura per un LLM ti consente di controllare il livello di creatività le risposte. Un valore basso fornisce risposte più prevedibili. Un valore alto fornisce risposte più creative o casuali.

  • Frasi escluse

    Elenco di frasi vietate per AI generativa. Se nel prompt o nella risposta generata viene visualizzata una frase vietata, l'agente restituirà una risposta di fallback.

  • Filtri di sicurezza

    Configura i livelli di sensibilità dei filtri di sicurezza in base a diverse categorie di IA responsabile (RAI). I contenuti verranno valutati in base alle seguenti quattro categorie:

    Categoria Descrizione
    Incitamento all'odio Commenti negativi o dannosi che hanno come target l'identità e/o attributi protetti.
    Contenuti pericolosi Promuovono o consentono l'accesso a beni, servizi e attività dannosi
    Contenuti sessualmente espliciti Riferimenti ad atti sessuali o ad altri contenuti osceni
    Molestie Commenti dannosi, intimidatori, prepotenti o illeciti rivolti a un altro individuo

    I contenuti vengono bloccati in base alla probabilità di essere dannosi. Il livello di sensibilità può essere personalizzato scegliendo tra Blocca alcuni (blocca solo le istanze di contenuti dannosi con probabilità elevata), Blocca alcuni (istanze con probabilità media e alta) e Blocca la maggior parte (probabilità bassa, media e alta) per ogni categoria. Puoi anche accedere all'opzione limitata Non bloccare, che disattiva i controlli RAI per la categoria dopo aver inviato una richiesta di conferma del rischio per il tuo progetto e aver ricevuto l'approvazione.

    Per ulteriori informazioni, consulta la sezione Configurare gli attributi di sicurezza.

  • Richiedi sicurezza

    Puoi controllare l'impostazione Attiva il controllo di sicurezza della richiesta per attivare i controlli di sicurezza. Quando l'opzione è attiva, l'agente tenterà di impedire attacchi di prompt injection. Questi attacchi possono essere utilizzati per rivelare parti del prompt dell'agente o per fornire risposte che l'agente non dovrebbe fornire. Ciò viene ottenuto inviando un'altra richiesta LLM che verifica se la query dell'utente è potenzialmente dannosa.

    Questa impostazione è abilitata per impostazione predefinita per i nuovi agenti. Se l'agente è stato creato prima del rilascio di questa impostazione, l'impostazione non è attivata.

Git

Queste impostazioni forniscono un'integrazione Git. Segui le istruzioni per configurare l'integrazione.