Comprendere i codici di errore

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 dell'agente devono comunicare questo codice di errore al proprio amministratore.

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

Elenco degli errori

Applicazione Web

Nota

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

Codice errore	Descrzione
AsyncResponsePayloadTooLarge	Si è verificato un errore correlato all'output di un connettore.
ContentError	Si è verificato un errore nel contenuto dell'argomento.
DataLossPreventionViolation	C'è stata una violazione dei criteri di prevenzione della perdita dei dati.
EnforcementMessageC2	Capacità prepagata insufficiente.
FlowActionException	Si è verificato un errore durante l'esecuzione di un flusso cloud.
FlowActionBadRequest	Una richiesta fatta a un flusso cloud non era valida.
FlowActionTimedOut	L'esecuzione di un flusso cloud ha richiesto più di 100 secondi e si è verificato un timeout.
GenAISearchandSummarizeRateLimitReached	È stato raggiunto il limite di utilizzo per l'intelligenza artificiale generativa.
GenAIToolPlannerRateLimitReached	È stato raggiunto il limite di utilizzo per l'orchestrazione generativa.
InvalidContent	Contenuto non valido è stato aggiunto all'editor di codice.
InfiniteLoopInBotContent	Un nodo è stato eseguito troppe volte.
LatestPublishedVersionNotFound	Impossibile recuperare la versione pubblicata dell'agente.
OutgoingMessageSizeTooBig	Un messaggio inviato da un agente è troppo grande per essere elaborato.
TroppiDatiDaGestire	La richiesta effettuata dall'utente è troppo grande per essere elaborata.
OpenAIRateLimitReached	È stato raggiunto il limite di capacità dell'agente.
RedirectToDisabledDialog	Un argomento è in fase di reindirizzamento a un argomento disabilitato.
RedirectToNonExistentDialog	Un argomento sta effettuando il reindirizzamento a un altro argomento che non esiste più.
SystemError	Si è verificato un errore di sistema in Copilot Studio.

AsyncResponsePayloadTooLarge

Messaggio di errore: L'output restituito dal connettore era troppo grande per essere gestito dall'agente. Prova a ridurre le dimensioni utilizzando i filtri del connettore disponibili o limitando il numero di uscite delle azioni configurate.

Risoluzione: Uno dei connettori in tempo reale dell'agente restituisce un payload maggiore di quello che l'agente può gestire. Per altre informazioni sul limite di payload, vedere Limiti delle app Web di Copilot Studio.

ContentError

Messaggio di errore: questo errore produce messaggi dinamici basati sul contesto dell'errore.

Risoluzione: questo messaggio è un errore generico per i problemi relativi al contenuto del tuo agente. Il messaggio di errore fornisce ulteriori dettagli.

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.

EnforcementMessageC2

Messaggio di chat: Questo agente non è attualmente disponibile. Ha raggiunto il limite di utilizzo. Riprova più tardi.

Questo messaggio viene creato in queste condizioni documentate: Limite di eccedenza.

Risoluzione:

• Aggiungere una capacità prepagata o creare un piano di fatturazione con pagamento in base al consumo. Entro 5 minuti la chat dell'agente funzionerà di nuovo.

DataLossPreventionViolation

Messaggio di errore: Questo ambiente richiede agli utenti di accedere prima di poter usare l'agente. Passare a Gestisci > autenticazione di sicurezza > e selezionare l'opzione che richiede 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 nell'agente non si trovano nello stesso gruppo di dati. Vedi Copilot Studioconnettori.
• Uno o più connettori utilizzati nell'agente sono stati bloccati dall'amministratore del tenant.

EnforcementMessageC2

Messaggio di errore: Questo agente non è attualmente disponibile. Ha raggiunto il limite di utilizzo. Riprova più tardi.

Risoluzione: Questo messaggio viene restituito quando un agente ha raggiunto la capacità del messaggio o il contatore con pagamento in base al consumo ha raggiunto il limite. Per altre informazioni, vedere Tariffe e gestione della fatturazione.

FlowActionException

Messaggi di errore:

• Nessun output ricevuto dal flusso {FlowName} ({FlowId}), anche se l'output era previsto in base alla definizione dell'agente.
• Il parametro di output con nome {ItemKey} nel flusso {FlowName} ({FlowId}) non è presente nei dati della risposta. Aggiornare il flusso o assicurarsi che il flusso restituisca questo valore.
• Il parametro di output con nome {ItemKey} nel flusso {FlowName} ({FlowId}) non è presente nello schema di output. Aggiorna il flusso.

Risoluzione:verifica la presenza di errori nel flusso.

FlowActionBadRequest

Messaggi di errore:

• Il parametro con nome {KeyName} nel flusso {FlowName} ({FlowId}) viene dichiarato come di tipo {ItemTypeKind}. Questo tipo non è supportato quando si invoca Power Automate. Attualmente sono supportati solo Text, Boolean e Numbers.
• Il parametro con nome {ItemKey} nel flusso {FlowName} ({FlowId}) non è presente nell'azione 'Call Flow'.
• Il parametro con nome {KeyName} nel flusso {FlowName} ({FlowId}) è stato valutato come tipo {ResolveType}, mentre il tipo previsto era {ExpectedType}.
• Impossibile eseguire il flusso {FlowName} ({FlowId}) con codice di risposta {ResponseCode}, codice errore: {FlowErrorCode}.

Risoluzione: controlla che il tipo di base di qualsiasi variabile passata al flusso corrisponde al tipo di parametro.

FlowActionTimedOut

Messaggio di errore: Timeout del flusso con ID {FlowId}. Codice errore: {FlowErrorCode}

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

GenAISearchandSummarizeRateLimitReached

Messaggio di errore: È stato raggiunto il limite di utilizzo per la ricerca e il riepilogo. Riprova più tardi.

Risoluzione: Questo messaggio viene restituito quando l'agente raggiunge il limite di intelligenza artificiale generativa per cercare e riepilogare le origini.

GenAIToolPlannerRateLimitReached

Messaggio di errore: È stato raggiunto il limite di utilizzo per l'orchestrazione generativa. Riprova più tardi.

Risoluzione: Questo messaggio viene restituito quando l'agente raggiunge il limite di orchestrazione generativa.

ContenutoNonValido

Messaggio di errore: Un totale di {TotalComponents} componenti esiste nell'agente, ma nessuno è valido.

Risoluzione:Apri l'editor di codice per rivedere i problemi con il contenuto.

InfiniteLoopInBotContent

Messaggio di errore: Azione {DialogId}. {TriggerId}. {ActionId} è stato eseguito più di {MaxTurnCount} volte in una riga. Indica un ciclo di esecuzione del dialogo e quindi l'esecuzione del dialogo verrà terminata.

Risoluzione: assicurati che l'argomento termini correttamente e che i collegamenti ad altri argomenti terminino correttamente, come l'argomento di sistema Riassegna.

LatestPublishedVersionNotFound

Messaggio di errore: Impossibile recuperare la versione pubblicata più recente dell'agente.

Risoluzione:Pubblicazione dell'agente.

OutgoingMessageSizeTooBig

Messaggio di errore: Dimensioni del messaggio in uscita troppo grandi.

Risoluzione: esaminare i nodi per assicurarsi che nessuno di essi utilizzi una variabile che contiene un volume elevato di testo, ad esempio un metodo statico JSON.stringify(). Se usi questo metodo o una variabile che contiene una grande quantità di testo, modifica il nodo in modo che passi solo la parte di testo necessaria. Ad esempio, se usi una scheda adattiva per passare dati a un altro argomento, aggiorna la variabile in modo che passi solo la proprietà necessaria.

Per ulteriori informazioni, vedi Limiti delle dimensioni massime per i messaggi di dati del canale durante l'utilizzo di Copilot Studio in Multicanale.

OpenAIRateLimitReached

Messaggio di errore: Si è verificato un errore.

Risoluzione: è stato raggiunto il numero massimo di risposte generative dall'agente. Rivedi la capacità di messaggi e apri una richiesta di supporto per aumentare il limite di frequenza delle risposte generative.

RedirectToDisabledDialog

Messaggio di errore: La finestra di dialogo con ID {DialogId} è disabilitata nella definizione. Abilitare la finestra di dialogo prima di usarla.

Risoluzione:Abilita nuovamente l'argomento o rimuovi il nodo di reindirizzamento.

RedirectToNonExistentDialog

Messaggio di errore: La finestra di dialogo con ID {DialogId} non è stata trovata nella definizione. Verificare che la finestra di dialogo sia presente e che l'ID sia corretto.

Risoluzione:crea un nuovo argomento a cui reindirizzare o rimuovi il nodo di reindirizzamento.

Errore di Sistema

Messaggio di errore: questo errore non genera un messaggio di errore.

Risoluzione:Contatta il supporto clienti.

TooMuchDataToHandle

Messaggio di errore: La richiesta comporta una quantità eccessiva di dati da gestire, valutare la quantità di dati restituiti dalle azioni.

Risoluzione: indica che la richiesta inviata a OpenAI sta superando la dimensione massima consentita per la richiesta. La richiesta comprende diversi elementi, tra cui l'input dell'utente, l'output delle azioni precedenti, gli strumenti chiamati e la cronologia delle conversazioni. Esamina gli strumenti in uso e, ove possibile, riduci l'ambito dell'output solo ai campi necessari. Per altre informazioni, vedere Creare un flusso di Power Automate e Chiamare un flusso di Power Automate come azione.

Classici/Teams

Errore	Risposta del bot	Risoluzione
2000	"L'utente è sottoposto a trapping in un ciclo infinito. Verifica che {Topic Name} raggiunga una conclusione logica."	Assicurati che l'argomento termini correttamente o che i collegamenti ad altri argomenti terminino correttamente, come l'argomento di sistema Esegui escalation.
2001	"Il contenuto del bot non è valido."	Controlla l'argomento per 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."	Verifica la presenza di errori nel flusso e cerca le 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. Controllare sia [la competenza][8] che l'argomento per individuare gli errori.
2005	"Si è verificato un problema." Controlla il contenuto."	Si è verificato un problema con il modello di flusso Power Automate. Controlla il flusso per 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, vedi 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, vedi 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. Leggi di più su quote e limiti di 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.
2024	"Questo ambiente richiede agli utenti di accedere prima di poter utilizzare il bot. Vai a Gestisci > sicurezza > Autenticazione e seleziona l'opzione che richiede agli utenti di accedere".	I criteri di prevenzione della perdita dei dati (DLP) del tuo ambiente richiedono che gli utenti effettuino l'accesso. Per informazioni su come richiedere agli utenti di accedere, vedi Configurare l'autenticazione dell'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. Attiva l'altro argomento o rimuovi 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 per reindirizzare o rimuovi il nodo di reindirizzamento.
2026	"Si è verificato un problema con il flusso Power Automate. Controlla il contenuto."	Controlla il flusso per errori.
2030	"Controlla la cronologia di esecuzione del flusso di Power Automate e assicurati che il flusso sia stato eseguito correttamente".
2100(solo Teams)	"L'utente sta digitando troppo rapidamente."	Le interazioni con il bot sono limitate per mitigare lo spam. Riprova digitando più lentamente.
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. Contatta il supporto clienti per altri dettagli.
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.