Risoluzione dei problemi

Abilita Cloud Logging per l'agente

Attiva Cloud Logging per l'agente. Questo è essenziale per acquisire i dati e diagnosticare i problemi nelle conversazioni reali.

Raccogliere gli ID conversazione

Quando si verifica un comportamento imprevisto, raccogli gli ID conversazione di Dialogflow. Questi ID, che si trovano nella cronologia delle conversazioni, forniscono un modo per tracciare il percorso di esecuzione di una conversazione ed esaminare interazioni specifiche.

La chiamata API riceve l'autorizzazione negata

Problema

Ricevuta risposta PERMISSION_DENIED per la chiamata API.

Soluzione

Assicurati di aver configurato correttamente l'autenticazione e i ruoli (Dialogflow CX, Dialogflow ES). In particolare, assicurati di aver svolto le seguenti operazioni:

• Hai creato un account di servizio e non l'hai eliminato per errore.
• Ha fornito al account di servizio un ruolo che concede l'autorizzazione a chiamare il metodo scelto.
• Hai scaricato il file della chiave privata del account di servizio.
• Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul file della chiave privata.

La chiamata API menziona un progetto sconosciuto

Problema

Ricevuto Dialogflow API has not been used in project 32555940559 errore per la chiamata API.

Soluzione

Assicurati di aver svolto le seguenti operazioni:

• Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS (vedi PERMISSION_DENIED).
• Fornito l'ID progetto corretto alla chiamata API.

La chiamata API restituisce l'errore Credenziali di autenticazione non valide

Problema

Ricevuta Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. risposta per la chiamata API.

Soluzione

Ciò potrebbe essere dovuto alla creazione manuale delle credenziali con la libreria client durante la specifica di una regione non predefinita. Per indicazioni, consulta uno dei seguenti articoli:

• Selezionare una regione con l'API (Dialogflow CX)
• Selezionare una regione con l'API (Dialogflow ES)

Le richieste di risposta alla chiamata API richiedono il passaggio a un host diverso

Problema

Ricevuta risposta Please switch to 'REGION-dialogflow.googleapis.com' to access resources located in 'REGION' per la chiamata API, dove REGION è un ID regione specifico.

Soluzione

Ciò si verifica quando specifichi la regione nella richiesta, ma non l'endpoint. Per indicazioni, consulta uno dei seguenti articoli:

• Selezionare una regione con l'API (Dialogflow CX)
• Selezionare una regione con l'API (Dialogflow ES)

Campi mancanti nella risposta alla chiamata API

Problema

Alcuni campi non sono presenti nella risposta dell'API.

Soluzione

Se prevedi un valore numerico per un campo specifico nella risposta API, il campo potrebbe essere assente dalla risposta se il valore restituito è 0.

Per ulteriori informazioni sul comportamento del valore predefinito (inclusi i valori non numerici), vedi:

• Protocol buffers (Dialogflow CX)
• Protocol buffers (Dialogflow ES)

Impossibile eliminare il progetto a causa di un blocco

Problema

Quando tenti di eliminare un progetto Google Cloud , ricevi una notifica che indica che il progetto non può essere eliminato perché presenta privilegi di ritenzione e uno di questi è correlato a Dialogflow ES.

Soluzione

1. Assicurati di non aver più bisogno dell'agente Dialogflow ES associato al progetto. Se ricevi una notifica che indica che l'agente non esiste, significa che è già stato eliminato.

   Console di Dialogflow ES

   Apri https://dialogflow.cloud.google.com/#/agent/project-id/intents.

   Tieni presente che questo link è diverso da quello nella finestra di dialogo di eliminazione del progetto Google Cloud .

   API Dialogflow

   Utilizza il metodo search del tipo agent.

2. Recupera il nome del blocco.

   gcloud

   Utilizza il comando gcloud alpha resource-manager liens list come descritto nella documentazione Elenco dei vincoli di un progetto.

   Explorer API

   Utilizza il riquadro Prova questa API nella pagina Metodo: liens.list:

   • Compila il campo parent come suggerito nella descrizione del parametro.
   • Fai clic su Esegui.

