Alcuni prodotti e funzionalità sono in fase di rinominazione. Anche le funzionalità di playbook e flusso generativi sono in fase di migrazione a un'unica console consolidata. Consulta i dettagli.

Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione dei problemi

Filtra i contenuti di questo documento in base al tag del tipo di agente:

Filtra i contenuti di questo documento in base al tag della categoria:

Attiva Cloud Logging per l'agente

Attiva Cloud Logging per l'agente. Questo è fondamentale 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 Dialogflow. Questi ID, disponibili nella cronologia delle conversazioni, consentono di tracciare il percorso di esecuzione di una conversazione ed esaminare interazioni specifiche.

La chiamata API riceve l'autorizzazione di accesso negata

Tag tipo agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: API, Auth

Problema

È stata ricevuta la risposta PERMISSION_DENIED per la chiamata API.

Soluzione:

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

Hai creato un account di servizio e non lo hai eliminato per errore.
Avere assegnato all'account di servizio un ruolo che concede l'autorizzazione a chiamare il metodo desiderato.
Hai scaricato il file della chiave privata dell'account di servizio.
Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul file della chiave privata.

La chiamata API menziona un progetto sconosciuto

Tag tipo agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: API, Progetto

Problema

È stato ricevuto un errore Dialogflow API has not been used in project 32555940559 per la chiamata API.

Soluzione:

Assicurati di aver eseguito quanto segue:

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS (vedi PERMISSION_DENIED).
È stato fornito l'ID progetto corretto alla chiamata API.

La chiamata API genera un errore relativo a credenziali di autenticazione non valide

Tag tipo agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: API, Auth

Problema

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

Soluzione:

Questo potrebbe essere dovuto alla creazione manuale delle credenziali con la libreria client e alla specifica di una regione non predefinita. Per indicazioni, consulta una delle seguenti risorse:

La risposta alla chiamata API richiede il passaggio a un altro host

Tag tipo agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: API, Auth

Problema

Ho ricevuto la 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:

Questo accade quando specifichi la regione nella richiesta, ma non l'endpoint. Per indicazioni, consulta una delle seguenti risorse:

Campi mancanti nella risposta alla chiamata dell'API

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: API

Problema

Alcuni campi mancano nella risposta dell'API.

Soluzione:

Se prevedi un valore numerico per un campo specifico nella risposta dell'API, il campo potrebbe non essere presente nella risposta se il valore restituito è 0.

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

Impossibile eliminare il progetto a causa di un'ipoteca

Tag tipo di agente: Dialogflow ES
Tag categoria: Progetto

Problema

Quando provi a eliminare un progetto Google Cloud, ricevi una notifica che ti informa che il progetto non può essere eliminato perché presenta vincoli e uno di questi è correlato a Dialogflow ES.

Soluzione:

Assicurati di non avere più bisogno dell'agente Dialogflow ES associato al progetto. Se ricevi una notifica che ti informa 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.
Ottieni il nome del blocco.
gcloud
Utilizza il comando gcloud alpha resource-manager liens list, come descritto nella documentazione relativa all'elencazione dei pignoramenti in 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 Execute (Esegui).
Elimina il blocco.
gcloud
Utilizza il comando gcloud alpha resource-manager liens delete LIEN_NAME, come descritto nella documentazione relativa alla rimozione dei blocchi da un progetto.
Explorer API
Utilizza il riquadro Prova questa API nella pagina Metodo: liens.delete:
- Compila il campo name con il nome del blocco che hai ottenuto nel passaggio 2.
- Fai clic su Execute (Esegui).
Chiudi il progetto.

Il webhook Dialogflow CX non riesce con l'errore Scadenza superata

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: runtime

Problema

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

Webhook call failed. Error: DEADLINE_EXCEEDED

Questo può accadere perché la chiamata all'webhook supera il limite di tempo di attesa dell'webhook. Di seguito sono riportati i possibili motivi per cui la chiamata all'webhook supera il limite di timeout:

