Informazioni sui codici di errore

Quando un agente rileva un problema durante una conversazione, risponde inviando un messaggio che include un codice di errore per il problema specifico. Gli utenti dell'agente devono comunicare questo codice di errore al proprio amministratore.

In qualità di autore dell'agente, se si verifica un problema quando si usa il riquadro di test per testare l'agente, viene visualizzato un messaggio che contiene il codice di errore e un contesto maggiore sul problema. In alternativa, è possibile usare il pannello Controllo argomenti per convalidare la configurazione dell'agente.

Elenco errori

Annotazioni

Il termine dialogo viene usato in alcuni messaggi di errore per fare riferimento a un argomento.

Codice di errore Description
AIModelActionBadRequest Esiste un'incongruenza tra i tipi di azione richiesta.
AIModelActionRequestTimeout Si è verificato un errore di timeout correlato a una chiamata a un modello di AI Builder.
AIPluginOperationNotFound Si verifica un errore durante il tentativo di accesso a un agente connesso.
AsyncResponsePayloadTooLarge Si è verificato un errore correlato all'output di un connettore.
AutenticazioneNonConfigurata L'autenticazione è obbligatoria ma non è stata configurata.
BindingKeyNotFoundError Uno o più input modificati nel flusso dell'agente (aggiunti, rimossi o rinominati). Il flusso dell'agente deve essere rimosso e aggiunto nuovamente per garantire che Copilot Studio abbia l'elenco corretto degli input.
BingSearchFailed Si è verificato un problema di sistema durante la ricerca delle informazioni di Bing.
ConnectedAgentAuthMismatch C'è un'incongruenza di autenticazione tra l'orchestrator e il subagente.
ConnectedAgentBotNotFound Non è stato trovato un subagente in una configurazione di orchestrazione multi-agente.
ConnectedAgentBotNotPublished Non è stato pubblicato un subagente in una configurazione di orchestrazione multiagente.
ConnectedAgentChainingNotSupported Il concatenamento di agenti a più livelli non è supportato.
ConnectedAgentGptComponentNotFound Un agente connesso manca delle descrizioni o istruzioni.
ConnectorPowerFxError Si è verificato un errore nella valutazione dell'espressione Power Fx nelle azioni del connettore.
ConsensoNonFornitoDallUtente Un utente che interagisce con un agente ha rifiutato la richiesta single sign-on (SSO) dell'agente.
ContentError Si è verificato un errore nel contenuto dell'argomento.
ConversationStateTooLarge Lo stato della conversazione supera i limiti di dimensione.
DataLossPreventionViolation Esiste una violazione dei criteri di dati.
DataverseFileAttachment429 SharePoint ha limitato la ricerca degli allegati di file di Dataverse.
DataverseSearchFailed Si è verificato un problema di sistema durante la ricerca della conoscenza di Dataverse.
DataverseStructured401 La ricerca strutturata dataverse ha restituito un errore di autenticazione.
DataverseStructured429 La ricerca strutturata di Dataverse è stata soggetta a limitazione.
DataverseStructured500 La ricerca strutturata dataverse ha restituito un errore interno del server.
DataverseStructured503 La ricerca strutturata di Dataverse non era disponibile.
EnforcementMessageC2 La capacità prepagata non è sufficiente.
Executiontimeout Un'azione dello strumento o del flusso ha superato il timeout di esecuzione configurato.
FlowActionBadRequest Una richiesta inviata a un flusso dell'agente è malformata.
FlowActionException Si è verificato un errore durante l'esecuzione di un flusso dell'agente.
FlowActionTimedOut Un flusso agente ha richiesto più di 100 secondi per l'esecuzione e il timeout.
FlowMakerConnectionBlocked Un flusso agente è stato richiamato con credenziali di autore non autorizzate nella connessione.
FoundryIQSearchFailed Si è verificato un problema di sistema durante la ricerca nella knowledge base di Foundry IQ.
GenAISearchandSummarizeRateLimitReached È stato raggiunto il limite di utilizzo per l'intelligenza artificiale generativa.
GenAIToolPlannerRateLimitReached È stato raggiunto il limite di utilizzo per l'orchestrazione generativa.
HTTP400BadRequest Una chiamata allo strumento non è riuscita perché la sintassi della richiesta o i parametri non sono validi.
HTTP401Unauthorized Una chiamata dello strumento non è riuscita perché le credenziali di autenticazione sono mancanti o scadute.
HTTP403Forbidden Una chiamata allo strumento non è riuscita perché il chiamante è autenticato ma non dispone dell'autorizzazione per accedere alla risorsa.
HTTP404NotFound Chiamata allo strumento non riuscita perché la risorsa richiesta non esiste.
HTTP408RequestTimeout Una chiamata allo strumento non è riuscita perché la richiesta ha superato i limiti di tempo consentiti.
HTTP422UnprocessableEntity Una chiamata allo strumento non è riuscita perché la richiesta era ben formata ma conteneva errori di convalida semantica.
HTTP429TooManyRequests Una chiamata allo strumento non è riuscita perché la frequenza delle richieste ha superato i limiti del servizio.
HTTP500InternalServerError Chiamata allo strumento non riuscita perché il servizio ha rilevato un errore interno imprevisto.
HTTP502BadGateway Chiamata dello strumento non riuscita perché un servizio upstream ha restituito una risposta non valida.
HTTP503ServiceUnavailable Una chiamata allo strumento non è riuscita perché il servizio non è temporaneamente disponibile.
HTTP504GatewayTimeout Chiamata allo strumento non riuscita perché il servizio upstream non ha risposto in tempo.
InfiniteLoopInBotContent Un nodo è stato eseguito troppe volte.
InvalidAuthenticationToken Una chiamata allo strumento non è riuscita perché il formato del token di accesso non è valido o danneggiato.
InvalidContent Contenuto non valido è stato aggiunto all'editor di codice.
LatestPublishedVersionNotFound Impossibile recuperare la versione pubblicata dell'agente.
MsalUiException Una chiamata allo strumento non è riuscita perché è necessario l'accesso interattivo per acquisire un token.
OpenAIHate È stato rilevato contenuto di odio.
OpenAIJailBreak È stato rilevato il contenuto di Jailbreak.
OpenAIndirectAttack È stato rilevato contenuto di attacco indiretto.
OpenAIRateLimitReached È stato raggiunto il limite di capacità dell'agente.
OpenAISelfHarm È stato rilevato contenuto autolesionistico.
OpenAISexual È stato rilevato contenuto sessuale.
OpenAIViolence È stato rilevato contenuto di violenza.
OperationTimeout Un'operazione specifica dello strumento ha superato il tempo limite prima di essere completata.
OutgoingMessageSizeTooBig Un messaggio inviato da un agente era troppo grande da elaborare.
QuotaExceeded Una chiamata di strumento non è riuscita perché sono stati superati i limiti di quota mensile, giornaliera o di concorrenza.
RedirectToDisabledDialog Un argomento è stato reindirizzato a un argomento disabilitato.
RedirectToNonExistentDialog Un argomento è stato reindirizzato a un altro argomento che non esiste più.
SharePoint429 SharePoint ricerca delle informazioni è stata limitata.
SharePoint500 La ricerca delle informazioni di SharePoint ha restituito un errore interno del server.
SharePoint503 La ricerca delle conoscenze di SharePoint non era disponibile.
SharePointSearchFailed Si è verificato un problema di sistema durante la ricerca di informazioni SharePoint.
SystemError Si è verificato un errore di sistema in Copilot Studio.
TooMuchDataToHandle La richiesta effettuata dall'utente è troppo grande da elaborare.