3. Elimina il blocco.

   gcloud

   Utilizza il comando gcloud alpha resource-manager liens delete LIEN_NAME, come descritto nella documentazione Rimozione di vincoli da un progetto.

   Explorer API

   Utilizza il riquadro Prova questa API nella pagina Metodo: liens.delete:

   • Compila il campo name con il nome del privilegio che hai ottenuto nel passaggio 2.
   • Fai clic su Esegui.

4. Chiudi il progetto.

Il webhook Dialogflow CX non va a buon fine e viene visualizzato l'errore di scadenza del termine

Problema

Un webhook chiamato da Dialogflow CX potrebbe non riuscire con questo messaggio di errore:

Webhook call failed. Error: DEADLINE_EXCEEDED

Ciò può accadere perché la chiamata webhook supera il limite di timeout del webhook. Questi sono i possibili motivi per cui la chiamata webhook supera il limite di timeout:

• Tentativo di attivare un intent inesistente.
• Un problema di avvio a freddo con il backend webhook (ad esempio Cloud Functions).
• Il webhook chiama altri servizi, aumentando il tempo di risposta.
• Nessuna connessione tra l'agente e il backend webhook (ad esempio, bilanciatore del carico configurato in modo errato).
• Criterio dell'organizzazione che impedisce l'esecuzione del traffico in entrata o dei metodi Dialogflow.

Soluzione temporanea

Per impostazione predefinita, un webhook ha un limite di timeout di 5 secondi. Puoi aumentare il limite di timeout del webhook quando crei o modifichi la risorsa webhook, il che darebbe più tempo al webhook per rispondere.

La console non riesce a configurare il progetto

Problema

Ricevuto errore Failed to set up GCP project durante la creazione di un agente con la console.

Soluzione

Potresti non disporre dell'autorizzazione per creare Google Cloud progetti. Verifica se puoi creare un progetto Google Cloud direttamente dalla console. Se non riesci a creare un progetto, segui i consigli forniti nel messaggio di errore.

Riferimento al parametro sessione mostrato nella risposta

Problema

Le risposte restituite da Dialogflow includono i riferimenti ai parametri anziché i valori dei parametri. Ad esempio:
Hello, $session.params.customer_name

I parametri non verranno risolti e il riferimento al parametro verrà mostrato se il parametro non viene trovato nella sessione corrente o se il parametro non viene utilizzato in base al suo tipo.

Soluzione

Questo problema può verificarsi perché il parametro utilizzato non è incluso nella conversazione, contiene un errore di battitura o ha un tipo diverso da quello utilizzato.

La console non riesce a creare l'agente quando l'API non è stata abilitata

Problema

Ricevuto Dialogflow API has not been enabled for the project. Code: FAILED_PRECONDITION errore durante la creazione di un agente con la console.

Soluzione

Segui i passaggi di configurazione per abilitare l'API Dialogflow.

Quando si tenta di accedere alla console dall'account dell'organizzazione, viene visualizzato un errore del servizio

Problema

Ricevuto errore You don't have access to this service durante il tentativo di accedere alla console dall'account dell'organizzazione.

Soluzione

Contatta l'amministratore di sistema della tua organizzazione e verifica che le impostazioni della tua organizzazione consentano l'accesso alla console. In caso contrario, controlla se il tuo account migrato da un'altra organizzazione è stato contrassegnato come con limitazioni da Google. Questo è probabilmente il problema se altri utenti della tua organizzazione possono accedere alla console, ma tu no.

In alternativa, contatta l'assistenza per ricevere aiuto.

Impossibile esportare l'agente in formato JSON a causa del flusso mancante

Problema

L'esportazione dell'agente come byte non elaborati viene completata correttamente, ma l'esportazione dell'agente in formato JSON non riesce e viene visualizzato un messaggio di errore simile a questo:

Flow 'projects/PROJECT_ID/locations/LOCATION_ID/agents/AGENT_ID/flows/FLOW_ID' does not exist
in the agent

Questo problema può essere causato da uno scenario di test che fa riferimento a un flusso eliminato.

Soluzione

