Comprendere i codici di errore

Articolo
12/09/2024

Quando un agente riscontra un problema durante una conversazione, risponde con un messaggio che include un codice di errore per il problema specifico riscontrato. Gli utenti di agente dovrebbero comunicare questo codice di errore al loro amministratore.

In qualità di creatore di agente, se si verifica un problema quando utilizzi il riquadro di prova per testare il tuo agente, puoi visualizzare un messaggio con maggiori dettagli sul problema, oltre al codice di errore. In alternativa, puoi utilizzare il pannello Verifica argomento per convalidare il tuo agente.

Elenco degli errori

Nota

Il termine interazione utilizzato in alcuni messaggi di errore si riferisce a un argomento.

Codice errore	Descrzione
Errore di contenuto	Si è verificato un errore nel contenuto dell'argomento.
Violazione della prevenzione della perdita di dati	C'è stata una violazione dei criteri di prevenzione della perdita dei dati.
Eccezione di azione di flusso	Si è verificato un errore durante l'esecuzione di un flusso cloud.
Richiesta errata di azione di flusso	Una richiesta fatta a un flusso cloud non era valida.
Temporizzato dall'azione di flusso	L'esecuzione di un flusso cloud ha richiesto più di 100 secondi e si è verificato un timeout.
Contenuto non valido	Contenuto non valido è stato aggiunto all'editor di codice.
Contenuto di InfiniteLoopInBot	Un nodo è stato eseguito troppe volte.
UltimaVersionePubblicataNonTrovato	Impossibile recuperare la versione pubblicata di agente.
Reindirizza a dialogo disabilitato	Un argomento è in fase di reindirizzamento a un argomento disabilitato.
Reindirizza a dialogo inesistente	Un argomento sta effettuando il reindirizzamento a un altro argomento che non esiste più.
Errore di sistema	Si è verificato un errore di sistema in Copilot Studio.

ContentError

Messaggio di errore: Questo errore produce messaggi dinamici in base al contesto dell'errore.

Risoluzione: Questo è un errore generale per i problemi relativi al contenuto del tuo agente. Per ulteriori informazioni, fai riferimento al messaggio di errore.

I problemi comuni includono:

Nel nodo mancano le proprietà obbligatorie.
YAML non valido aggiunto con editor di codice.
Una formula Power Fx contiene un errore.

DataLossPreventionViolation

Messaggio di errore: "Questo ambiente richiede agli utenti di effettuare l'accesso prima di poter utilizzare agente. Vai a Gestisci > Sicurezza > Autenticazione e seleziona l'opzione per richiedere agli utenti di accedere."

Risoluzione:

I criteri di prevenzione della perdita di dati (DLP) dell'ambiente richiedono l'accesso dell'utente. Vedi Aggiungere l'autenticazione utente con l'argomento di sistema Accesso.
Uno o più connettori utilizzati in agente non si trovano nello stesso gruppo di dati. Vedi Copilot Studioconnettori.
Uno o più connettori utilizzati in agente sono bloccati dal tenant amministratore.

FlowActionException

Messaggi di errore:

"Non è stato ricevuto alcun output dal flusso {FlowName} ({FlowId}), nonostante l'output fosse previsto in base alla definizione agente."
"Il parametro di output con nome {ItemKey} sul flusso {FlowName} ({FlowId}) manca dai dati di risposta. Aggiorna il flusso o verifica che il flusso restituisca questo valore."
"Il parametro di output con nome {ItemKey} sul flusso {FlowName} ({FlowId}) manca dallo schema di output. Aggiorna il flusso."

Risoluzione:Controllare il flusso per eventuali errori.

FlowActionBadRequest

Messaggi di errore:

"Il parametro con nome {KeyName} sul flusso {FlowName} ({FlowId}) è dichiarato di tipo {ItemTypeKind}. Questo tipo non è supportato durante il richiamo di Power Automate. Attualmente sono supportati solo testo, booleano e numeri."
"Il parametro con nome {ItemKey} sul flusso {FlowName} ({FlowId}) manca nell'azione "Chiama flusso".
"Il parametro con nome {KeyName} sul flusso {FlowName} ({FlowId}) è valutato di tipo {ResolveType}, il tipo previsto è {ExpectedType}."
"Il flusso {FlowName} ({FlowId}) non è stato eseguito con il codice di risposta {ResponseCode}, codice errore: {FlowErrorCode}."

Risoluzione: Verificare che il tipo di base di tutte le variabili passate al flusso corrisponda al tipo del parametro.

FlowActionTimedOut

Messaggio di errore: "Il flusso con id {FlowId} è scaduto. Codice di errore: {FlowErrorCode}"

