Référence aux codes d’erreur pour les agents (GitHub Copilot)

Lorsqu'un agent alimenté par le faisceau GitHub Copilot ne peut pas effectuer un tour, les onglets Aperçu, Test et Évaluation affichent un message d'erreur accompagné d'un court code d'erreur. Le code d’erreur identifie la cause afin que vous puissiez décider s’il faut réessayer, modifier votre entrée ou contacter votre administrateur.

Note

Le framework utilisé pour construire cet agent utilise une facturation basée sur l’utilisation. L’utilisation, la création, le test et l’évaluation des agents peuvent consommer des crédits Copilot. En savoir plus dans Aperçu de la facturation basée sur l’utilisation.

Là où vous voyez les codes d’erreur

Les codes d’erreur apparaissent à plusieurs endroits dans des agents alimentés par le harnais GitHub Copilot :

  • L’onglet Aperçu : Lorsqu’une conversation de test échoue, la réponse de l’agent échoué affiche le message d’erreur avec le code d’erreur.
  • Tableau historique Aperçu : La colonne Erreur affiche le code d’erreur pour toute conversation ayant le statut Échec . En savoir plus dans Gérer les conversations d’aperçu (aperçu).
  • La trace d’activité : Une étape ratée dans la trace affiche le code d’erreur à côté de l’étape qui l’a produite. En savoir plus dans Utilisez la trace d’activité pour déboguer votre agent (aperçu).
  • Évaluer les résultats : Les cas de test échoués incluent le code d’erreur dans les détails de la run. En savoir plus dans Évaluer un agent (aperçu).

Résumé du code d’erreur

Le tableau suivant résume chaque code d’erreur, si une nouvelle tentative aide généralement, et si l’étape suivante vous incombe (le créateur), l’utilisateur final ou votre administrateur.

Error code Meaning Essayer de réessayer aide généralement Action owner
CONTENT_FILTERED Une politique de sécurité du contenu bloquait la demande ou la réponse. Non, avec la même entrée End user
CONTEXT_LENGTH_EXCEEDED La demande était trop importante pour le modèle. Non, avec la même entrée Maker
CONVERSATION_BUSY Un message précédent est encore en cours de traitement pour la même conversation. Oui, après la fin du tour précédent End user
CROSS_GEO_NOT_ALLOWED Les paramètres de résidence des données de votre locataire empêchent le traitement de la demande. No Administrator
DEPLOYMENT_NOT_FOUND Le déploiement du modèle d’IA configuré n’a pas pu être localisé. No Administrateur ou créateur
MODEL_CONSENT_DENIED Le modèle d’IA sélectionné n’est pas activé pour votre organisation. No Administrator
QUOTA_EXCEEDED Le quota de services IA de votre organisation est épuisé. Oui, après une attente plus longue Administrator
RATE_LIMIT_REACHED Le service d’IA est temporairement occupé. Oui, après une courte attente End user
SYSTEM_ERROR Une erreur inattendue s’est produite et nécessite une enquête. Parfois ; Essaie à nouveau avant d’escalader Support

Le reste de cet article décrit chaque code en détail.

CONTENT_FILTERED

Une politique de sécurité du contenu bloquait la demande ou la réponse.

Ce que cela signifie généralement

Les politiques de sécurité des contenus de Microsoft couvrent des catégories telles que la haine, la violence, le contenu sexuel, l'automutilation, les tentatives d'évasion et les attaques indirectes. Soit la demande de l’utilisateur, soit la réponse de l’agent déclenchait l’une de ces catégories.

Procédure

  • Reformulez la demande pour éviter le contenu signalé.
  • Pour les agents qui rencontrent fréquemment cette erreur lors d’entrées légitimes, affinez les Instructions dans l’onglet Build pour clarifier la portée prévue par l’agent. En savoir plus dans Configurer l’identité de l’agent et les instructions (aperçu).
  • L’agent ne révèle pas quelle catégorie a été déclenchée, afin d’éviter toute fuite d’informations. Si vous devez enquêter sur un cas spécifique, contactez votre administrateur avec l’identifiant de conversation de la trace d’activité.

CONTEXT_LENGTH_EXCEEDED

La demande dépassait la taille maximale d’entrée du modèle IA.

Ce que cela signifie généralement

La taille combinée des instructions de l’agent, de l’historique des conversations, des définitions des outils et de tout résultat d’outil est plus grande que ce que le modèle peut traiter en un seul tour. Les longues conversations et le grand nombre d’outils sont les causes les plus courantes.

Procédure

CONVERSATION_BUSY