Stai tentando di attivare un'intenzione inesistente.
Un problema di avvio a freddo con il backend del webhook (ad esempio Cloud Functions).
Il webhook chiama altri servizi, aumentando il tempo di risposta.
Nessuna connessione tra l'agente e il backend del 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

Un webhook ha un limite di timeout di 5 secondi per impostazione predefinita. Puoi aumentare il limite di tempo del webhook quando crei o modifichi la risorsa webhook, in modo da dare più tempo al webhook per rispondere.

La console non riesce a configurare il progetto

Tag tipo agente: Dialogflow ES
Tag categoria: Console, Progetto

Problema

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

Soluzione:

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

Riferimento al parametro della sessione mostrato nella risposta

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: Console

Problema

Le risposte restituite da Dialogflow includono i riferimenti ai parametri instead of the values of the parameters. Ad esempio:
Hello, $session.params.customer_name

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

Soluzione:

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

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

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: Console

Problema

Ho ricevuto un errore Dialogflow API has not been enabled for the project. Code: FAILED_PRECONDITION 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 di servizio

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: Console

Problema

Ho ricevuto un messaggio di errore You don't have access to this service quando ho provato ad accedere alla console dal mio account dell'organizzazione.

Soluzione:

Contatta l'amministratore di sistema della tua organizzazione e verifica che le impostazioni dell'organizzazione forniscano l'accesso alla console.

Se le impostazioni della tua organizzazione dovrebbero consentire l'accesso e hai eseguito la migrazione del tuo account da un'altra organizzazione, il tuo account potrebbe essere stato segnalato come limitato da Google. È probabile che si tratti del problema se altri utenti della tua organizzazione possono accedere alla console, ma tu non riesci. Contatta l'assistenza per ricevere assistenza.

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

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: Console

Problema

L'esportazione dell'agente come byte non elaborati viene completata correttamente, ma l'esportazione dell'agente in formato JSON non va a buon fine con un messaggio di errore simile al seguente:

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 un caso di test che fa riferimento a un flusso eliminato.

Soluzione:

Per risolvere il problema, esamina i casi di test inutilizzati per verificare se il flusso a cui si fa riferimento nel messaggio di errore viene utilizzato in qualche caso di test. Dopodiché, elimina gli scenari di test confermati.

Connettività del gateway dello smartphone

Tag tipo agente: Dialogflow ES
Tag categoria: Integrazione

Problema

Quando utilizzi il gateway telefonico, ricevi un 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 tua quota.

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

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: Integrazione

Problema

Quando si tenta di creare un nuovo numero di telefono in Agent Assist, Dialogflow ES o Conversational Agents (Dialogflow CX), 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 sei al di sotto del limite.

Se hai creato numeri di telefono nel gateway di telefonia di Conversational Agents (Dialogflow CX) o nel gateway di telefonia Dialogflow ES, 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 i passaggi che seguono.

Passaggio 1: Identifica 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 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/phoneNumbers

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

L'ID agente di Conversational Agents (Dialogflow CX) associato al numero di telefono tramite il profilo della conversazione potrebbe aiutarti a identificare se l'agente è ancora in uso e se il numero di telefono è ancora necessario. Per farlo, puoi utilizzare il metodo API projects.conversationProfiles/get. Puoi trovare gli ID profilo 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 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/conversationProfiles/CONVERSATION_PROFILE_ID

Puoi trovare l'agente tramite il relativo ID nella console di Conversational Agents (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. Puoi quindi 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 hai la certezza 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

Nessuna risposta di Dialogflow CX Messenger

Tag tipo agente: agenti conversazionali (Dialogflow CX)
Tag categoria: Integrazione

Problema

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

Soluzione:

Se non visualizzi alcuna risposta 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.

Il valore del parametro corrisponde, ma non è un sinonimo di entità

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: NLU

Problema

Caso generale: un valore del parametro viene estratto in fase di esecuzione, anche se l'entità corrispondente al parametro non contiene il valore corrispondente come sinonimo.

Un caso più specifico: dopo che un sinonimo è stato eliminato da un'entità e l'agente è stato sottoposto a nuovo addestramento, questo sinonimo viene comunque estratto come valore del parametro per questa entità.

Soluzione:

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

