エラー コードを理解する
エージェントが会話中に問題に遭遇すると、遭遇した特定の問題のエラー コードを含むメッセージで応答します。 エージェントのユーザーは、このエラー コードを管理者に伝える必要があります。
エージェントの作成者は、テスト ペインを使用してエージェントをテストしている際に問題が発生した場合、エラーコードに加えて、問題に関するより詳細な内容のメッセージが表示されます。 または、トピック チェッカー パネルを使用して エージェントを検証することもできます。
エラー一覧
ヒント
一部のエラー メッセージで使用される用語 ダイアログ は、トピック を指します。
| エラー コード | プロパティ |
|---|---|
| ContentError | トピックの内容に誤りがあります。 |
| DataLossPreventionViolation | データ損失防止違反があります。 |
| FlowActionException | クラウド フロー の実行中にエラーが発生しました。 |
| FlowActionBadRequest | クラウド フロー に対する要求の形式に誤りがありました。 |
| FlowActionTimedOut | クラウド フロー の実行に 100 秒以上かかり、タイムアウトになりました。 |
| InvalidContent | コード エディターに無効なコンテンツが追加されました。 |
| InfiniteLoopInBotContent | ノードの実行回数が多すぎます。 |
| LatestPublishedVersionNotFound | エージェントの公開バージョンを取得できません。 |
| RedirectToDisabledDialog | トピックは無効化されたトピックに リダイレクト されています。 |
| RedirectToNonExistentDialog | トピックは、もう存在しない他のトピックに リダイレクトされています。 |
| SystemError | Copilot Studio でシステム エラーが発生しました。 |
ContentError
エラーメッセージ: このエラーは、エラーのコンテキストに基づいて動的メッセージを生成します。
解決策: これは、エージェントのコンテンツに関連する問題全般に当てはまるエラーです。 詳細については、エラー メッセージを参照してください。
一般的な問題としては、次のようなものがあります。
- ノードに必須のプロパティがありません。
- コード エディターで無効な YAML が追加されました。
- Power Fx 形式にエラーが含まれます。
DataLossPreventionViolation
エラー メッセージ: この環境では、エージェントを使用する前にユーザーがログインする必要があります。 管理 > セキュリティ > 認証 に移動し、ユーザーにログインを要求するオプションを選択してください。」
解決方法:
- 環境のデータ損失防止 (DLP) ポリシーには、ユーザーのサインインが必要です。 システム トピック のログインによるユーザー認証の追加を参照してください。
- エージェントで使用されている 1 つ以上のコネクタが同じデータ グループ内にありません。 Copilot Studioコネクタ を参照してください。
- エージェントで使用されている 1 つ以上のコネクタがテナント管理者によってブロックされています。
FlowActionException
エラー メッセージ:
- 「エージェント定義に従って出力が期待されていたにもかかわらず、フロー {FlowName} ({FlowId}) から出力が受信されませんでした。」
- "フロー {FlowName} ({FlowId}) 上の {ItemKey} という名前の出力パラメータが応答データにありません。 フローを更新するか、フローがこの値を返すことを確認します。」
- "フロー {FlowName} ({FlowId}) 上の {ItemKey} という名前の出力パラメータが出力スキーマにありません。 フローを更新してください。"
解決策:フローでエラーを確認 してください。
FlowActionBadRequest
エラー メッセージ:
- フロー {FlowName} ({FlowId}) に存在する名前付きパラメータ {KeyName} という名前のパラメータは型 {ItemTypeKind} であると宣言されています。 Power Automate の呼び出しで、この操作タイプはサポートされていません。 現在、テキスト、ブール値、数値のみがサポートされています。"
- "フロー {FlowName} ({FlowId}) 上の {ItemKey} という名前のパラメータが 'フロー呼び出し' アクションにありません。"
- "フロー {FlowName} ({FlowId}) の {KeyName} と言う名前のパラメータは、型 {ExpectedType} と期待され、型 {ResolveType} に対して評価されました。
- "フロー {FlowName} ({FlowId}) は応答コード {ResponseCode} で実行に失敗しました、エラーコード: {FlowErrorCode}。"
解決策: フローに渡すすべての変数の型の ベース タイプがパラメーターの型と一致する事を確認します。
FlowActionTimedOut
エラー メッセージ: 「id {FlowId} のフローがタイム アウトしました。エラー コード: {FlowErrorCode}」
解決策:フローにエラーがないか確認 して、クラウド フローがエージェントに戻るまでに 100 秒以上かかった理由を把握します。 クエリとバックエンド システムから返すデータの最適化を試みます。 エージェントに結果が送信された後も、クラウド フロー ロジックの一部を実行し続けることができる場合は、クラウド フロー内の「Copilot Studio に値を返す」ステップの後にこれらのアクションを配置します。
InvalidContent
エラー メッセージ: エージェントには合計で {TotalComponents} のコンポーネントが存在しますが、有効なものが 1 つもありません。
解決策:コード エディターを開いて、コンテンツの問題を確認します。
InfiniteLoopInBotContent
エラーメッセージ: "アクション{DialogId}.{TriggerId} .{ActionId} は 連続して {MaxTurnCount} 回以上実行されました。 これは、ダイアログの実行サイクルを示しているため、ダイアログの実行は終了します。"
解決策: トピックを正しく終了し、エスカレート システム トピックなど プロパティを終了させる他のトピックにリンクしてください。
LatestPublishedVersionNotFound
エラー メッセージ: エージェントの最新の公開バージョンを取得できません。
解決策:エージェントを公開します。
RedirectToDisabledDialog
エラーメッセージ: "ID {DialogId} を持つダイアログは定義で無効になっています。 使用する前にダイアログを有効にしてください。」
解決策: トピックを再度有効にするか、リダイレクト ノードを削除します。
RedirectToNonExistentDialog
エラーメッセージ: "ID {DialogId} は定義で無効になっています。 ダイアログが存在し、ID が正しいことを確認してください。"
解決策:新しいトピックを作成 してリダイレクトするか、リダイレクト ノード を削除 します。
SystemError
エラーメッセージ: このエラーはエラー メッセージを生成しません。