RichiestaErrataAzioneModelloAI

Messaggi di errore:

  • L'output del prompt è risultato essere {ActualType}, ma era atteso {ExpectedType}.

  • Il parametro di input {ParameterName} per il prompt {PromptName} è mancante.

  • Il parametro {ParameterName} di input per prompt {PromptName} è vuoto, ma è obbligatorio.

  • Previsto: {ExpectedType}. Attuale: {ActualType}.

Risoluzione: Questo errore si verifica se un'azione di richiesta riceve un input non corretto o restituisce tipi di output imprevisti. Per risolvere il problema, eseguire una delle azioni seguenti, in base all'errore:

  • Mancata corrispondenza del tipo: Controllare la configurazione del prompt per assicurarsi che lo schema di output corrisponda al tipo di variabile previsto.
  • Input obbligatorio mancante: Verificare che tutti gli input necessari siano connessi alle variabili con valori.
  • Valore obbligatorio vuoto: Assicurarsi che la variabile abbia un valore prima di chiamare il prompt.

Per altre informazioni, vedere Creare un'azione di richiesta.

AIModelActionRequestTimeout

Messaggio di errore: timeout dell'esecuzione della richiesta prompt-name .

Soluzione: assicurarsi che la chiamata al modello di AI Builder non superi i 100 secondi.

AIPluginOperationNotFound

Messaggio di errore: Il bot non può parlare per un po'. È qualcosa che il proprietario del bot deve affrontare.

Soluzione: ripubblicare l'agente. Questo errore può verificarsi quando un agente viene pubblicato tramite un'importazione o una distribuzione di una soluzione.

AsyncResponsePayloadTooLarge

Messaggio di errore: l'output restituito dal connettore è 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.

Soluzione: 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.

AutenticazioneNonConfigurata

Messaggi di errore:

  • L'autenticazione non è configurata per questo bot.

  • Il bot richiede l'accesso, ma non è configurato per l'autenticazione. Aggiornare il metodo di autenticazione per il bot.

  • L'autenticazione integrata non è supportata nel canale {channel}.

Risoluzione: Questo errore si verifica se l'agente usa azioni o funzionalità che richiedono l'autenticazione utente, ma l'autenticazione non è configurata. Per risolvere il problema:

  1. Nell'agente passare a Impostazioni > Autenticazione di sicurezza>.
  2. Selezionare un metodo di autenticazione appropriato: eseguire l'autenticazione con Microsoft per gli utenti di Microsoft 365 o Autenticare manualmente per i provider OAuth personalizzati.
  3. Se l'errore indica un canale specifico, verificare che il canale supporti il metodo di autenticazione in uso. Alcuni canali non supportano l'autenticazione integrata.

Per altre informazioni, vedere Configurare l'autenticazione utente.

BindingKeyNotFoundError

