エージェント向けのエラーコード参照(GitHub Copilot)

GitHub Copilot harnessで動作するエージェントがターンを完了できない場合、プレビュー、テスト、評価のタブに短いエラーコードとともにエラーメッセージが表示されます。 エラーコードは原因を特定し、再試行、入力変更、管理者への連絡を判断できます。

Note

この記事の機能は、GitHub Copilot harnessを搭載するエージェントやワークフローで使用されています。

使用率に基づく請求は、エージェントの使用、構築、テスト、評価に適用されます。 これらの行動はCopilotクレジットを消費することがあります。 詳細は「GitHub Copilot harnessで動くエージェントのコスト管理」をご覧ください。

エラーコードが表示される場所

エラーコードは、GitHub Copilotハーネスで動作するエージェントの複数の箇所で現れます。

エラーコード概要

以下の表は、各エラーコードをまとめたもので、再試行が通常効果があるかどうか、そして次のステップは作成者(あなた)、エンドユーザー、管理者の責任であるかを要約しています。

Error code Meaning リトライは通常役立ちます Action owner
CONTENT_FILTERED コンテンツセキュリティポリシーがリクエストや応答をブロックしました。 いいえ、同じ入力で End user
CONTEXT_LENGTH_EXCEEDED その要求はモデルには大きすぎました。 いいえ、同じ入力で Maker
CONVERSATION_BUSY 同じ会話のために、前のメッセージがまだ処理中です。 はい、前のターンが終わった後に End user
CROSS_GEO_NOT_ALLOWED テナントのデータ居住設定がリクエストの処理を妨げています。 No 管理者
DEPLOYMENT_NOT_FOUND 設定済みのAIモデルの展開は見つかりませんでした。 No 管理者または制作者
MODEL_CONSENT_DENIED 選択したAIモデルはあなたの組織で有効になっていません。 No 管理者
QUOTA_EXCEEDED あなたの組織のAIサービスノルマは使い果たされています。 はい、長く待った後で 管理者
RATE_LIMIT_REACHED AIサービスは一時的に忙しいです。 はい、少し待ってから End user
SYSTEM_ERROR 予期せぬエラーが発生し、調査が必要です。 時には;エスカレートする前にもう一度試してみる Support

この記事の残りの部分では、各コードについて詳しく説明しています。

CONTENT_FILTERED

コンテンツセキュリティポリシーがリクエストや応答をブロックしました。

通常意味すること

Microsoftのコンテンツセキュリティポリシーは、憎悪、暴力、性的内容、自傷行為、脱獄未遂、間接攻撃などのカテゴリーをカバーしています。 ユーザーのリクエストかエージェントの応答のいずれかがこれらのカテゴリのいずれかをトリガーしました。

どうすればいいか

  • フラグが立てられた内容を避けるように、リクエストの言い回しをしましょう。
  • 正当な入力で頻繁にエラーに遭遇するエージェントについては、ビルドタブの指示を精査してエージェントの意図した範囲を明確にしてください。 詳細は 「エージェントの識別と指示の設定(プレビュー)」をご覧ください。
  • エージェントは情報漏洩を防ぐために、どのカテゴリがトリガーされたかを明かさない。 特定のケースを調査する必要がある場合は、アクティビティトレースの会話IDで管理者に連絡してください。

CONTEXT_LENGTH_EXCEEDED

このリクエストはAIモデルの最大入力サイズを超えていました。

通常意味すること

エージェントの指示、会話履歴、ツール定義、ツール結果の合計サイズは、モデルが1ターンで処理できるよりも大きいです。 長い会話と大量の道具が最も一般的な原因です。

どうすればいいか

CONVERSATION_BUSY

同じ会話の前のメッセージがまだ処理中です。

通常意味すること

エージェントは1回の会話内で1ターンずつ処理します。 前のターンが終わる前に2回目のメッセージを送ると、新しいメッセージはエージェントが進行中のターンを終えるまで始まることはできません。

どうすればいいか

  • 前の返信が終わるのを待ってから新しいメッセージを送りましょう。
  • もし誤って2つ目のメッセージを送った場合(例えば 「送信」をダブルクリックして)、何も行動しません。 重複したカードは拒否され、元のターンが続きます。
  • エージェントが前のターンで止まっているように見えたら、新しい会話を始めましょう。 詳細は 「プレビュー会話管理(プレビュー)」をご覧ください。

CROSS_GEO_NOT_ALLOWED

テナントのデータレジデンシー設定では、他の地域でのリクエスト処理が許可されていません。

通常意味すること

組織の方針では、データは特定のリージョン内に留まることが求められており、テナント向けに要求されたモデルの地域内展開は利用できません。

どうすればいいか

  • 管理者に連絡してください:
    • テナント設定でAIサービスのための地域横断データ移動を可能にする、または
    • モデルの地域内展開を提供します。
  • 作成者として、エージェントのモデルを自分の地域で展開されているものに変更してください。 詳細は「 エージェントモデルの選択(プレビュー)」をご覧ください。