Il bot vocale salta alcune risposte

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: sintesi vocale

Problema

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

Soluzione:

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

I tag SSML non vengono applicati

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: conversione di testo in voce

Problema

I tag SSML sono definiti nell'elaborazione dell'agente, ma il bot vocale legge il testo sintetizzato senza effetti SSML.

Soluzione:

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

L'agente vocale pronuncia zero come la lettera O

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: sintesi vocale

Problema

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

Soluzione:

Modifica Agente dice per utilizzare l'opzione di dialogo per l'output del testo audio.
Seleziona la casella di controllo SSML.

Racchiudi il testo con un tag SSML:

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

Salva.

Ad esempio, gli zeri dei numeri di carte di credito verranno indicati come zeri.

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

Pronuncia sintetizzata imprevista

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: conversione di testo in voce

Problema

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

Soluzione:

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

È stato raggiunto il numero massimo di passaggi di esecuzione della macchina a stati consentiti

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: runtime

Problema

Hai ricevuto il seguente messaggio di errore nella console di Conversational Agents (Dialogflow CX) o nei log durante l'invio di 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 indica in genere 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:

Copia l'array JSON dal messaggio di errore.
(Facoltativo) Formatta l'array copiato come JSON leggibile per una maggiore leggibilità. Se il messaggio di errore è troncato, cerca l'ultimo oggetto "Passaggio", elimina l'oggetto passaggio incompleto e la virgola precedente, e aggiungi una parentesi graffa di chiusura dell'array prima di convalidare e abbellire il JSON.
Esamina i valori "TriggeredTransitionRouteId" e "TargetPage" per ogni passaggio. In caso di loop infinito, i campi "TriggeredTransitionRouteId" e "TargetPage" hanno valori ripetuti per la maggior parte dei passaggi.
Modifica il design dell'agente per rimuovere le transizioni con loop infinito o per ridurre il numero di transizioni per un singolo turno di conversazione.

La corrispondenza dell'espressione regolare è troppo generica

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: regex

Problema

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

Soluzione:

Prendi in considerazione il seguente approccio:

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

Caratteri non alfanumerici indesiderati inseriti dal riconoscimento vocale

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: Speech-to-Text

Problema

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

Soluzione:

Se utilizzi entità di sistema per la corrispondenza dei numeri, ti consigliamo di utilizzare le entità regexp (Conversational Agents (Dialogflow CX), Dialogflow ES).
Segui tutti i consigli riportati nella sezione Riconoscimento vocale di caratteri alfanumerici non accurati tramite entità regexp.
Per la corrispondenza dei numeri tramite le integrazioni di telefonia, valuta la possibilità di utilizzare un'opzione DTMF oltre al riconoscimento vocale.

Trascrizioni vuote per gli input vocali

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: Speech-to-Text

Problema

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

Soluzione:

Ascolta la registrazione audio per verificare che contenga del parlato.

