Comprendre les codes d’erreur
Lorsqu’un agent rencontre un problème au cours d’une conversation, il répond par un message contenant un code d’erreur correspondant au problème spécifique rencontré. Les utilisateurs de l’agent doivent donner ce code d’erreur à leur administrateur.
En tant que créateur d’agent, si un problème se produit lorsque vous utilisez le volet de test pour tester votre agent, vous pouvez voir un message contenant plus de contexte sur le problème, en plus du code d’erreur. Vous pouvez également utiliser le volet Vérificateur de rubrique pour valider votre agent.
Liste d′erreurs
Note
Le terme dialogue utilisé dans certains messages d’erreur fait référence à une rubrique.
Code d'erreur | Description |
---|---|
ContentError | Une erreur s’est produite dans le contenu de la rubrique. |
DataLossPreventionViolation | Une violation de la stratégie de protection contre la perte de données a eu lieu. |
FlowActionException | Une erreur s’est produite lors de l’exécution d’un flux de cloud. |
FlowActionBadRequest | Une requête envoyée à un flux de cloud a un format incorrect. |
FlowActionTimedOut | Un flux de cloud a mis plus de 100 secondes à s’exécuter et a expiré. |
InvalidContent | Un contenu non valide a été ajouté à l’éditeur de code. |
InfiniteLoopInBotContent | Un nœud a été exécuté trop de fois. |
LatestPublishedVersionNotFound | Impossible de récupérer la version publiée de l’agent. |
OutgoingMessageSizeTooBig | Un message envoyé par un agent est trop volumineux pour être traité. |
OpenAIRateLimitReached | La limite de capacité de l’agent a été atteinte. |
RedirectToDisabledDialog | Une rubrique redirige vers une rubrique désactivée. |
RedirectToNonExistentDialog | Une rubrique redirige vers une autre rubrique qui n’existe plus. |
SystemError | Une erreur système s’est produite dans Copilot Studio. |
ContentError
Message d’erreur: cette erreur produit des messages dynamiques basés sur le contexte de l’erreur.
Résolution : ce message est une erreur générique pour les problèmes liés au contenu de votre agent. Pour plus de détails, reportez-vous au message d’erreur.
Voici quelques problèmes courants :
- Les propriétés obligatoires d’un nœud sont manquantes.
- YAML non valide ajouté avec l’éditeur de code.
- Une formule Power Fx contient une erreur.
DataLossPreventionViolation
Message d’erreur : « Cet environnement nécessite que les utilisateurs se connectent avant de pouvoir utiliser l’agent. Accédez à Gérer > Sécurité > Authentification et sélectionnez l’option pour obliger les utilisateurs à se connecter. »
Solution :
- Les stratégies de protection contre la perte de données (DLP) de votre environnement exigent la connexion des utilisateurs. Voir Ajouter l’authentification de l’utilisateur final avec la rubrique système Connexion.
- Un ou plusieurs connecteurs utilisés dans l’agent ne se trouvent pas dans le même groupe de données. Voir Copilot Studioconnecteurs.
- Un ou plusieurs connecteurs utilisés dans l’agent sont bloqués par l’administrateur client.
FlowActionException
Messages d’erreur :
- « Aucune sortie n’a été reçue du flux {FlowName} ({FlowId}), même si une sortie était attendue conformément à la définition de l’agent. »
- « Le paramètre de sortie avec le nom {ItemKey} dans le flux {FlowName} ({FlowId}) est manquant dans les données de réponse. Actualisez le flux ou vérifiez que le flux renvoie cette valeur. »
- « Le paramètre de sortie avec le nom {ItemKey} dans le flux {FlowName} ({FlowId}) est manquant dans le schéma de sortie. Actualisez le flux. »
Résolution : recherchez d’éventuelles erreurs dans le flux.
FlowActionBadRequest
Messages d’erreur :
- « Le paramètre avec le nom {KeyName} dans le flux {FlowName} ({FlowId}) est déclaré être de type {ItemTypeKind}. Ce type n’est pas pris en charge lors de l’appel de Power Automate. Actuellement, seuls les types Texte, Booléen et Nombres sont pris en charge. »
- « Le paramètre avec le nom {ItemKey} dans le flux {FlowName} ({FlowId}) est manquant dans l’action « Appeler le flux ».
- « Le paramètre avec le nom {KeyName} dans le flux {FlowName} ({FlowId}) est évalué sur le type {ResolveType}, type attendu {ExpectedType}. »
- « L’exécution du flux {FlowName} ({FlowId}) a échoué avec le code de réponse {ResponseCode}, code d’erreur : {FlowErrorCode}. »
Résolution : vérifiez que le type de base des variables transmises au flux correspond au type du paramètre.
FlowActionTimedOut
Message d’erreur : « Le flux avec l’ID {FlowId} a expiré. Code d’erreur : {FlowErrorCode} »
Résolution : recherchez d’éventuelles erreurs dans le flux pour comprendre pourquoi le flux de cloud a mis plus de 100 secondes à s’exécuter avant de revenir à votre agent. Essayez d’optimiser la requête et les données que vous renvoyez du système principal. Si une partie de la logique du flux de cloud peut continuer à s’exécuter après l’envoi d’un résultat à l’agent, placez ces actions après l’étape « Renvoyer les valeurs à Copilot Studio » dans votre flux de cloud.
InvalidContent
Message d’erreur : « Il existe un total de {TotalComponents} composant(s) dans l’agent, mais aucun n’est valide. »
Résolution : ouvrez l’éditeur de code pour examiner les problèmes avec le contenu.
InfiniteLoopInBotContent
Message d’erreur : « l’action {DialogId}.{TriggerId}.{ActionId} a été exécutée plus de {MaxTurnCount} fois dans une ligne. Cela indique un cycle dans l’exécution de la boîte de dialogue et, par conséquent, l’exécution de la boîte de dialogue sera interrompue. »
Résolution : assurez-vous que le sujet se termine correctement et que les liens vers d’autres sujets se terminent correctement, comme le sujet système Escalader.
LatestPublishedVersionNotFound
Message d’erreur : « Impossible de récupérer la dernière version publiée de l’agent. »
Résolution : publiez l’agent.
OutgoingMessageSizeTooBig
Message d’erreur : « La taille du message sortant est trop grande. »
Résolution : examinez vos nœuds pour vous assurer qu’aucun d’entre eux n’utilise une variable contenant un grand volume de texte, par exemple une méthode statique JSON.stringify()
. Si ce type de méthode est utilisé, ou si une autre variable contenant un grand volume de texte est utilisée, modifiez le nœud pour ne transmettre que la partie de texte nécessaire. Par exemple, si vous utilisez une carte adaptative pour transmettre des données à une autre rubrique, mettez à jour la variable pour ne transmettre que la propriété nécessaire.
Pour plus d’informations, consultez Limites de la taille maximale des messages de données de canal lors de l’utilisation de Copilot Studio dans Omnicanal.
OpenAIRateLimitAtteint
Message d’erreur : une erreur s’est produite.
Résolution : le nombre maximal de réponses génératives a été atteint. Examinez votre capacité de message et ouvrez une demande de support pour augmenter votre limite de taux de réponses génératives.
RedirectToDisabledDialog
Message d’erreur : « la boîte de dialogue avec l’ID {DialogId} est désactivée dans la définition. Activez la boîte de dialogue avant de l’utiliser. »
Résolution : réactivez la rubrique ou supprimez le nœud de redirection.
RedirectToNonExistentDialog
Message d’erreur : « la boîte de dialogue avec l’ID {DialogId} est introuvable dans la définition. Vérifiez que la boîte de dialogue est présente et que l’ID est correct. »
Résolution : créez une rubrique de redirection ousupprimez le nœud de redirection.
SystemError
Message d’erreur : cette erreur ne produit pas de message d’erreur.
Résolution : contactez le service clientèle.