Erreur de l’agent FlowActionBadRequest dans les canaux

Résumé

Cet article vous aide à résoudre l’erreur FlowActionBadRequest qui se produit dans les canaux, tels que Microsoft Teams, lorsqu’un agent Microsoft Copilot Studio appelle un flux Power Automate. L’erreur est généralement due à des incompatibilités de schéma d’entrée ou de sortie dans les actions de flux.

Symptoms

Lorsque vous interagissez avec un agent Copilot Studio intégré aux flux Power Automate dans des canaux tels que Microsoft Teams, vous recevez le message d’erreur suivant :

FlowActionBadRequest Conversation Id: xxxxxx_rYcg4Z9DFNp_rP-RkQraV5IPMFu-KRlt4UE Time (UTC): 2024-12-02T00:44:24.873Z.

La cause

Cette erreur se produit en raison d’une incompatibilité de schéma entre les paramètres d’entrée ou de sortie du flux et ce que l’agent attend. L’erreur se produit souvent lorsque vous modifiez le flux dans Copilot Studio, mais n’actualisez pas ou republiez les modifications. Par conséquent, Teams envoie ou reçoit des formats de données inattendus. Les valeurs d’entrée null ou manquantes peuvent également déclencher cette erreur.

Solution

Actualiser et mettre à jour le flux dans Copilot Studio

Le correctif le plus courant consiste à actualiser le flux dans Copilot Studio afin que le schéma d’entrée et de sortie corresponde à l’agent :

  1. Ouvrez la rubrique qui contient le flux dans Copilot Studio.

  2. Sélectionnez l'icône de suspension (...) sur le nœud Action puis sélectionnez Actualiser.

    Capture d’écran d’une rubrique axée sur un nœud Action et mettant en évidence l’option Actualiser du nœud.

  3. Vérifiez que les paramètres d’entrée et de sortie dans Copilot Studio correspondent aux paramètres de Power Automate.

  4. Enregistrez et republiez l’agent.

Vérifier les valeurs d'entrée null

Si l’erreur persiste après avoir actualisé le flux, vérifiez que les paramètres d’entrée passés de l’agent Copilot Studio au flux Power Automate sont valides.

  1. Comparez les valeurs d’entrée dans Copilot Studio et dans Power Automate pour identifier les différences :

    Capture d’écran d’un nœud Action Copilot Studio, mettant en évidence les entrées Power Automate.

    Capture d’écran du flux Power Automate, mettant en évidence ce que l’agent effectue lorsque le flux est appelé.

  2. Si une valeur d’entrée est null, ajoutez une action Message dans le flux pour capturer et retourner les valeurs d’entrée. Cette étape vous aide à déboguer et à vérifier les données retournées à Teams.

  3. Ajoutez une logique ou des expressions dans le flux pour gérer les entrées Null ou manquantes.

Actualiser la conversation dans Teams

Microsoft Teams met parfois en cache une version obsolète de la conversation de l’agent. Cette mise en cache peut entraîner la persistance de l’erreur même après avoir effectué les étapes précédentes.

  1. Dans le chat Teams avec l’agent, saisissez recommencer, au revoir ou une autre expression qui déclenche la clôture du sujet de conversation.

  2. Démarrez une nouvelle conversation pour charger la dernière version du flux.

Effacer l’état de la conversation

Si les étapes précédentes ne résolvent pas le problème, effacez l’état de la conversation dans Teams. Dans la conversation Teams avec l’agent, entrez /debug clearstate pour réinitialiser le contexte de conversation et forcer Teams à recharger l’état de l’agent.