Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
- Raccourcez les instructions de l’agent dans l’onglet Build .
- Réduisez le nombre d’outils attachés à l’agent. En savoir plus sur Outils de gestion pour un agent (aperçu).
- Commencez une nouvelle conversation d’aperçu pour effacer l’historique des conversations. En savoir plus dans Gérer les conversations d’aperçu (aperçu).
- Choisissez un modèle avec une fenêtre de contexte plus grande. En savoir plus dans Sélectionner un modèle d’agent (aperçu).
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.
MODEL_CONSENT_DENIED
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.