Assicurati che l'adattamento vocale sia abilitato nelle impostazioni dell'agente (Conversational Agents (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 genera i risultati migliori:

latest_short
phone_call
command_and_search

Per le lingue diverse dall'inglese, consulta i modelli vocali supportati nella documentazione relativa alle lingue supportate per la conversione della voce in testo.

Il modo in cui 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 (Agenti conversazionali (Dialogflow CX), Dialogflow ES).
Se utilizzi Phone Gateway (Agenti conversazionali (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.
  - Individua il profilo di conversazione da aggiornare e copia il valore del campo name.
  Per il gateway di telefonia Dialogflow CX, il nome visualizzato del profilo di conversazione si trova nelle impostazioni di integrazione. Per il gateway di telefonia Dialogflow ES, il nome visualizzato del profilo di conversazione corrisponde al nome dell'agente in cui è stata attivata l'integrazione.
  
  Se hai più profili di conversazione con lo stesso nome visualizzato, verifica l'ID agente nel campo automatedAgentConfig della risposta del metodo conversationProfiles.list.
2. Utilizza il metodo dell'API conversationProfiles.patch per aggiornare il campo model in SpeechToTextConfig.
Per le integrazioni di Contact Center AI, consulta il tuo integratore di telefonia su come aggiornare il modello vocale per l'integrazione o per le singole richieste.

Schermata vuota con errore "Le dimensioni del file superano i 2 MB" quando si confrontano le versioni dell'agente

Tag tipo di agente: agenti conversazionali (Dialogflow CX)
Tag categoria: Console

Problema

Quando si tenta di confrontare due versioni diverse dell'agente, lo schermo diventa vuoto con il messaggio di errore:

File size exceeds 2MB

Il problema è dovuto al fatto che le dimensioni di uno dei file superano i 2 MB.

Soluzione:

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

Riconoscimento vocale alfanumerico impreciso da parte delle entità regexp

Tag tipo di agente: agenti conversazionali (Dialogflow CX), Dialogflow ES
Tag categoria: conversione della voce in testo, regex

Problema

Sono state ricevute trascrizioni imprecise per input vocali di alfanumerici progettati per essere abbinati a un'entità regexp (Conversational Agents (Dialogflow CX), Dialogflow ES).

Soluzione:

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

Esempio per gli agenti conversazionali (Dialogflow CX)

Esempio per Dialogflow ES
Assicurati che l'agente rispetti il requisito di annotazione delle frasi di addestramento (Agenti conversazionali (Dialogflow CX), Dialogflow ES).
Esempio per Dialogflow ES
Assicurati che i test rispettino le linee guida per i test (Agenti conversazionali (Dialogflow CX) , Dialogflow ES).
Per rimuovere i caratteri non alfanumerici che potrebbero essere stati inseriti dal riconoscimento vocale, procedi nel seguente modo:
- Per Conversational Agents (Dialogflow CX): funzione di sistema SUBSTITUTE o webhook
- Per Dialogflow ES: webhook
Controlla le limitazioni dell'adattamento del parlato (Agenti conversazionali (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 degli utenti. Evita uno scopo della conversazione troppo ampio, che può portare a un comportamento imprevedibile.

Analizza i 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 dove si è verificata un'esecuzione errata.

Sperimentare i prompt

Se un insieme specifico di istruzioni non funziona come previsto, prova a riformularlo. In alternativa, puoi utilizzare Gemini per generare prompt (meta-prompt). 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.

Risoluzione dei problemi

Attiva Cloud Logging per l'agente

Raccogliere gli ID conversazione

La chiamata API riceve l'autorizzazione di accesso negata

La chiamata API menziona un progetto sconosciuto

La chiamata API genera un errore relativo a credenziali di autenticazione non valide

La risposta alla chiamata API richiede il passaggio a un altro host

Campi mancanti nella risposta alla chiamata dell'API

Impossibile eliminare il progetto a causa di un'ipoteca

Console di Dialogflow ES

API Dialogflow

gcloud

Explorer API

gcloud

Explorer API

Il webhook Dialogflow CX non riesce con l'errore Scadenza superata

La console non riesce a configurare il progetto

Riferimento al parametro della sessione mostrato nella risposta

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

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

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

Connettività del gateway dello smartphone

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

Nessuna risposta di Dialogflow CX Messenger

Il valore del parametro corrisponde, ma non è un sinonimo di entità

Il bot vocale salta alcune risposte

I tag SSML non vengono applicati

L'agente vocale pronuncia zero come la lettera O

Pronuncia sintetizzata imprevista

È stato raggiunto il numero massimo di passaggi di esecuzione della macchina a stati consentiti

La corrispondenza dell'espressione regolare è troppo generica

Caratteri non alfanumerici indesiderati inseriti dal riconoscimento vocale

Trascrizioni vuote per gli input vocali

Schermata vuota con errore "Le dimensioni del file superano i 2 MB" quando si confrontano le versioni dell'agente

Riconoscimento vocale alfanumerico impreciso da parte delle entità regexp

Esempio per gli agenti conversazionali (Dialogflow CX)

Esempio per Dialogflow ES

Esempio per Dialogflow ES

Progettare conversazioni controllate

Analizza i log

Sperimentare i prompt

Fornire informazioni complete all'assistenza

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