Per risolvere il problema, esplora gli scenari di test inutilizzati per verificare se il flusso a cui viene fatto riferimento nel messaggio di errore viene utilizzato in uno scenario di test, poi elimina gli scenari di test confermati.

Connettività del gateway di telefonia

Problema

Quando utilizzi un gateway telefonico, ricevi il segnale di occupato o la chiamata si interrompe.

Soluzione

Esistono quote e limiti per questa funzionalità. Se ricevi un segnale di occupato o la chiamata si interrompe, potresti aver superato la quota.

Errore RESOURCE_EXHAUSTED durante il tentativo di creare un nuovo numero di telefono

Problema

Quando provi a creare un nuovo numero di telefono in Dialogflow CX, Dialogflow ES o Agent Assist, viene restituito un errore RESOURCE_EXHAUSTED.

Soluzione

Questo errore indica che hai superato il limite di numeri di telefono per progetto. Per creare un nuovo numero di telefono, elimina i numeri di telefono inutilizzati associati al tuo progetto finché non rientri nel limite.

Se hai creato numeri di telefono in Dialogflow CX Phone Gateway o Dialogflow ES Phone Gateway, puoi eliminarli nella console. Tieni presente che l'eliminazione dell'agente senza eliminare il numero di telefono non comporta l'eliminazione del numero di telefono associato.

In alternativa, puoi utilizzare l'API seguendo questi passaggi.

Passaggio 1: Identificare tutti i numeri di telefono associati al tuo progetto

Per identificare i numeri di telefono associati al tuo progetto, utilizza il metodo API projects.phoneNumbers/list o projects.locations.phoneNumbers.list per tutte le regioni in cui potresti aver creato numeri di telefono.

• Per la regione global, utilizza il seguente comando:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/phoneNumbers
  

• Per le altre regioni, devi specificare la regione in due posizioni:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/phoneNumbers
  

Passaggio 2: (Facoltativo) Identifica gli agenti associati ai profili conversazionali

Recuperare l'ID agente Dialogflow CX associato al numero di telefono tramite il profilo di conversazione può aiutarti a identificare se l'agente è ancora in uso e se il numero di telefono è ancora necessario. Puoi farlo utilizzando il metodo API projects.conversationProfiles/get. Puoi trovare gli ID dei profili di conversazione nelle risposte ai comandi eseguiti nel passaggio 1.

• Per la regione global, utilizza il seguente comando:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID
  

• Per le altre regioni, specifica la regione in due punti:

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/conversationProfiles/CONVERSATION_PROFILE_ID
  

Puoi trovare l'agente in base al suo ID nella console Dialogflow CX utilizzando l'opzione Cerca nella pagina Visualizza tutti gli agenti.

Per Dialogflow ES, un progetto può essere associato a un massimo di cinque agenti e un agente Dialogflow ES può essere associato a un numero di telefono. In questo modo puoi aprire l'agente nella console Dialogflow ES tramite https://dialogflow.cloud.google.com/#/editAgent/PROJECT_ID/intents.

Se non viene trovato alcun agente, puoi comunque eliminare il numero di telefono se sei sicuro che non sia più necessario.

Passaggio 3: Eliminare i numeri di telefono inutilizzati

Per eliminare i numeri di telefono non più necessari, utilizza il metodo API projects.phoneNumbers/delete o projects.locations.phoneNumbers.delete. Puoi trovare gli ID dei numeri di telefono nella risposta ai comandi eseguiti nel passaggio 1.

• Per la regione global, utilizza il seguente comando:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

• Per le altre regioni, specifica la regione:

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://REGION_ID-dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

Dialogflow CX Messenger non risponde

Problema

Nessuna risposta dell'agente per le interazioni di Dialogflow CX Messenger.

Soluzione

Se non vedi risposte da Dialogflow CX Messenger, assicurati che la fatturazione sia abilitata nel progetto e che l'API Dialogflow sia abilitata nel progetto. Consulta le istruzioni di configurazione.

Valore parametro corrispondente, ma non è un sinonimo di entità

Problema

• Caso generale: un valore parametro viene estratto in fase di runtime, anche se l'entità corrispondente al parametro non contiene il valore corrispondente come sinonimo.
• Un caso più specifico: dopo l'eliminazione di un sinonimo da un'entità e il nuovo addestramento dell'agente, questo sinonimo viene comunque estratto come valore del parametro per questa entità.

Soluzione

1. Utilizza l'opzione Cerca per verificare se il valore corrispondente potrebbe essere presente nell'agente come entità implicita (Dialogflow CX, Dialogflow ES). Trova tutti gli intent con annotazioni con questo parametro ed entità.
2. Correggi le annotazioni assicurandoti che nessuna di queste venga applicata al testo che rappresenta il valore corrispondente indesiderato.
3. Testa l'agente in fase di runtime per verificare se il problema è stato risolto.
4. Se il problema persiste, assicurati che le opzioni Espansione automatica e Corrispondenza fuzzy siano deselezionate nelle impostazioni avanzate delle entità e testa di nuovo l'agente.

Il bot vocale salta alcune risposte

Problema

Per un agente progettato sia per il testo che per la voce, il bot vocale non legge alcune risposte.

Soluzione

Se per un determinato turno di conversazione è definita almeno una risposta Testo audio di output, assicurati che l'opzione Testo audio di output sia presente in modo coerente in tutte le risposte di fulfillment e webhook dell'agente in tutti i passaggi di questo turno di conversazione.

I tag SSML non hanno effetto

Problema

I tag SSML sono definiti nell'agente di fulfillment, ma il voicebot legge il testo sintetizzato senza effetti SSML.

Soluzione

Assicurati che sia presente una sola coppia <speak></speak> per ogni scheda di risposta nella console Dialogflow o per ogni oggetto messaggio di risposta se le risposte vengono fornite dall'API o dal webhook.

L'agente vocale pronuncia lo zero come la lettera O

Problema

Per un agente progettato per la voce, l'agente vocale legge gli zeri come la lettera O anziché zero.

Soluzione

1. Modifica L'agente dice per utilizzare Opzione di dialogo con testo audio di output.
2. Seleziona la casella di controllo SSML.
3. Racchiudi il testo tra tag SSML:

     <speak>
       <say-as interpret-as='verbatim'>YOUR_TEXT</say-as>
     </speak>

4. Salva.

Ad esempio, gli zeri dei numeri di carta di credito verranno scritti come zeri:

   <speak>
      <say-as interpret-as='verbatim'>5177 7702 8500 4578</say-as>
   </speak>

Pronuncia sintetizzata inaspettata

Problema

La pronuncia sintetizzata delle risposte dell'agente (ad es. nomi propri, acronimi) non è quella prevista.

Soluzione

Per garantire pronunce particolari per parole non comunemente note, utilizza i tag SSML say-as o phoneme nelle risposte dell'agente.

Raggiunto il numero massimo di passaggi di esecuzione della macchina a stati consentiti

Problema

Hai ricevuto il seguente messaggio di errore nella console Dialogflow CX o nei log quando invii richieste di runtime all'agente:

You have reached the maximum allowed state machine execution steps. You may consider simplifying your agent/flow design. Current execution steps are: [<array_of_objects>]

L'array nel messaggio di errore contiene un elenco di passaggi di esecuzione per la richiesta. L'elenco potrebbe essere incompleto se il numero di passaggi è troppo elevato.

Soluzione

Questo messaggio di errore di solito indica che il numero di transizioni per un singolo turno di conversazione è troppo elevato. Un esempio comune è la transizione alla stessa pagina, che crea un loop infinito.

Per risolvere il problema:

1. Copia l'array JSON dal messaggio di errore.
2. (Facoltativo) Formatta l'array copiato come JSON formattato per una migliore leggibilità. Se il messaggio di errore è troncato, cerca l'ultimo oggetto "Step", elimina l'oggetto step incompleto e la virgola precedente e aggiungi una parentesi quadra di chiusura prima di convalidare e formattare il JSON.
3. Esamina i valori "TriggeredTransitionRouteId" e "TargetPage" per ogni passaggio. Nel caso di un ciclo infinito, i campi "TriggeredTransitionRouteId" e "TargetPage" hanno valori ripetuti per la maggior parte dei passaggi.
4. Modifica la progettazione dell'agente per rimuovere le transizioni a ciclo infinito o per ridurre il numero di transizioni per un singolo turno di conversazione.

