チャネルでの FlowActionBadRequest エージェント エラー

まとめ

この記事は、FlowActionBadRequest エージェントが Power Automate フローを呼び出したときに、Microsoft Teamsなどのチャネルで発生する エラーを解決するのに役立ちます。 このエラーは通常、フロー アクションでの入力スキーマまたは出力スキーマの不一致が原因で発生します。

Symptoms

Microsoft Teamsなどのチャネルで Power Automate フローと統合されている Copilot Studio エージェントを操作すると、次のエラー メッセージが表示されます。

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

原因

このエラーは、フローの入力パラメーターまたは出力パラメーターとエージェントが想定する内容の間でスキーマが一致しないために発生します。 多くの場合、このエラーは、Copilot Studio でフローを変更しても、変更を更新または再発行しない場合に発生します。 そのため、Teams は予期しないデータ形式を送受信します。 Null または不足している入力値でも、このエラーがトリガーされる可能性があります。

ソリューション

Copilot Studio でフローをリフレッシュして更新する

最も一般的な修正は、入力スキーマと出力スキーマがエージェントと一致するように Copilot Studio のフローを更新することです。

  1. Copilot Studio でフローを含むトピックを開きます。

  2. アクションノードの省略記号 (...) を選択し、更新を選択します。

    アクション ノードに焦点を当て、ノードの [更新] オプションを強調表示しているトピックのスクリーンショット。

  3. Copilot Studio の入力パラメーターと出力パラメーターが Power Automate のパラメーターと一致することを確認します。

  4. エージェントを保存して再発行します。

null 入力値があるかどうかを確認してください

フローを更新した後もエラーが解決しない場合は、Copilot Studio エージェントから Power Automate フローに渡される入力パラメーターが有効であることを確認します。

  1. Copilot Studio と Power Automate の入力値を比較して、不一致を特定します。

    Power Automate の入力が強調表示されている Copilot Studio アクション ノードのスクリーンショット。

    Power Automate フローのスクリーンショット。フローが呼び出されたときにエージェントが実行する内容が強調表示されています。

  2. 入力値が null の場合は、フローに メッセージ アクションを追加して、入力値をキャプチャして返します。 この手順は、Teams に返されるデータをデバッグして確認するのに役立ちます。

  3. null または不足している入力を処理するロジックまたは式をフローに追加します。

Teams で会話を更新する

Microsoft Teamsは、古いバージョンのエージェント会話をキャッシュすることがあります。 このキャッシュにより、前の手順を完了した後でもエラーが保持される可能性があります。

  1. エージェントとの Teams チャットで、やり直しさようなら、または会話の終了トピックをトリガーする他のフレーズを入力します。

  2. 新しい会話を開始して、最新のフロー バージョンを読み込みます。

会話の状態をクリアする

前の手順で問題が解決しない場合は、Teams の会話状態をクリアします。 エージェントとの Teams チャットで、「 /debug clearstate 」と入力して会話コンテキストをリセットし、Teams にエージェントの状態の再読み込みを強制します。