Risoluzione:Controlla il flusso per eventuali errori per capire perché l'esecuzione di flusso cloud ha impiegato più di 100 secondi prima di tornare a agente. Prova a ottimizzare la query e i dati restituiti dal sistema di back-end. Se una parte della logica flusso cloud può continuare a essere eseguita dopo l'invio di un risultato a agente, inserisci queste azioni dopo 'Restituisci valori a Copilot Studio' passaggio nel tuo flusso cloud.

InvalidContent

Messaggio di errore: "Esistono in totale {TotalComponents} componenti in agente, ma nessuno è valido."

Risoluzione:Aprire l'editor del codice per rivedere i problemi con il contenuto.

InfiniteLoopInBotContent

Messaggio di errore: "Azione {DialogId}.{TriggerId}.{ActionId} è stata eseguita più di {MaxTurnCount} volte di seguito. Ciò indica un ciclo in esecuzione della finestra di dialogo e quindi l'esecuzione della finestra di dialogo verrà interrotta."

Risoluzione: Assicurati che argomento termini correttamente e che contenga link ad altri argomenti che terminano correttamente, come Escalate argomento di sistema.

LatestPublishedVersionNotFound

Messaggio di errore: "Impossibile recuperare l'ultima versione pubblicata di agente."

Risoluzione:Pubblicare agente.

RedirectToDisabledDialog

Messaggio di errore: "La finestra di dialogo con Id {DialogId} è disabilitata nella definizione. Abilita la finestra di dialogo prima di utilizzarla."

Risoluzione:Riattivare argomento oppure rimuovere il nodo di reindirizzamento.

RedirectToNonExistentDialog

Messaggio di errore: "Il dialogo con Id {DialogId} non è stato trovato nella definizione. Verifica che la finestra di dialogo sia presente e che l'ID sia corretto."

Risoluzione:Creare un nuovo argomento a cui reindirizzare oppure rimuovere il nodo di reindirizzamento.

SystemError

Messaggio di errore: Questo errore non produce alcun messaggio di errore.

Risoluzione:Contattare l'assistenza clienti.