DEPLOYMENT_NOT_FOUND

構成済みのAIモデル展開は見つかりません。

通常意味すること

エージェントが使用するように設定されているモデルは、すでに廃止された、削除されたか、または環境上で利用できなくなった場合もあります。 この動作はモデルが非推奨化された後やテナント構成の変更後に起こり得ます。

どうすればいいか

  • ビルドタブでモデルピッカーを開き、利用可能なモデルを選択します。 詳細は「 エージェントモデルの選択(プレビュー)」をご覧ください。
  • 以前に利用可能だったモデルが消えた場合は、管理者に連絡して環境内でのモデル展開を確認してください。

エージェントが使っているAIモデルは、あなたのテナントや環境では有効になっていません。

通常意味すること

一部のモデルでは、エージェントが使用する前にテナントや環境レベルで明示的な同意が必要です。 同意が下りなければ、エージェントはモデルに電話をかけることができません。

どうすればいいか

  • 管理者に連絡して、Copilot Studioの設定で必要なモデルを有効にするようにしてください。
  • エージェントがフォールバックモデルで設定されている場合、エージェントは自動的にフォールバックで再試行します。 その場合、何の対応も必要ありません。
  • この特定のモデルが必要ない場合は、 ビルド タブでモデルを変更してください。詳細は「 エージェントモデルの選択(プレビュー)」をご覧ください。

QUOTA_EXCEEDED

あなたの組織はAIサービスのノルマを超えました。

通常意味すること

RATE_LIMIT_REACHEDは短期間のバースト制限ですが、QUOTA_EXCEEDEDは組織が長期使用割当に達したことを示します。 これらのクォータは通常、請求期間中にトークンやリクエストを追跡します。

どうすればいいか

  • しばらくしてからやり直してください。 クオータは通常、固定スケジュールでリセットされます。
  • 管理者に連絡して組織のAIサービスノルマを確認し、必要に応じて増額を申請してください。
  • 継続的な開発作業では、ピーク時間外に大規模な評価ランをスケジュールしましょう。

RATE_LIMIT_REACHED

AIサービスは一時的に忙しくなり、リクエストを拒否しました。

通常意味すること

AIサービスの需要が急増したり、短期間で多くのリクエストが寄せられたりしました。 この行動は一時的なものです。

どうすればいいか

  • 数秒待ってから、やり直してください。
  • Evaluateのテスト実行では、失敗したテストケースを再度実行します。
  • エラーが繰り返し起きた場合は、管理者に連絡してキャパシティを確認してください。

SYSTEM_ERROR

予期せぬエラーが発生し、より具体的なコードと一致しません。

通常意味すること

SYSTEM_ERROR 一時的なインフラ問題、予期せぬ内部故障、または工学的調査が必要な状況をカバーする包括的なツールです。 新しいエラーカテゴリーも SYSTEM_ERROR として現れるかもしれませんが、将来のリリースで専用コードが導入されるまで続くかもしれません。

どうすればいいか

  • 要求をもう一度試してください。 問題は一時的なものかもしれません。
  • エラーが続く場合は、アクティビティトレースから会話IDと失敗時刻を取得し、サポートに連絡してください。
  • 複数のユーザーに同時に問題がある場合は、管理者にMicrosoft 365サービスヘルスダッシュボードを確認するよう依頼してください。

安全のためにコマンドがブロックされました

エージェントがコマンドを実行するツール(例:コードインタプリタやシェルツール)を使用する場合、Copilot Studioは各コマンドを実行する前に安全チェックを適用します。 コマンドが安全でないパターンに一致すると、そのコマンドは実行されず、エージェントはその操作がブロックされたと報告します。 例えば、破壊的なファイルシステムの操作、ネットワーク構成の変更、またはツールの意図範囲外の他の動作などです。 ブロックはアクティビティトレースのステップとして現れ、コマンドが拒否されたというメッセージが表示されます。

どうすればいいか

  • エンドユーザー:ブロックされた操作を避ける別の表現を試すか、エージェントにより安全なステップで同じ目標を達成するよう求める。
  • Makers: ビルド タブでツールの説明とエージェントの指示を確認し、エージェントが期待する範囲内に収まるようにしてください。 詳細は 「エージェントの識別と指示の設定(プレビュー)」をご覧ください。
  • 正当な操作が繰り返しブロックされた場合は、活動トレースから会話IDを取得し、管理者に連絡してください。

Forward compatibility

エラーコードリストは今後のリリースで増加する可能性があります。 エラーコードの上に自動化やダッシュボードを構築する場合(例えば評価結果処理時)、未知のコードも SYSTEM_ERRORと同様に扱い、一般的なメッセージを表示し再試行を許可します。

  • 最終更新: