Codice di errore riferimento per agenti (GitHub Copilot)

Quando un agente alimentato dal GitHub Copilot harness non riesce a completare un turno, le schede Anteprima, Test e Valuta mostrano un messaggio di errore insieme a un breve codice di errore. Il codice di errore identifica la causa così puoi decidere se riprovare, modificare il tuo input o contattare il tuo amministratore.

Note

Il cablaggio utilizzato per costruire questo agente utilizza una fatturazione basata sull'uso. Utilizzare, costruire, testare e valutare agenti potrebbe consumare Copilot Credits. Scopri di più in Panoramica della fatturazione basata sull'uso.

Dove vedi i codici di errore

I codici di errore appaiono in diversi punti negli agenti alimentati dall'harness GitHub Copilot:

Riassunto del codice di errore

La tabella seguente riassume ogni codice di errore, se di solito aiuta riprovare e se il passo successivo spetta a te (il creatore), all'utente finale o al tuo amministratore.

Error code Meaning Di solito riprova aiuta Action owner
CONTENT_FILTERED Una politica di sicurezza dei contenuti bloccava la richiesta o la risposta. No, con lo stesso input End user
CONTEXT_LENGTH_EXCEEDED La richiesta era troppo grande per il modello. No, con lo stesso input Maker
CONVERSATION_BUSY Un messaggio precedente è ancora in fase di elaborazione per la stessa conversazione. Sì, dopo la fine del turno precedente End user
CROSS_GEO_NOT_ALLOWED Le impostazioni di residenza dati del tuo inquilino impediscono l'elaborazione della richiesta. No Administrator
DEPLOYMENT_NOT_FOUND Il deployment del modello AI configurato non è stato localizzato. No Amministratore o creatore
MODEL_CONSENT_DENIED Il modello di IA selezionato non è abilitato per la tua organizzazione. No Administrator
QUOTA_EXCEEDED La quota di servizi AI della tua organizzazione è esaurita. Sì, dopo un'attesa più lunga Administrator
RATE_LIMIT_REACHED Il servizio AI è temporaneamente occupato. Sì, dopo una breve attesa End user
SYSTEM_ERROR Si è verificato un errore inaspettato che richiede un'indagine. A volte; Riprova prima di escalare Support

Il resto di questo articolo descrive ogni codice in dettaglio.

CONTENT_FILTERED

Una politica di sicurezza dei contenuti bloccava la richiesta o la risposta.

Cosa significa di solito

Le politiche di sicurezza dei contenuti di Microsoft coprono categorie come odio, violenza, contenuti sessuali, autolesionismo, tentativi di evasione e attacchi indiretti. O la richiesta dell'utente o la risposta dell'agente attivavano una di queste categorie.

Cosa fare

  • Riformulare la richiesta per evitare i contenuti segnalati.
  • Per gli agenti che riscontrano spesso questo errore su input legittimi, affina le Istruzioni nella scheda Build per chiarire l'ambito previsto dell'agente. Scopri di più in Configura identità e istruzioni dell'agente (anteprima).
  • L'agente non rivela quale categoria sia stata attivata, per evitare la fuga di informazioni. Se devi indagare su un caso specifico, contatta il tuo amministratore con l'ID della conversazione della traccia dell'attività.

CONTEXT_LENGTH_EXCEEDED

La richiesta ha superato la dimensione massima di input del modello AI.

Cosa significa di solito

La dimensione combinata delle istruzioni dell'agente, della cronologia delle conversazioni, delle definizioni degli strumenti e di qualsiasi risultato di strumento è maggiore di quanto il modello possa elaborare in un solo turno. Le lunghe conversazioni e il gran numero di strumenti sono le cause più comuni.

Cosa fare

CONVERSATION_BUSY

Un messaggio precedente nella stessa conversazione è ancora in fase di elaborazione.

Cosa significa di solito

L'agente elabora un turno alla volta all'interno di una singola conversazione. Se invii un secondo messaggio prima che finisca il turno precedente, il nuovo messaggio non può iniziare finché l'agente non completa il turno in corso.

Cosa fare

  • Aspetta che la risposta precedente finisca, poi invia il nuovo messaggio.
  • Se hai inviato il secondo messaggio per sbaglio (ad esempio, facendo doppio clic su Invia), non fare alcuna azione. Il duplicato viene rifiutato e il turno originale continua.
  • Se l'agente appare bloccato in un turno precedente, avvia una nuova conversazione. Scopri di più in Gestisci le conversazioni di anteprima (anteprima).

CROSS_GEO_NOT_ALLOWED

Le impostazioni di residenza dati del tuo tenant non permettono di elaborare la richiesta in un'altra regione.

Cosa significa di solito

La politica della tua organizzazione richiede che i dati rimangano all'interno di una specifica regione, e non è disponibile alcuna distribuzione interna del modello richiesto per il tuo tenant.

Cosa fare

  • Contatta il tuo amministratore per uno dei seguenti motivi:
    • Abilitare il movimento dei dati tra le regioni per i servizi di IA nelle impostazioni del tenant, oppure
    • Fornire una distribuzione del modello in regione.
  • Come creatore, cambia il modello dell'agente con uno che sia implementato nella tua regione. Scopri di più in Seleziona un modello di agente (anteprima).

DEPLOYMENT_NOT_FOUND

Il deployment del modello AI configurato non è disponibile.

Cosa significa di solito

Il modello che il tuo agente è configurato per usare è stato ritirato, rimosso o non è comunque disponibile nel tuo ambiente. Questo comportamento può verificarsi dopo che un modello è stato deprecato o dopo un cambiamento nella configurazione del tenent.

Cosa fare

  • Nella scheda Build, apri il selezionatore di modelli e seleziona un modello disponibile. Scopri di più in Seleziona un modello di agente (anteprima).
  • Se un modello precedentemente disponibile è scomparso, contatta il tuo amministratore per verificare la distribuzione del modello nel tuo ambiente.

Il modello AI che usa il tuo agente non è abilitato per il tuo tenant o per l'ambiente.

Cosa significa di solito

Alcuni modelli richiedono un consenso esplicito a livello di inquilino o ambiente prima che gli agenti possano utilizzarli. Se non viene concesso il consenso, l'agente non può chiamare il modello.

Cosa fare

  • Contatta il tuo amministratore per abilitare il modello richiesto nelle impostazioni di Copilot Studio.
  • Se il tuo agente è configurato con un modello di fallback, l'agente riprova automaticamente con il fallback. In quel caso non è necessaria alcuna azione.
  • Se non hai bisogno di questo modello specifico, cambia il modello nella scheda Build. Scopri di più in Seleziona un modello agente (anteprima).

QUOTA_EXCEEDED

La vostra organizzazione ha superato la quota per il servizio di intelligenza artificiale.

Cosa significa di solito

A differenza di , che è un limite di burst di breve durata, QUOTA_EXCEEDED indica che la tua organizzazione ha RATE_LIMIT_REACHEDraggiunto una quota di utilizzo più duratura. Queste quote solitamente tracciano token o richieste durante un periodo di fatturazione.

Cosa fare

  • Attendere e riprovare più tardi. Le quote di solito si azzerano su un programma fisso.
  • Contatta il tuo amministratore per esaminare la quota di servizi AI dell'organizzazione e richiedere un aumento se necessario.
  • Per i lavori di sviluppo in corso, programmate grandi sessioni di valutazione fuori dalle ore di punta.

RATE_LIMIT_REACHED

Il servizio AI è temporaneamente occupato e ha respinto la richiesta.

Cosa significa di solito

La domanda per il servizio di IA è aumentata, oppure la tua organizzazione ha inviato molte richieste in poco tempo. Questo comportamento è transitorio.

Cosa fare

  • Attendere alcuni secondi e riprovare.
  • Per i test in Valutate, rieseguire i casi di test falliti.
  • Se l'errore si ripete, contatta il tuo amministratore per verificare la capacità.

SYSTEM_ERROR

Si è verificato un errore inaspettato che non corrisponde a nessuno dei codici più specifici.

Cosa significa di solito

SYSTEM_ERROR è un termo generico per problemi infrastrutturali transitori, guasti interni imprevisti o condizioni che richiedono indagini ingegneristiche. Potrebbero anche emergere nuove categorie di errori fino SYSTEM_ERROR a quando non riceveranno un codice dedicato in una versione successiva.

Cosa fare

  • Riprovare la richiesta. Il problema potrebbe essere transitorio.
  • Se l'errore persiste, cattura l'ID della conversazione dalla traccia di attività e l'ora del guasto, quindi contatta il supporto.
  • Se il problema colpisce molti utenti contemporaneamente, chiedi al tuo amministratore di controllare la dashboard di salute del servizio Microsoft 365.

Comando bloccato per sicurezza

Quando un agente utilizza uno strumento che esegue comandi (ad esempio, un interprete di codice o uno strumento shell), Copilot Studio applica controlli di sicurezza prima che ogni comando venga eseguito. Se un comando corrisponde a un pattern non sicuro, il comando non viene eseguito e l'agente segnala che l'operazione è stata bloccata. Ad esempio, un'operazione distruttiva del file system, un cambiamento nella configurazione della rete o un'altra azione al di fuori dell'ambito previsto dello strumento. Il blocco appare come un passaggio nella traccia di attività con un messaggio che indica che il comando è stato negato.

Cosa fare

  • Utenti finali: provate una formulazione diversa che eviti l'operazione bloccata, oppure chiedete all'agente di raggiungere lo stesso obiettivo attraverso un passo più sicuro.
  • Makers: nella scheda Build , rivedi la descrizione dello strumento e le istruzioni dell'agente così l'agente rimane entro l'ambito che ti aspetti. Scopri di più in Configura identità e istruzioni dell'agente (anteprima).
  • Se un'operazione legittima viene bloccata ripetutamente, cattura l'ID della conversazione dalla traccia di attività e contatta il tuo amministratore.

Forward compatibility

La lista dei codici di errore potrebbe crescere nelle future versioni. Se costruisci automazioni o dashboard sopra codici di errore (ad esempio, nell'elaborazione dei risultati della valutazione), tratta qualsiasi codice sconosciuto allo stesso modo di: SYSTEM_ERRORmostra un messaggio generico e consente il ritento.

  • Ultimo aggiornamento: