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
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. |
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 è un errore generico 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 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:
- 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 bloccati dall'amministratore del tenant.
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 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: 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.
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.