Condividi tramite


Comprendere i codici di errore

Importante

Le capacità e funzionalità di Power Virtual Agents ora fanno parte di Microsoft Copilot Studio a seguito di investimenti significativi nell'intelligenza artificiale generativa e integrazioni migliorate in Microsoft Copilot.

Alcuni articoli e schermate potrebbero fare riferimento a Power Virtual Agents durante l'aggiornamento della documentazione e dei contenuti per il training.

Quando un copilota riscontra un problema durante una conversazione, risponde con un messaggio che include un codice di errore per il problema specifico riscontrato. Gli utenti del copilota dovrebbero fornire questo codice di errore al proprio amministratore.

In qualità di creatore di copiloti, se si verifica un problema quando utilizzi il riquadro di test per testare il tuo copilota, puoi visualizzare un messaggio con più contesto sul problema, oltre al codice di errore. In alternativa, puoi utilizzare il riquadro Verifica argomento per convalidare il tuo copilota.

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 del copilota.
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 Microsoft Copilot Studio.

ContentError

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

Soluzione: questo è un errore generico per problemi relativi al contenuto del tuo copilota. Per ulteriori informazioni, fai riferimento al messaggio di errore.

I problemi comuni includono:

DataLossPreventionViolation

Messaggio di errore: "Questo ambiente richiede agli utenti di accedere prima di poter utilizzare il copilota. 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 Configurare autenticazione utente finale.
  • Uno o più connettori utilizzati nel copilota non si trovano nello stesso gruppo di dati. Vedi Microsoft Copilot Studioconnettori.
  • Uno o più connettori utilizzati nel copilota sono bloccati dall'amministratore del tenant.

FlowActionException

Messaggi di errore:

  • "Non è stato ricevuto alcun output dal flusso {FlowName} ({FlowId}), anche se l'output era previsto secondo la definizione del copilota".
  • "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}"

Soluzione:controlla la presenza di errori nel flusso per capire perché il flusso cloud ha impiegato più di 100 secondi per essere eseguito prima di tornare al copilota. Prova a ottimizzare la query e i dati restituiti dal sistema di back-end. Se parte della logica del flusso cloud può continuare a essere eseguita dopo che un risultato è stato inviato al copilota, inserisci queste azioni dopo il passaggio "Restituisci valori a Microsoft Copilot Studio" nel flusso cloud.

InvalidContent

Messaggio di errore: "Nel copilota esiste un totale di {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 del copilota".

Risoluzione:Pubblicazione e condivisione del copilota.

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.