開発者モードでエージェントをデバッグする

エージェントのテスト中に 開発者モード を使用して、copilot オーケストレーターが指定されたプロンプトに応答して使用するプラグインを選択したかどうかを確認できます。

copilot 開発者モードの使用

copilot Chat から、「-developer on(または無効にするoff)」と入力することで、開発者モードを有効にすることができます。

開発者モードが有効になっている間、オーケストレーターがエージェント内のエンタープライズ ナレッジ (データ) またはスキル (プラグイン) 内で特に検索してプロンプトに応答すると、デバッグ情報を含むカードが返されます。 デバッグ情報カードには、次のフィールドが含まれます:

• 有効なプラグイン: エージェントで有効になっているプラグインの一覧
• 一致した関数: ランタイム アプリのインデックス検索で一致したプラグインと関数の一覧
• 実行用に選択された関数: オーケストレーター推論に基づいて呼び出し用に選択されたプラグイン関数の一覧
• 関数の実行の詳細: 要求と応答関数の実行状態

実行エラーのトラブルシューティング

プラグインの実行をデバッグするときに発生する可能性がある一般的なエラーと、考えられる原因を次に示します。

デバッグカードなし

オーケストレーターがプロンプトに応答するために Microsoft 365 のデータまたはスキルを必要としない場合、デバッグ情報カードは返されません。

デバッグ カードは、容量調整の場合にも返されません。通常は、後でやり直すエラー メッセージが表示されます。

プラグインが有効になっていないカード

有効なプラグインがない場合、[有効なプラグイン] セクションは、有効なプラグインがないことを示します。

一致しない機能を持つカード

関連するプラグインが有効になっていても、指定されたプロンプトに一致する関数が返されなかった場合、これは、プロンプトがプラグイン名を明示的にメンションしなかったことを示している可能性があります。

実行に関数が選択されていないカード

有効なプラグインがプロンプトの検索意図と一致しなかった場合、デバッグ情報カードは、実行のために選択された関数がないことを報告します。 これは、マニフェストのコマンドの説明が、指定されたプロンプトの検索意図に意味的に関連していないためです。

copilot が以前に一致し、プラグイン関数を正常に実行していた場合、これは調整の兆候である可能性があります。

空または失敗した [関数の実行の詳細なし] のカード

メッセージ以外の拡張機能プラグインの場合、失敗した場合や関数の実行の詳細がない場合は、エージェントがプラグインの選択した関数にパラメーターを割り当てようとしたときに失敗したことを示します。 エラーが一貫していない場合は、プラグインまたはパラメーターの説明が不明であるか、無効なホスト URL、または Open API 定義に関するその他の問題が原因である可能性が最も高くなります。

メッセージ拡張プラグインの場合、ベスト プラクティスは、9 秒以下の応答を最適化することです。 詳細については、メッセージ拡張プラグインの 技術的要件 を確認してください。

現在、プラグイン API の copilot 実行のタイムアウト制限は 10 秒に設定されています。

問題の報告

プラグインに関するフィードバックや問題を報告するには、サムアップボタンまたはサムダウンボタンを使用します。 レポートに #extensibility タグを含めます。 copilot 応答の直後に、サムアップ ("何かが好き") か、サムダウン ("何かが好きではない") かを選択します。"

次に、テキスト ボックスに #extensibility タグを含むメッセージを入力します。テキスト ボックス