Microsoft 365 Copilot オーケストレーターは、ユーザー要求に応答するために使用する言語モデル、利用可能なコンテキスト、機能を調整します。 宣言型エージェントの場合、これらの機能には、知識の取得、組み込み機能、 および MCP または API プラグインによって提供されるアクションが含まれる場合があります。
この記事では、エージェントの設定がアクションの選択と呼び出しにどのように影響するかに焦点を当てます。 手順、ツール定義、および外部サービスを提供します。Microsoft は会話型ランタイムを管理します。 より広範な責任分担については、 宣言型エージェントのアーキテクチャーを参照してください。
Copilot オーケストレーター
オーケストレータは、エージェントの構成と使用可能なコンテキストを使用して、直接応答するか、知識を取得するか、またはツールを呼び出すかを決定します。 すべての要求が外部アクションを必要とするわけではありません。
たとえば、ユーザーが「現在、どのようなチケットが割り当てられていますか?」と尋ねるとします。適切なチケット アクションを持つエージェントは、モデルの知識に依存するのではなく、チケット サービスから現在の情報を取得できます。
次の図は、API アクションの相互作用を示しています。 これは概念的なビューであり、固定の実行シーケンスや、すべての要求で Microsoft Graph または外部 API が使用されることを保証するものではありません。
- 要求を解釈します。 Copilot は、プロンプト、エージェントの指示、会話履歴、使用可能なアプリ コンテキストを使用して、ユーザーのタスクを識別します。 プラットフォームの安全性とポリシー チェックは、要求の続行のかどうか、および続行する方法に影響する可能性があります。
- 関連する機能を選択します。 Copilot は、構成済みのナレッジとツールのどちらが役立つかを判断します。 外部アクションの場合、プラグインとツールの説明は、適切な操作を特定するのに役立ちます。
- 入力を決定し、ツールを呼び出します。 Copilot は、利用可能な情報をツールのパラメーターにマップします。 指示は、値を作成するのではなく、不足している必要な情報を要求するようにガイドする必要があります。 外部呼び出しでは、構成された 認証 と 確認の動作が使用されます。
- 結果を解釈します。 Copilot は、返されたデータまたはエラーを使用して、次の手順を決定します。 対話には、別の呼び出し、説明の要求、またはユーザーへの応答を含めることができます。
- ユーザーに応答します。 Copilot は、利用可能なコンテキストと結果を使用して応答を生成します。 応答には、サービスが実際に返したまたは変更した内容が反映されている必要があります。
宣言型エージェントは、ある API 呼び出しの出力を別の API 呼び出しに渡したり、API アクションと SharePoint の知識またはコード インタープリターを組み合わせたりするなど、 関数呼び出しのチェーンをサポートします。 一定数の呼び出しが常に 1 ターンで完了すると想定するのではなく、必要な操作を設計してテストします。 現在の プラグインの制限 と外部サービスの制限に従います。
プラットフォーム保護とユーザー確認は、外部サービスでの承認やビジネス ルールのチェックに取って代わるものではありません。 ワークフローで正確な実行順序、トランザクション、またはリカバリが必要な場合は、モデル命令に依存するのではなく、それらの要件をサービスに実装します。
Copilot のオーケストレーターがアクションをユーザー クエリと照合する方法
プラグインの選択と個々のツールの呼び出しは異なる決定です。 プラグインの説明は、Copilot が関連するサービスまたはドメインを識別するのに役立ちます。 そのプラグインから使用できるツールは、Copilot が呼び出すことができる操作と、それらに必要な入力を記述します。
プラグインの選択にセマンティック マッチングが使用されている場合、一致は個々の関数の説明ではなく、プラグインの説明に基づいて行われます。 一致したプラグインは、その機能やツールを利用できるようにします。これは、5 つの機能からなる固定された候補リストではありません。 現在の選択動作とコンテキストの制約については、「 MCP と API プラグインの制限」を参照してください。
各レベルで役立つ説明を提供します。
| 構成 | 説明する内容 |
|---|---|
| プラグインの説明 | サービスの目的、サポートされるユーザー タスク、ドメイン。 他のプラグインと区別できるほど具体的な説明にしてください。 |
| 関数またはツールの定義 | 操作の目的、使用するタイミング、およびデータを取得または変更するかどうか。 API プラグインの場合は、関数名を OpenAPI operationIdにマップします。 |
| パラメーター | 必須入力、型、形式、わかりやすい例。 識別子と表示名を区別し、オプションの動作を明確にします。 |
| 結果とエラー | 返されるデータ、成功した操作の意味、および失敗の表現方法。 ペイロードをタスクに関連するままにします。 |
API プラグインについては、「 効果的な OpenAPI の説明を作成する」を参照してください。 MCP プラグインの場合は、ツール定義が動的に検出されるか、プラグイン マニフェストにピン留めされているかをチェックします。 動的検出では、サーバーのツール定義を変更すると、エージェントを再公開せずに選択に影響を与えることができます。
アクションの選択の改善と評価
説明と指示は選択に影響します。 これらは、要求のすべての言い回しに対して特定のツールが呼び出されることを保証するものではありません。
- 重複する操作を明確にします。 複数のツールが適していると思われる場合は、それぞれのさまざまな目的と必要な入力を説明します。 読み込み操作とデータを変更する操作を区別します。
- 手順内のツールにタスクを接続します。 構成されたツールを使用する場合、不足している情報を収集する方法、フォローアップ要求で以前の結果を使用する方法を説明します。 APIプラグインを使用したエージェントの手順を参照してください。
- 使用可能なツールに重点を置きます。 エージェントのタスクに必要な操作を公開します。 より多くのツール定義とより大きなペイロードは、コンテキストを消費し、応答品質を低下させる可能性があります。
- 実際の選択と結果をテストします。 言い換えられたプロンプト、あいまいな要求、入力の欠落、マルチステップ タスク、キャンセルされた確認、およびサービスの障害を含めます。 最終的な文言だけでなく、サービスが受け取った操作とパラメーターを確認します。
- 定義が変更された場合は、テストを繰り返す。 プラグインの説明、ツール定義、手順、またはプラットフォームを変更した後に、代表的なケースを再実行します。 動的検出を使用するときに MCP サーバーの更新プログラムを含めます。
重要
会話応答が見つからないか不完全な場合、外部操作が完了したかどうかは確立されません。 データを変更する操作を再試行する前にサービスの結果を確認し、繰り返しの要求を安全に処理するようにサービスを設計します。
より広範な設計の推奨事項については、「 宣言型エージェントのベスト プラクティス」を参照してください。 繰り返し可能なテスト ケースとアサーションについては、「 エージェント評価の概要」を参照してください。