La corrispondenza mediante espressione regolare è troppo ampia

Problema

È stato ricevuto un errore Regular expression match is too broad durante la creazione di un'entità regexp (Dialogflow CX, Dialogflow ES).

Soluzione

Prendi in considerazione il seguente approccio:

• Utilizza ^ e $ nell'espressione regolare per indicare l'inizio e la fine del testo, rispettivamente.
• Utilizza l'entità regexp con un parametro obbligatorio (Dialogflow CX, Dialogflow ES).
• Definisci le richieste dei parametri obbligatori per chiedere all'utente finale di fornire solo il valore dell'entità senza parole circostanti.

Caratteri non alfanumerici indesiderati inseriti dal riconoscimento vocale

Problema

Quando si tenta di abbinare caratteri alfanumerici, il sistema di riconoscimento vocale inserisce caratteri non alfanumerici indesiderati (spazi, trattini e così via), il che comporta la mancata corrispondenza dell'entità.

Soluzione

1. Se utilizzi entità di sistema per la corrispondenza dei numeri, valuta la possibilità di utilizzare entità regexp (Dialogflow CX, Dialogflow ES).
2. Segui tutti i consigli della sezione Riconoscimento vocale alfanumerico impreciso da parte delle entità regexp.
3. Per i numeri corrispondenti che utilizzano le integrazioni di telefonia, valuta un'opzione DTMF, oltre al riconoscimento vocale.

Trascrizioni vuote per gli input vocali

Problema

Le risposte di Dialogflow per gli input vocali restituiscono trascrizioni vuote. Le richieste vengono gestite come nessun input o nessuna corrispondenza.

Soluzione

Ascolta la registrazione audio per verificare che contenga del parlato.

Assicurati che l'adattamento vocale sia abilitato nelle impostazioni dell'agente (Dialogflow CX, Dialogflow ES).

Se l'attivazione dell'adattamento vocale non risolve il problema, prova i seguenti modelli vocali in una configurazione non di produzione e utilizza quello che offre i risultati migliori:

• latest_short
• phone_call
• command_and_search

Per le lingue diverse dall'inglese, trova i modelli vocali supportati nella documentazione Lingue supportate da Speech-to-Text.

Il modo per specificare un modello vocale dipende da come configuri le interazioni con Dialogflow.

• Per le richieste API, fornisci il nome del modello nel campo model in InputAudioConfig (Dialogflow CX, Dialogflow ES).

• Se utilizzi Phone Gateway (Dialogflow CX, Dialogflow ES), puoi aggiornare il modello vocale nel profilo di conversazione creato da Dialogflow quando hai attivato l'integrazione:

  1. Recupera l'ID profilo di conversazione:

     • Utilizza il metodo conversationProfiles.list per recuperare tutti i profili di conversazione collegati al tuo progetto.
     • Trova il profilo della conversazione che vuoi aggiornare e copia il valore del campo name.

     Per il gateway di telefonia Dialogflow CX, il nome visualizzato del profilo conversazione si trova nelle impostazioni di integrazione. Per il gateway di telefonia Dialogflow ES, il nome visualizzato del profilo conversazione corrisponde al nome dell'agente in cui è stata attivata l'integrazione.

     Se hai più profili conversazione con lo stesso nome visualizzato, verifica l'ID agente nel campo automatedAgentConfig della risposta del metodo conversationProfiles.list.

  2. Utilizza il metodo API conversationProfiles.patch per aggiornare il campo model in SpeechToTextConfig.

• Per le integrazioni di Contact Center AI, rivolgiti all'integratore di telefonia per informazioni su come aggiornare il modello vocale per l'integrazione o per le singole richieste.

Informazioni sugli errori di loop del playbook

Problema

Durante il collegamento dei playbook, si è verificato l'errore Playbook <playbookID> caused loop in playbook routes.

Soluzione

Un loop può verificarsi se tenti di eseguire il routing a un playbook "ancestor", ovvero uno che ha chiamato direttamente o indirettamente quello attuale. Per risolvere il problema, verifica che il routing del playbook sia unidirezionale e non torni a un playbook padre nello stesso percorso conversazionale.