Un message précédent dans la même conversation est toujours en cours de traitement.

Ce que cela signifie généralement

L’agent traite un tour à la fois dans une seule conversation. Si vous envoyez un second message avant la fin du tour précédent, le nouveau message ne peut commencer que lorsque l’agent a terminé le tour en cours.

Procédure

  • Attendez que la réponse précédente soit terminée, puis envoyez le nouveau message.
  • Si vous avez envoyé le second message par erreur (par exemple, en double-cliquant sur Envoyer), ne faites aucune action. Le double est rejeté et le tour initial continue.
  • Si l’agent semble bloqué sur un tour précédent, commencez une nouvelle conversation. En savoir plus dans Gérer les conversations d’aperçu (aperçu).

CROSS_GEO_NOT_ALLOWED

Les paramètres de résidence des données de votre locataire ne permettent pas de traiter la requête dans une autre région.

Ce que cela signifie généralement

La politique de votre organisation exige que les données restent dans une région spécifique, et aucun déploiement interne du modèle demandé n’est disponible pour votre locataire.

Procédure

  • Contactez votre administrateur pour :
    • Activez le déplacement de données interrégionales pour les services d’IA dans les paramètres locataires, ou
    • Fournir un déploiement du modèle en région.
  • En tant que créateur, changez le modèle de l’agent pour un modèle déployé dans votre région. En savoir plus dans Sélectionner un modèle d’agent (aperçu).

DEPLOYMENT_NOT_FOUND

Le déploiement du modèle d’IA configuré est introuvable.

Ce que cela signifie généralement

Le modèle que votre agent est configuré pour utiliser a été retiré, retiré ou n’est pas disponible dans votre environnement. Ce comportement peut survenir après qu’un modèle soit déprécié ou après un changement de configuration du locataire.

Procédure

  • Dans l’onglet Build , ouvrez le sélecteur de modèles et sélectionnez un modèle disponible. En savoir plus dans Sélectionner un modèle d’agent (aperçu).
  • Si un modèle précédemment disponible a disparu, contactez votre administrateur pour vérifier le déploiement du modèle dans votre environnement.

Le modèle d’IA utilisé par votre agent n’est pas activé pour votre locataire ou votre environnement.

Ce que cela signifie généralement

Certains modèles exigent un consentement explicite au niveau du locataire ou de l’environnement avant que les agents puissent les utiliser. Si le consentement n’est pas accordé, l’agent ne peut pas appeler le mannequin.

Procédure

  • Contactez votre administrateur pour activer le modèle requis dans les paramètres de Copilot Studio.
  • Si votre agent est configuré avec un modèle de secours, l’agent réessaie automatiquement avec ce plan de secours. Aucune action n’est nécessaire dans ce cas.
  • Si vous n’avez pas besoin de ce modèle spécifique, changez le modèle dans l’onglet Build. En savoir plus dans Sélectionner un modèle agent (aperçu).

QUOTA_EXCEEDED

Votre organisation a dépassé son quota pour le service d’IA.

Ce que cela signifie généralement

Contrairement à , qui est une limite de rafales de courte durée, QUOTA_EXCEEDED cela indique que votre organisation a RATE_LIMIT_REACHEDatteint un quota d’utilisation plus longtemps. Ces quotas suivent généralement les jetons ou les requêtes sur une période de facturation.

Procédure

  • Patientez, puis réessayez plus tard. Les quotas sont généralement réinitialisés selon un calendrier fixe.
  • Contactez votre administrateur pour examiner le quota de services IA de l’organisation et demander une augmentation si nécessaire.
  • Pour les travaux de développement en cours, planifiez de grandes évaluations en dehors des heures de pointe.

RATE_LIMIT_REACHED

Le service d’IA est temporairement occupé et a rejeté la demande.

Ce que cela signifie généralement

La demande pour le service d’IA a explosé, ou votre organisation a envoyé de nombreuses demandes en peu de temps. Ce comportement est transitoire.

Procédure

  • patientez quelques secondes, puis réessayez.
  • Pour les essais dans Evaluate, relancez les cas de test échoués.
  • Si l’erreur se reproduit, contactez votre administrateur pour vérifier la capacité.

SYSTEM_ERROR

Une erreur inattendue s’est produite qui ne correspond à aucun des codes plus spécifiques.

Ce que cela signifie généralement

SYSTEM_ERROR est un fourre-tout pour les problèmes d’infrastructure transitoires, les pannes internes inattendues ou les conditions nécessitant une investigation d’ingénierie. De nouvelles catégories d’erreur peuvent aussi apparaître jusqu’à SYSTEM_ERROR ce qu’un code dédié soit publié dans une version future.

Procédure

  • Réessayez la requête. Le problème pourrait être transitoire.
  • Si l’erreur persiste, capturez l’identifiant de conversation à partir de la trace d’activité ainsi que l’heure de la défaillance, puis contactez le support.
  • Si le problème touche plusieurs utilisateurs en même temps, demandez à votre administrateur de vérifier le tableau de bord de santé des services Microsoft 365.

Reference codes

Certains messages d’erreur incluent un code de référence qui commence par MCS- quatre chiffres, ainsi que l’identifiant de la conversation. Par exemple : « Veuillez réessayer, ou contacter votre administrateur avec le code de référence MCS-4063 (conversation ...). » Ces messages apparaissent généralement avec le code d’erreur SYSTEM_ERROR . Le code de référence aide votre administrateur et le Support Microsoft à identifier la cause de la défaillance.

Le tableau suivant liste les codes de référence ayant une cause spécifique sur laquelle vous pouvez agir. Pour tout code de référence qui n’est pas listé, suivez les consignes pour SYSTEM_ERROR et incluez le code de référence et l’identifiant de conversation lorsque vous contactez votre administrateur ou votre support.

Reference code Ce que cela signifie Procédure à suivre
MCS-2012 La conversation atteignit sa limite de stockage, donc l’agent ne put pas sauvegarder le dernier tour. Dans la plupart des cas, une nouvelle conversation commence automatiquement et l’agent n’a plus l’historique de conversation précédent. Envoie ton dernier message encore une fois. Si le message d’erreur vous demande de réinitialiser la conversation, suivez les instructions du message ou commencez une nouvelle conversation. Si l’erreur persiste, contactez votre administrateur avec le code de référence et l’identifiant de conversation.
MCS-4042 La conversation, comme un groupe de discussion Teams ou un fil de discussion par emails, compte plus de participants que l’agent ne supporte, donc l’agent ne peut pas vérifier que tout le monde y a accès. Le même code apparaît lorsqu’un message ou un partage qu’on a demandé à l’agent d’envoyer atteint plus de personnes que l’agent ne peut le vérifier. Utilisez une conversation avec moins de participants, ou envoyez la demande à moins de destinataires. Votre administrateur ne peut pas augmenter cette limite.
MCS-4043 L’agent n’a pas pu confirmer que tout le monde dans la conversation a accès, ni confirmer qui un message, un partage ou une autre action atteindrait. Try again. Pour une demande d’envoi ou de partage de contenu, vérifiez les destinataires ou demandez une action à la fois. Si l’erreur persiste, contactez votre administrateur avec le code de référence et l’identifiant de conversation.
MCS-4063 L’agent a atteint le nombre maximal d’appels de modèles d’IA qu’il peut effectuer pour répondre à un seul message avant de pouvoir terminer sa réponse. Retenter la même requête produit généralement la même erreur. Divisez la demande en petites requêtes et envoyez-les une par une. En tant que créateur, consultez les instructions de l’agent dans l’onglet Build afin qu’un seul message ne nécessite pas autant d’étapes. En savoir plus dans Configurer l’identité de l’agent et les instructions (aperçu).

Commande bloquée pour des raisons de sécurité

Lorsqu’un agent exécute des commandes, Copilot Studio applique des contrôles de sécurité avant l’exécution de chaque commande. Si une commande ne passe pas ces contrôles, elle n’est pas exécutée et l’agent signale que l’opération a été bloquée. Le blocage apparaît comme une étape dans la traçabilité d’activité avec un message indiquant que la commande a été refusée.

Procédure

  • Utilisateurs finaux : Essayez une formulation différente qui évite l’opération bloquée, ou demandez à l’agent d’atteindre le même objectif par une étape plus sûre.
  • Makers : Dans l’onglet Build , relisez la description de l’outil et les instructions de l’agent afin que l’agent reste dans le cadre que vous attendez. En savoir plus dans Configurer l’identité de l’agent et les instructions (aperçu).
  • Si une opération légitime est bloquée à plusieurs reprises, capturez l’identifiant de la conversation à partir de la trace d’activité et contactez votre administrateur.

Forward compatibility

La liste des codes d’erreur pourrait s’allonger dans de futures versions. Si vous construisez une automatisation ou des tableaux de bord par-dessus des codes d’erreur (par exemple, dans le traitement des résultats d’évaluation), traitez tout code inconnu comme SYSTEM_ERROR: afficher un message générique et autoriser une réessayage.

  • Dernière mise à jour :