Error	Risposta del bot	Risoluzione
2000	"L'utente è sottoposto a trapping in un ciclo infinito. Verifica che `{Topic Name}` raggiunga una conclusione logica."	Assicurati che argomento termini correttamente o che siano presenti link ad altri argomenti che terminano correttamente, come Escalate argomento di sistema.
2001	"Il contenuto del bot non è valido."	Controllare argomento per eventuali errori.
2002	"Si è verificato un problema con CDS."	Si è verificato un problema di accesso a Dataverse. Controlla la tua configurazione per errori. Altrimenti riprova più tardi perché potrebbe esserci un problema con il servizio.
2003	"Si è verificato un problema con `{Flow Name}` in `{Topic Name}`. Controlla il contenuto."	Controllare il flusso per individuare eventuali errori e cercare esecuzioni non riuscite nella cronologia delle esecuzioni del flusso.
2004	"Si è verificato un problema con `{Skill Name}` in `{Topic Name}`. Controlla il contenuto."	Si è verificato un problema con la competenza. Controlla la competenza e l'argomento per errori.
2005	"Si è verificato un problema." Controlla il contenuto."	Si è verificato un problema con il modello di flusso Power Automate. Controllare il flusso per eventuali errori.
2006	"Non è stato possibile trovare il tuo bot."	Non è stato possibile trovare il bot perché il bot o il suo ambiente è stato eliminato. Per configurare un nuovo bot, vedere Creare ed eliminare agenti. Per configurare un nuovo ambiente, vedi Utilizzo di ambienti Power Platform.
2007	"Il bot contiene troppo contenuto per poter funzionare."	Riduci la lunghezza dei messaggi o il numero di argomenti, quindi riprova. Leggi di più sui limiti di contenuto.
2008	"Non è stato possibile trovare il token dell'utente".	Controlla la configurazione di autorizzazione del bot per errori.
2009	"Per utilizzare questo bot, pubblicalo in Copilot Studio."	Per utilizzare questo bot, pubblicalo in Copilot Studio.
2010	"Non è possibile recuperare il contenuto del tuo bot".	Impossibile trovare il contenuto perché è stato eliminato. Per configurare un nuovo agente, vedere Creare ed eliminare agenti. Per configurare un nuovo ambiente, vedi Utilizzo di ambienti Power Platform.
2011	"Non è stato possibile trovare `{Skill Name}` in `{Topic Name}`. Controlla il contenuto."	Impossibile trovare la competenza perché è stata eliminata. Per creare una nuova abilità, vedi Configurare una competenza Bot Framework.
2012	"Non è stato possibile trovare `{Flow Name}` in `{Topic Name}`. Controlla il contenuto."	Impossibile trovare il flusso Power Automate perché è stato eliminato. Per creare un nuovo flusso, vedi Creare un flusso.
2014	"Il servizio di traduzione non risponde."	Riprovare. Se il problema persiste, contatta il servizio clienti.
2015	"Non sei autorizzato a chiamare `{Skill Name}`. Verifica la competenza e il relativo utilizzo per qualsiasi problema."	Controlla la configurazione della competenza e assicurati che il tuo bot sia aggiunto all'elenco degli elementi consentiti della competenza.
2016	"Non è stato possibile trovare il tuo bot".	Si è verificato un problema con un canale del servizio Azure Bot. Il canale potrebbe essere stato eliminato o essere configurato in modo errato.
2017	"Non è stato possibile accedere al tuo bot".	Non è stato possibile accedere al canale del servizio Azure Bot. Controlla la configurazione del canale per problemi di autenticazione.
2018	"L'utente sta digitando troppo rapidamente."	Hai inviato i messaggi troppo velocemente. Per saperne di più su quote e limiti entro Copilot Studio.
2019	"Non è stato possibile trovare il tuo ambiente. Potrebbe essere stato eliminato."	L'ambiente è stato eliminato. Per configurare un nuovo ambiente, vedi Utilizzo di ambienti Power Platform.
2020	"Si è verificato un problema e `{Flow Name}` non sta funzionando in `{Topic Name}`. Riprovare. Se il problema persiste, controlla la configurazione del flusso e la cronologia di esecuzione."	Il flusso Power Automate non è funzionante. Riprovare. Se il problema persiste, controlla il flusso per errori.
2021	"Il numero di finestre di dialogo eseguite nel turno corrente ha superato il limite massimo di `{Dialog Limit}`."	Per impostazione predefinita, il numero massimo di argomenti è 50. Riduci il numero di argomenti, quindi riprova.
2022	"Il bot ha inviato più di `{Message Limit}` messaggi in questo turno."	Limita i messaggi per turno a meno di 30.
2023	"Si è verificato un problema durante l'esecuzione della finestra di dialogo di composizione."	Controllare la finestra di dialogo Compositore per eventuali errori.
2024	"Questo ambiente richiede agli utenti di accedere prima di poter utilizzare il bot. Vai a Gestisci > Sicurezza > Autenticazione e seleziona l'opzione per richiedere agli utenti di accedere."	I criteri di prevenzione della perdita di dati (DLP) dell'ambiente richiedono l'accesso dell'utente. Per informazioni su come richiedere agli utenti di effettuare l'accesso, vedere Configurare l'autenticazione utente.
2025	"Nell'argomento `{Topic Name}` sono disponibili uno o più nodi vuoti. Controlla il tuo contenuto."	Aggiungi contenuto ai nodi vuoti o rimuovili dall'argomento.
2025	"`{Topic Name}` sta reindirizzando a un argomento, che è stato disattivato. Ritorna a `{Topic Name}` e controlla i tuoi contenuti."	L'argomento sta effettuando il reindirizzamento a un altro argomento che è stato disattivato. Riattivare argomento oppure rimuovere il nodo di reindirizzamento.
2025	"L'argomento che stai cercando di reindirizzare non esiste più. Ritorna a `{Topic Name}` e controlla i tuoi contenuti."	L'argomento che stai cercando di reindirizzare non esiste più. Crea un nuovo argomento a cui reindirizzare oppure rimuovi il nodo di reindirizzamento.
2026	"Si è verificato un problema con il flusso Power Automate. Controlla il contenuto."	Controllare il flusso per eventuali errori.
2030	"Controlla la cronologia di esecuzione del flusso di Power Automate e assicurati che il flusso sia stato eseguito correttamente".
2101	"La conversazione dell'utente con il bot è troppo lunga o il messaggio dell'utente è troppo lungo".	Prova a riavviare la conversazione con il bot o a utilizzare un messaggio più breve.
2102	"L'utente ha inviato un messaggio troppo grande per essere elaborato."	Hai inviato un messaggio troppo grande per essere elaborato. Accorcia il messaggio, quindi riprova.
3000	"Errore imprevisto"	Si è verificato un errore di sistema. Per maggiori dettagli, contattare l'assistenza clienti.
3001	"Power Automate non è disponibile per il tuo flusso `{Flow Name}`. Riprova più tardi."	Power Automate non risponde. Riavvia la conversazione con il tuo bot e riprova. Se il problema persiste, contatta il servizio clienti.
3002	"Si è verificato un problema in Power Automate e la tua richiesta al flusso `{Flow Name}` non è stata accettata. Riprova più tardi."	Si è verificato un errore in Power Automate e la richiesta al flusso non è stata accettata. Il flusso potrebbe aver impiegato più di 2 minuti per rispondere.
3003	"Si è verificato un problema di rete durante la connessione al flusso `{Flow Name}`. Riprova più tardi."	Riprovare. Se il problema persiste, contatta il servizio clienti.

Condividi tramite