Errore di schermata vuota "Le dimensioni del file superano i 2 MB" durante il confronto delle versioni dell'agente

Problema

Quando provi a confrontare due versioni diverse dell'agente, lo schermo diventa vuoto e viene visualizzato il messaggio di errore:

File size exceeds 2MB

Questo problema è dovuto al fatto che uno dei file supera le dimensioni di 2 MB.

Soluzione

Per confrontare le versioni dell'agente in cui uno dei file supera le dimensioni di 2 MB, è consigliabile utilizzare il metodo API compareVersion.

Riconoscimento vocale alfanumerico impreciso da parte delle entità Regexp

Problema

Ricezione di trascrizioni imprecise per gli input vocali di caratteri alfanumerici progettati per essere abbinati a un'entità regexp (Dialogflow CX, Dialogflow ES).

Soluzione

1. Assicurati che l'adattamento del parlato sia abilitato nelle impostazioni dell'agente (Dialogflow CX, Dialogflow ES).
2. Assicurati che almeno una voce di entità soddisfi tutti i requisiti delle voci di espressioni regolari (Dialogflow CX, Dialogflow ES).
3. Per pattern specifici, utilizza le espressioni regolari più specifiche. Ad esempio, per un valore alfanumerico che inizia con due lettere seguite da cinque cifre, utilizza [a-zA-Z]{2}\d{5} anziché [a-zA-Z0-9]{7}.
4. Assicurati che la tua entità regexp consenta la corrispondenza di caratteri non alfanumerici (spazi, trattini e così via) che potrebbero essere inseriti dal sistema di riconoscimento vocale. Per soddisfare il requisito 2 di questo elenco, crea più voci di entità: una voce per soddisfare i requisiti 2 di questo elenco e un'altra per tenere conto dei caratteri non alfanumerici. Ad esempio, per trovare corrispondenze con cinque cifre e consentire caratteri non alfanumerici:

    \d{5}
    (\d[^a-zA-Z0-9]*){5}
   

5. Assicurati che l'agente rispetti il requisito di definizione dei parametri (Dialogflow CX, Dialogflow ES).

   Esempio per Dialogflow CX

   

   Esempio per Dialogflow ES

   
6. Assicurati che l'agente rispetti il requisito di annotazione delle frasi di addestramento (Dialogflow CX, Dialogflow ES).

   Esempio per Dialogflow ES

   
7. Assicurati che i test seguano le linee guida per i test (Dialogflow CX, Dialogflow ES).
8. Per rimuovere i caratteri non alfanumerici che potrebbero essere stati inseriti dal sistema di riconoscimento vocale, utilizza quanto segue:
   • Per Dialogflow CX: funzione di sistema SUBSTITUTE o webhook
   • Per Dialogflow ES: webhook
9. Controlla le limitazioni dell'adattamento del parlato (Dialogflow CX, Dialogflow ES).

Progettare conversazioni controllate

Crea il tuo agente con percorsi di conversazione chiaramente definiti. Assicurati che l'agente possa richiedere le informazioni necessarie per soddisfare i requisiti dell'utente. Evita un ambito conversazionale eccessivamente ampio, che può portare a un comportamento imprevedibile.

Analisi dei log

Gli input e gli output di playbook, strumenti e datastore vengono acquisiti nei log. Utilizza gli ID conversazione raccolti per seguire la catena di chiamate e identificare il punto in cui l'esecuzione è andata male.

Sperimentare con i prompt

Se un insieme specifico di istruzioni non funziona come previsto, prova a riformularlo. In alternativa, puoi utilizzare Gemini per generare prompt (meta-prompting). Questo approccio iterativo può aiutarti a trovare la formulazione ottimale per il tuo caso d'uso.

Fornire informazioni complete all'assistenza

Quando apri una richiesta di assistenza con l'assistenza Cloud, includi gli ID conversazione e i log pertinenti raccolti durante l'indagine. Queste informazioni sono fondamentali per eseguire il debug dei problemi in modo efficiente.