Messaggi di errore:

  • Il binding '{0}' non è stato trovato, aggiorna questo flusso per ottenere i binding più recenti.
  • Il binding di input '{0}' non è stato trovato, aggiorna questo flusso per ottenere i binding più recenti.
  • L'associazione di output '{0}' non è stata trovata, aggiorna questo flusso per ottenere le associazioni più recenti

Soluzione: verificare che gli input e gli output del flusso dell'agente siano configurati correttamente. Provare ad aggiornare gli input o gli output per risolvere questo problema. In caso contrario, provare a configurare nuovamente il flusso dell'agente.

Per ottenere gli input e gli output più recenti, rimuovere e leggere il flusso dell'agente.

BingSearchFailed

Messaggio di errore: Si tratta di un problema di sistema da parte nostra. Niente di cui hai bisogno per risolvere il problema. Dettagli dell'errore: runtime della piattaforma - BingSearchFailed.

Risoluzione: un errore di ricerca Bing sul lato piattaforma può causare questo problema. Riprovare in un secondo momento. Se il problema persiste, contattare il supporto tecnico.

Incongruenza di Autenticazione Agente Connesso

Messaggio di errore: L'agente connesso con il nome {AgentSchemaName} dello schema ha una mancata corrispondenza dell'autenticazione con l'agente principale.

Risoluzione: L'agente di orchestrazione e il subagente connesso hanno configurazioni di autenticazione diverse. Per il funzionamento dell'orchestrazione multi-agente, entrambi gli agenti devono usare impostazioni di autenticazione compatibili. Per risolvere il problema:

  1. Aprire entrambi gli agenti e passare a Impostazioni > Autenticazione di sicurezza>.
  2. Assicurarsi che entrambi gli agenti usino lo stesso metodo di autenticazione( ad esempio, entrambi usano Authenticate with Microsoft).
  3. Se si usa l'autenticazione manuale, assicurarsi che entrambi gli agenti siano configurati per l'uso dello stesso provider OAuth e delle stesse impostazioni.

Si applicano le regole di compatibilità di autenticazione seguenti:

  • Se l'agente connesso non ha configurato alcuna autenticazione , qualsiasi autenticazione dell'agente di orchestrazione è accettabile.
  • Se l'agente connesso richiede l'autenticazione, l'agente di orchestrazione deve usare lo stesso metodo di autenticazione.
  • L'autenticazione manuale (Generic OAuth2) nell'agente di orchestrazione non è compatibile con gli agenti connessi che richiedono l'autenticazione. Entrambi gli agenti devono usare la stessa configurazione di autenticazione manuale oppure l'agente connesso non deve avere requisiti di autenticazione.

Per altre informazioni, vedere Configurare l'autenticazione utente e Usare gli agenti come azioni in altri agenti (anteprima).

ConnectedAgentBotNotFound

Messaggio di errore: Impossibile trovare l'agente connesso con il nome dello schema {AgentSchemaName}.

Risoluzione: Questo errore si verifica nell'orchestrazione multi-agente se l'agente di orchestrazione non riesce a trovare un subagent connesso. Per risolvere il problema:

  1. Verificare che l'agente connesso esista nello stesso ambiente dell'agente di orchestrazione.
  2. Assicurarsi che il nome dello schema dell'agente connesso sia digitato correttamente nella configurazione dell'agente di orchestrazione.
  3. Verificare di disporre delle autorizzazioni di accesso all'agente connesso.
  4. Se l'agente connesso è stato creato di recente, attendere alcuni minuti e riprovare.

Per ulteriori informazioni, vedere Usare gli agenti come azioni in altri agenti (anteprima).

ConnectedAgentBotNotPublished

Messaggio di errore: L'agente connesso con il nome {AgentSchemaName} dello schema deve essere pubblicato per essere richiamato.

Risoluzione: Il subagente connesso deve essere pubblicato prima che l'agente orchestratore possa richiamarlo. Per risolvere il problema:

  1. Aprire l'agente connesso in Copilot Studio.
  2. Pubblicazione dell'agente.
  3. Ritorna all'agente di orchestrazione e riprova.

Per ulteriori informazioni, vedere Usare gli agenti come azioni in altri agenti (anteprima).

ConnectedAgentChainingNotSupported (Collegamento agente collegato non supportato)

Messaggio di errore: Rilevata catena di agenti. L'agente non può essere connesso all'agente con il nome {AgentSchemaName} dello schema perché dispone già di un agente connesso.

Risoluzione: Il concatenamento di agenti a più livelli non è supportato. Un agente orchestratore può collegarsi a dei subagenti, ma tali subagenti non possono avere agenti collegati. Per risolvere il problema:

  1. Esamina l'architettura dell'agente e appiattisci la gerarchia.
  2. Spostare la funzionalità dagli agenti profondamente annidati nell'orchestratore o negli agenti connessi di primo livello.
  3. Prendere in considerazione l'uso di argomenti o azioni invece di più agenti connessi.

Per ulteriori informazioni, vedere Usare gli agenti come azioni in altri agenti (anteprima).

ConnectedAgentGptComponentNotFound

Messaggio di errore: Nessun componente GPT trovato per l'agente connesso con il nome {AgentSchemaName}dello schema .

Risoluzione: L'agente connesso non contiene una descrizione o istruzioni necessarie. L'agente di orchestrazione deve sapere quando chiamare l'agente connesso. Per risolvere il problema:

  1. Aprire l'agente connesso in Copilot Studio.
  2. Vai alla pagina Panoramica dell'agente.
  3. Assicurarsi che l'agente abbia una descrizione e istruzioni chiare configurate.
  4. Dopo aver apportato modifiche, pubblicare l'agente connesso.
  5. Ritorna all'agente di orchestrazione e riprova.

Per ulteriori informazioni, vedere Usare gli agenti come azioni in altri agenti (anteprima).

ConnectorPowerFxError

Messaggio di errore: Valutazione dell'espressione Power Fx non riuscita: {ErrorDetails}

Risoluzione: Un'espressione Power Fx usata in un'azione connettore non è stata valutata correttamente. Per risolvere il problema:

  1. Apri l'argomento che contiene l'azione del connettore.
  2. Esaminare le espressioni Power Fx nei parametri di input dell'azione.
  3. Testare le espressioni usando dati di esempio per determinare il problema.
  4. Usare gli indicatori di errore della barra della formula per individuare problemi specifici.

Cause comuni includono:

  • Errori di sintassi.
  • Incongruenze di tipo, come il confronto tra testo e numeri senza conversione.
  • valori null o vuoti. Per la gestione, usare funzioni come IsBlank(), Coalesce()o IfError().
  • Utilizzo della funzione non valido.

Per altre informazioni, vedere Usare Power Fx in Copilot Studio.

ConsensoNonFornitoDallUtente

Messaggio di errore: nessun consenso fornito per la connessione SSO.

Soluzione: l'utente che interagisce con l'agente deve verificare la connessione usando il prompt della connessione Single Sign-On (SSO) dell'agente.

ContentError

Messaggio di errore: questo errore genera messaggi dinamici in base al contesto dell'errore.

Soluzione: Questo messaggio è un errore generico per i problemi correlati al contenuto dell'agente. Il messaggio di errore fornisce ulteriori dettagli.

I problemi comuni includono:

ConversationStateTooLarge

Messaggio di errore: Le dimensioni dello stato della conversazione superano il limite massimo consentito.

Risoluzione: La conversazione accumula troppi dati nello stato, superando i limiti di dimensione consentiti. Per risolvere il problema:

  1. Riduci i dati delle variabili esaminando i temi e riducendo la quantità di dati memorizzati nelle variabili nel corso della conversazione.
  2. Cancellare le variabili inutilizzate impostandole su blank se non sono più necessarie.
  3. Semplificare i flussi di conversazione suddividendo le conversazioni complesse in interazioni più piccole e più incentrate.
  4. Evitare di archiviare oggetti JSON di grandi dimensioni, matrici o blocchi di testo nelle variabili di conversazione.

Per evitare questo errore:

  • Usare le variabili solo per i dati che è necessario rendere persistenti tra gli argomenti.
  • È consigliabile usare i flussi di Power Automate per archiviare e recuperare dati di grandi dimensioni da origini esterne anziché mantenerli nello stato della conversazione.

Per altre informazioni, vedere Quote e limiti di Copilot Studio.

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.

Resolution

DataverseFileAttachment429

Error message: SharePoint limita le richieste al momento. Riprova più tardi. Dettagli errore: DataverseFiles429.

Risoluzione: la limitazione del servizio può causare questo errore. Attendere e riprovare.

DataverseSearchFailed

Messaggio di errore: si tratta di un problema di sistema da parte nostra. Niente di cui hai bisogno per risolvere il problema. Dettagli errore: runtime della piattaforma - DataverseSearchFailed.

Risoluzione: gli errori di ricerca delle informazioni di Dataverse, ad esempio gli errori di connessione utente, possono causare questo problema. Per risolvere il problema:

  1. Apri le impostazioni dell'origine della conoscenza dell'agente e autentica di nuovo la connessione Dataverse.
  2. Verifica che l'utente disponga di licenze e autorizzazioni valide per l'origine dati della knowledge di Dataverse.
  3. Se il problema persiste dopo la riautenticazione, contattare il supporto tecnico.

DataverseStructured401

Messaggio di errore: la ricerca ha riscontrato un problema di autenticazione. Questo in genere si risolve autonomamente. Non c’è nulla da correggere da parte tua. Dettagli errore: Dataverse401.

Soluzione: questo errore può indicare autorizzazioni mancanti per l'identità o l'account utente dell'agente. Per risolvere il problema:

  1. Concedi al service principal dell'agente le autorizzazioni necessarie per la ricerca nella Knowledge Base di Dataverse.
  2. Verificare che l'ambiente dell'origine delle informazioni corrisponda all'ambiente dell'agente.
  3. Riprovare dopo gli aggiornamenti delle autorizzazioni.

Per altre informazioni, vedere Risolvere i problemi relativi alle origini delle informazioni aziendali.

DataverseStructured429

Messaggio di errore: Dataverse limita le richieste al momento. Riprova più tardi. Dettagli dell'errore: Dataverse429.

Risoluzione: il servizio ha subito una limitazione o è andato in timeout. Per ridurre il ripetersi del problema:

  1. Riprovare con il backoff esponenziale.
  2. Ridurre le dimensioni dell'origine delle informazioni, se possibile.
  3. Distribuire carichi di query di grandi dimensioni nel tempo.

Per altre informazioni, vedi le linee guida di Microsoft Graph per il throttling.

DataverseStructured500

Messaggio di errore: questo non è un problema di configurazione. Il servizio responsabile deve eseguire delle verifiche. Dettagli dell'errore: Dataverse500.

Risoluzione: un problema sul lato servizio può causare questo errore. Riprovare in un secondo momento. Se il problema persiste, contattare il supporto tecnico.

DataverseStructured503

Messaggio di errore: questo non è un problema di configurazione. Il servizio responsabile deve indagare. Dettagli dell'errore: Dataverse503.

Soluzione: la mancata disponibilità temporanea del servizio può causare questo errore. Riprovare in un secondo momento.

EnforcementMessageC2

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

Soluzione: questo messaggio viene visualizzato se un agente raggiunge la capacità del messaggio o il contatore con pagamento in base al consumo raggiunge il limite. Per risolvere il problema, aggiungere una capacità prepagata o creare un piano di fatturazione con pagamento in base al consumo. La chat dell'agente dovrebbe quindi riprendere a lavorare entro cinque minuti. Per altre informazioni, vedere Applicazione dell'eccedenza.

ExecutionTimeout

Messaggio di errore: timeout della chiamata dello strumento. Il completamento dell'operazione richiede troppo tempo. Dettagli dell'errore: Timeout · esecuzione.

Risoluzione: i percorsi di esecuzione di lunga durata possono causare questo errore. Per risolvere il problema:

  1. Suddividere flussi di lavoro di grandi dimensioni in passaggi più piccoli.
  2. Ottimizzare la logica di query e trasformazione.
  3. Rimuovere le azioni non necessarie dal percorso critico.
  4. Verificare i cicli e le condizioni di ramificazione per individuare eventuali inefficienze.

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: verificare che il tipo di base di tutte le variabili passate al flusso corrisponda al tipo di parametro. Per altre informazioni, vedere Errore dell'agente FlowActionBadRequest nei canali

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: controllare la presenza di errori nel flusso.

FlowActionTimedOut

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

Soluzione: Verificare la presenza di errori nel flusso così da comprendere il motivo per cui il flusso cloud ha impiegato più di 100 secondi prima di tornare all'agente. Provare a ottimizzare la query e i dati restituiti dal sistema back-end. Se una parte della logica del flusso cloud può continuare a essere eseguita dopo l'invio di un risultato all'agente, inserire queste azioni dopo il passaggio "Restituisci valori in Copilot Studio" nel flusso cloud.

Connessione Di FlowMaker Bloccata

Messaggio di errore: il flusso con nome {FlowName} usa una connessione maker, che non è consentita. Codice errore: {FlowMakerConnectionBlocked}

Soluzione: l'amministratore impedisce l'uso delle credenziali di autore in una connessione richiamata dal flusso dell'agente. Aprire il flusso in Power Automate e condividere il flusso cloud usando autorizzazioni di sola esecuzione.

FoundryIQSearchFailed

Messaggio di errore: Si tratta di un problema di sistema da parte nostra. Niente di cui hai bisogno per risolvere il problema. Dettagli dell'errore: runtime di piattaforma - FoundryIQSearchFailed.

Soluzione: questo problema può essere causato da un errore della funzione di ricerca di Foundry IQ a livello di piattaforma. Riprovare in un secondo momento. Se il problema persiste, contattare il supporto tecnico.

GenAISearchandSummarizeRateLimitReached

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

Soluzione: l'agente restituisce questo messaggio se raggiunge il limite di intelligenza artificiale generativo per cercare e riepilogare le origini. Per altre informazioni, vedere Risolvere gli errori di throttling negli agenti.

GenAIToolPlannerRateLimitReached

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

Soluzione: l'agente restituisce questo messaggio se raggiunge il limite di orchestrazione generativo. Per altre informazioni, vedere Risolvere gli errori di throttling negli agenti.

HTTP400BadRequest

Messaggio di errore: Richiesta non valida.

Risoluzione: i payload non validi o i parametri non validi possono causare questo errore. Per risolvere il problema:

  1. Verificare che siano presenti tutti i parametri obbligatori.
  2. Verificare che i tipi di dati corrispondano allo schema dell'azione.
  3. Eseguire il test con dati di esempio noti come validi.
  4. Convalidare la formattazione JSON per payload complessi.

HTTP401Non autorizzato

Messaggio di errore: Non autorizzato.

Soluzione: questo errore può essere causato da credenziali di autenticazione mancanti o scadute. Per risolvere il problema:

  1. Verificare che il connettore sia configurato correttamente in Copilot Studio.
  2. Controllare se il token OAuth è scaduto e ripetere l'autenticazione della connessione.
  3. Convalidare la chiave API o le impostazioni di connessione.
  4. Testare la connessione prima della distribuzione.
  5. Se si usa l'autenticazione del service principal, verificare che le credenziali non siano state modificate.

HTTP 403 Vietato

Messaggio di errore: Accesso negato.

Soluzione: questo errore può essere causato da autorizzazioni mancanti nel sistema di destinazione. Per risolvere il problema:

  1. Verificare che l'utente o l'app disponga dei ruoli e delle autorizzazioni necessari.
  2. Controllare le autorizzazioni di registrazione delle app e i requisiti di consenso amministratore.
  3. Verificare le impostazioni di condivisione e delega a livello di risorsa.
  4. Verificare che la definizione dell'ambito del tenant e dell'ambiente sia corretta.

HTTP404NotFound

Messaggio di errore: Non trovato.

Risoluzione: gli identificatori di risorsa mancanti o non corretti possono causare questo errore. Per risolvere il problema:

  1. Verificare che l'ID risorsa o l'URL sia corretto.
  2. Verificare che la risorsa esista ancora.
  3. Verificare che l'ambiente e il tenant selezionato siano corretti.
  4. Preferisci la selezione dinamica delle risorse anziché gli ID digitati manualmente.

HTTP408RequestTimeout

Messaggio di errore: timeout della chiamata dello strumento. Il completamento dell'operazione richiede troppo tempo. Dettagli dell'errore: Timeout · esecuzione.

Risoluzione: il superamento dei limiti di tempo di rete o client può causare questo errore. Per risolvere il problema:

  1. Controllare la stabilità e la latenza di rete.
  2. Ridurre le dimensioni del payload, se possibile.
  3. Aggiungere nuovi tentativi con backoff incrementale.
  4. Usare modelli asincroni per le operazioni a esecuzione prolungata.

HTTP422UnprocessableEntity

Messaggio di errore: Entità non elaborabile.

Risoluzione: gli errori di convalida semantica possono causare questo errore. Per risolvere il problema:

  1. Convalidare i formati a livello di campo e i valori consentiti.
  2. Aggiungere la convalida dei dati prima della chiamata allo strumento.
  3. Controllare i vincoli delle regole aziendali.
  4. Riprovare con dati di esempio validi noti.

HTTP429TooManyRequests

Messaggio di errore: Troppe richieste.

Risoluzione: I limiti di limitazione della velocità possono causare questo errore. Per risolvere il problema:

  1. Aggiungere ritardi tra le chiamate.
  2. Implementare tentativi di backoff esponenziali.
  3. Limitare la concorrenza per le operazioni batch.
  4. Rispettare le intestazioni Retry-After se presenti.
  5. Monitora l'utilizzo e la limitazione della frequenza in Analisi.

HTTP 500 Errore interno del server

Messaggio di errore: questo strumento non è temporaneamente disponibile. Il servizio non ha risposto o non è attualmente disponibile. Dettagli dell’errore: Disponibilità del servizio · 5xx.

Risoluzione: un problema sul lato servizio può causare questo errore. Per risolvere il problema:

  1. Ripetere la richiesta perché gli errori temporanei sono comuni.
  2. Controllare i dashboard sullo stato di integrità dei connettori e dei servizi per individuare eventuali incidenti attivi.
  3. Aggiungere un criterio di ripetizione dei tentativi con backoff esponenziale.
  4. Se il problema persiste, raccogliere i dettagli relativi al timestamp e alla correlazione della richiesta e contattare il supporto tecnico.

HTTP502BadGateway

Messaggio di errore: questo strumento non è temporaneamente disponibile. Il servizio non ha risposto o non è attualmente disponibile. Dettagli dell'errore: Disponibilità del servizio · 5xx.

Soluzione: le risposte non valide dalle dipendenze upstream possono causare questo errore. Per risolvere il problema:

  1. Attendere e riprovare dopo un breve ritardo.
  2. Convalidare l'URL dell'endpoint e la configurazione del connettore.
  3. Aggiungere nuovi tentativi con backoff esponenziale.
  4. Se il problema persiste, controllare le pagine di stato del fornitore e la documentazione del connettore.

HTTP503ServiceUnavailable

Messaggio di errore: questo strumento non è temporaneamente disponibile. Il servizio non ha risposto o non è attualmente disponibile. Dettagli dell'errore: Disponibilità del servizio · 5xx.

Soluzione: questo errore può essere causato da interruzioni o overload temporanei del servizio. Per risolvere il problema:

  1. Riprovare più tardi con un backoff più lungo.
  2. Verifica lo stato del servizio per controllare eventuali interventi di manutenzione pianificata o incidenti.
  3. Rinviare le operazioni non critiche fino a quando il servizio non si stabilizza.
  4. Implementare controlli di tipo circuit breaker per fallimenti ripetuti.

HTTP504GatewayTimeout

Messaggio di errore: questo strumento non è temporaneamente disponibile. Il servizio non ha risposto o non è attualmente disponibile. Dettagli dell'errore: Disponibilità del servizio · 5xx.

Risoluzione: l'elaborazione upstream lenta o la latenza di rete può causare questo errore. Per risolvere il problema:

  1. Ripetere l'operazione e verificare se il servizio back-end ha completato il lavoro nonostante il timeout.
  2. Ridurre le dimensioni del payload e ottimizzare le query costose.
  3. Suddividere le operazioni di grandi dimensioni in batch più piccoli.
  4. Aumentare il timeout configurato, se supportato.

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.

Soluzione: assicurarsi che l'argomento termini correttamente e si colleghi ad altri argomenti che terminano correttamente, come l'argomento del sistema Escalate.

InvalidAuthenticationToken (Token di autenticazione non valido)

Messaggio di errore: InvalidAuthenticationToken.

Soluzione: Dati del token non validi o obsoleti possono causare questo errore. Per risolvere il problema:

  1. Rimuovere e ricreare la connessione.
  2. Ripetere l'autenticazione del connettore.
  3. Cancellare il browser o la cache dell'app, se applicabile.
  4. Riprova il flusso.

InvalidContent

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

Soluzione: aprire l'editor di codice per esaminare i problemi che influiscono sul contenuto.

LatestPublishedVersionNotFound

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

Risoluzione: Pubblicare l'agente.

MsalUiException

Messaggio di errore: MsalUiException.

Soluzione: questo errore può essere causato quando l'acquisizione di token invisibile all'utente ha esito negativo e è necessario l'accesso interattivo. Per risolvere il problema:

  1. Disconnettiti, quindi accedi nuovamente per aggiornare il token.
  2. Completare tutte le richieste di autenticazione interattive.
  3. Riprovare a chiamare lo strumento al termine dell'autenticazione.

OpenAIHate

Messaggio di errore: il contenuto è stato filtrato a causa di restrizioni di intelligenza artificiale responsabile.

Un controllo di intelligenza artificiale responsabile blocca il contenuto considerato odioso. Il contenuto odioso si riferisce a qualsiasi contenuto che attacca o usa una lingua discriminatoria contro una persona o un gruppo di identità in base a determinati attributi di differenziazione di questi gruppi.

Questa restrizione include, ma non è limitata ai contenuti relativi a:

  • Razza, etnia, nazionalità
  • Gruppi ed espressione dell’identità di genere
  • Orientamento sessuale
  • Religione
  • Aspetto personale e dimensioni del corpo
  • Stato di disabilità
  • Molestie e bullismo

Soluzione: per evitare questa situazione, rafforzare le linee guida di IA responsabili insieme agli utenti dell'agente. È anche possibile aggiornare i criteri di moderazione del contenuto dell'agente.

OpenAIJailBreak

Messaggio di errore: il contenuto è stato filtrato a causa di restrizioni di intelligenza artificiale responsabile.

Un controllo di sicurezza blocca il contenuto di un tentativo di jailbreak. Un tentativo di jailbreak è un attacco di richiesta dell'utente che ignora le richieste di sistema e tenta di modificare il comportamento dell'agente previsto. Questi attacchi includono tentativi di modificare le regole di sistema, incorporare una simulazione di conversazione per confondere il modello, simulazioni di ruolo e attacchi di codifica. Per altre informazioni, vedere Prompt Shields in Sicurezza dei contenuti di Azure AI.

Soluzione: per evitare questa situazione, rafforzare le linee guida di IA responsabili insieme agli utenti dell'agente. È anche possibile aggiornare i criteri di moderazione del contenuto dell'agente.

OpenAIndirectAttack (Attacco Indiretto di OpenAI)

Messaggio di errore: il contenuto è stato filtrato a causa di restrizioni di intelligenza artificiale responsabile.

È stato rilevato un attacco da parte di informazioni non fornite direttamente dall'autore dell'agente software o dall'utente, ad esempio documenti esterni. Gli aggressori tentano di incorporare istruzioni nei dati di grounding forniti dall'utente per assumere in modo malevolo il controllo del sistema:

  • Modificando il contenuto
  • Intrusione
  • Esfiltrando dati non autorizzati o rimuovendo dati da un sistema
  • Bloccando le funzionalità di sistema
  • Frode
  • Eseguendo codice e infettando altri sistemi

Per ulteriori informazioni, vedere Prompt Shields per documenti.

Soluzione: se si sta testando e non si intende che il test sia un attacco, assicurarsi che le istruzioni siano allineate a ciò che si vuole che l'agente sia in grado di eseguire. Altrimenti, rafforzare le linee guida di IA responsabili insieme ai tuoi utenti agenti per evitare questa situazione.

OpenAIRateLimitReached

Messaggio di errore: si è verificato un errore.

Soluzione: l'agente ha raggiunto il numero massimo di risposte generative. Verifica la capacità dei messaggi e controlla le informazioni in Risolvere gli errori di limitazione delle risorse negli agenti.

OpenAISelfHarm

Messaggio di errore: il contenuto è stato filtrato a causa di restrizioni di intelligenza artificiale responsabile.

Un controllo dell'intelligenza artificiale responsabile ha bloccato il contenuto correlato all'autolesionismo. L'autolesionismo descrive un linguaggio legato ad azioni fisiche destinate a ferire, danneggiare intenzionalmente il proprio corpo o portare al suicidio.

Questa restrizione include, ma non è limitata ai contenuti relativi a:

  • Disturbi alimentari
  • Bullismo e intimidazione

Soluzione: per evitare questa situazione, rafforzare le linee guida di IA responsabili insieme agli utenti dell'agente. È anche possibile aggiornare i criteri di moderazione del contenuto dell'agente.

OpenAISexual

Messaggio di errore: il contenuto è stato filtrato a causa di restrizioni di intelligenza artificiale responsabile.

Un controllo di intelligenza artificiale responsabile ha bloccato il contenuto considerato sessuale. Il contenuto sessuale descrive il linguaggio correlato a organi anatomici e genitali, relazioni romantiche, atti sessuali e atti che vengono rappresentati in termini erotici o affettuosi, inclusi quelli rappresentati come un assalto o un atto di violenza sessuale.

Questa restrizione include, ma non è limitata ai contenuti relativi a:

  • Contenuto volgare
  • Prostituzione
  • Nudità e pornografia
  • Uso improprio
  • Sfruttamento minorile, abuso di minori, adescamento di minori

Soluzione: per evitare questa situazione, rafforzare le linee guida di IA responsabili insieme agli utenti dell'agente. È anche possibile aggiornare i criteri di moderazione del contenuto dell'agente.

OpenAIViolence

Messaggio di errore: il contenuto è stato filtrato a causa di restrizioni di intelligenza artificiale responsabile.

Un controllo dell'intelligenza artificiale responsabile ha bloccato il contenuto considerato violento. Il contenuto violento descrive il linguaggio correlato alle azioni fisiche destinate a ferire, ferire, danneggiare o uccidere qualcuno o qualcosa del genere. Descrive anche armi, pistole ed entità correlate.

Questa restrizione include, ma non è limitata ai contenuti relativi a:

  • Armi
  • Bullismo e intimidazione
  • Estremismo terroristico e violento
  • Atti persecutori

Soluzione: per evitare questa situazione, rafforzare le linee guida di IA responsabili insieme agli utenti dell'agente. È anche possibile aggiornare i criteri di moderazione del contenuto dell'agente.

OperationTimeout

Messaggio di errore: timeout della chiamata dello strumento. Il completamento dell'operazione richiede troppo tempo. Dettagli dell'errore: Timeout · esecuzione.

Risoluzione: i timeout a livello di singola operazione nei servizi dipendenti possono causare questo errore. Per risolvere il problema:

  1. Limitare l'ambito della query e aggiungere filtri.
  2. Aggiungere il retry con backoff per i timeout transitori.
  3. Usare la paginazione per set di risultati di grandi dimensioni.
  4. Verifica le prestazioni del servizio di destinazione e i limiti delle richieste.

OutgoingMessageSizeTooBig

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

Resolution: a seconda del canale utilizzato per trasferire file, ad esempio Direct Line o Facebook, è possibile che venga visualizzato il seguente messaggio di errore: "La lunghezza del contenuto della richiesta ha superato il limite di 262.144 byte". Il channel impone questi limiti, non Copilot Studio.

In questo scenario, prendere in considerazione alcune opzioni. Un'opzione consiste nel fornire un collegamento alla risorsa come allegato Internet. Un'altra opzione consiste nel esaminare i nodi per assicurarsi che nessuno di essi usi una variabile contenente un volume elevato di testo, ad esempio un JSON.stringify() metodo statico. Se si usa questo metodo o una variabile che contiene un volume elevato di testo, modificare il nodo per passare solo la parte del testo necessaria. Ad esempio, se si usa una scheda adattiva per passare i dati a un altro argomento, aggiornare la variabile per passare 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.

Quota superata

Messaggio di errore: QuotaExceeded.

Soluzione: l'esaurimento dei diritti mensili, giornalieri o simultanei può causare questo errore. Per risolvere il problema:

  1. Controlla l'utilizzo nelle analisi amministrative.
  2. Ridurre le chiamate agli strumenti non necessarie.
  3. Consolidare le operazioni laddove possibile.
  4. Esaminare e aggiornare i piani di licenza o quota, se necessario.

RedirectToDisabledDialog

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

Soluzione: riabilitare l'argomento o rimuovere 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.

Soluzione: creare un nuovo argomento a cui reindirizzare o rimuovere il nodo di reindirizzamento.

SharePoint429

Error message: SharePoint limita le richieste al momento. Riprova più tardi. Dettagli errore: SharePoint429.

Risoluzione: la limitazione del servizio può causare questo errore. Attendere e riprovare.

SharePoint500

Messaggio di errore: questo non è un problema di configurazione. Il servizio responsabile deve indagare. Dettagli dell'errore: SharePoint 500.

Risoluzione: un problema sul lato servizio può causare questo errore. Riprovare in un secondo momento. Se il problema persiste, contattare il supporto tecnico.

SharePoint503

Messaggio di errore: questo non è un problema di configurazione. Il servizio responsabile deve indagare. Dettagli errore: SharePoint503.

Soluzione: la mancata disponibilità temporanea del servizio può causare questo errore. Riprovare in un secondo momento.

SharePointSearchFailed

Messaggio di errore: si tratta di un problema di sistema da parte nostra. Niente di cui hai bisogno per risolvere il problema. Dettagli dell'errore: ambiente di runtime della piattaforma - SharePointSearchFailed.

Resolution: un errore di ricerca SharePoint lato piattaforma può causare questo problema. Riprovare in un secondo momento. Se il problema persiste, contattare il supporto tecnico.

SystemError

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

Risoluzione: contattare il supporto tecnico clienti.

TooMuchDataToHandle

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

Soluzione: questo errore indica che la richiesta inviata a OpenAI supera le dimensioni massime consentite per la richiesta. La richiesta include l'input dell'utente, l'output delle azioni precedenti, gli strumenti chiamati e la cronologia delle conversazioni. Esaminare gli strumenti usati. Ridurre l'output solo ai campi necessari se possibile. Per altre informazioni, vedere Creare un flusso di Power Automate e Chiamare un flusso di Power Automate come azione.