Condividi tramite

Comprendere i codici di errore

  • Articolo

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

Nota

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

Codice errore Descrzione
ContentError Si è verificato un errore nel contenuto dell'argomento.
DataLossPreventionViolation C'è stata una violazione dei criteri di prevenzione della perdita dei dati.
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.
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.
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.

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. Per ulteriori dettagli, fare riferimento al messaggio di errore.

I problemi comuni includono:

DataLossPreventionViolation

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

Risoluzione:

FlowActionException

Messaggi di errore:

  • "Non è stato ricevuto alcun output dal flusso {FlowName} ({FlowId}), nonostante l'output fosse previsto in base alla definizione dell'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:verifica la presenza di errori nel flusso.

FlowActionBadRequest

Messaggi di errore:

  • "Il parametro con nome {KeyName} sul flusso {FlowName} ({FlowId}) è dichiarato di tipo {ItemTypeKind}. Questo tipo non è supportato quando si invoca 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: controlla che il tipo di base di qualsiasi variabile passata al flusso corrisponde al tipo di parametro.

FlowActionTimedOut

Messaggio di errore: "Il flusso con ID {FlowId} è scaduto. 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.

InvalidContent

Messaggio di errore: "Nell'agente sono presenti in totale {TotalComponents} componenti, ma nessuno è valido."

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

InfiniteLoopInBotContent

Messaggio di errore: "L'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 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 l'ultima versione pubblicata 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 viene usato quel tipo di metodo o viene usata un'altra variabile che contiene un volume elevato 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. 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. Abilita la finestra di dialogo prima di utilizzarla."

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. Verifica 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.

SystemError

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

Risoluzione:Contatta il supporto clienti.