ユーザーが Microsoft 365 Copilot Chat で宣言型エージェントと対話すると、宣言型エージェントは他のエージェントに接続して追加情報を取得したり、アクションを実行したりできます。 これらの接続は、 worker_agents プロパティにエージェント タイトル ID を一覧表示することによって、エージェント マニフェストで宣言します。 実行時には、Copilot Chat は対話を仲介するブローカーとして機能するため、ユーザーにはエージェント間のやりとりが表示されますが、接続されているエージェントを自分で選択する必要はありません。
注
マニフェストで宣言された接続エージェントは、Copilot Chat API とは別のメカニズムであり、独自のカスタム アプリケーション内で Microsoft 365 Copilot を利用した会話エクスペリエンスを可能にします。
注
ユーザーは、各接続エージェントを使用する前に取得する必要があります。 詳細については、「Connected Agents を organization 内のユーザーに展開する」を参照してください。
ユーザーが宣言型エージェントと対話すると、エージェントはタスクの一部を接続されたエージェントに委任できます。 Microsoft 365 Copilot は、マニフェストで宣言されている接続エージェントを評価し、現在のタスクと接続エージェントの名前、説明、プロンプトの例に基づいて接続エージェントを選択します。 Copilot は、選択した接続エージェントにテキスト要求を送信し、テキスト応答を受信し、その応答を宣言型エージェントとユーザーとの継続的な対話に組み込みます。
Connected エージェントを使用する場合
Connected エージェントを使用して、部門または開発チーム間でエージェントを分割または結合します。
1 つのエージェントで達成できる以上の拡張
大規模言語モデル (LLM) では、有用なコンテキスト ウィンドウと機能セットが限られています。 1 つの LLM エージェントの信頼性は、 より多くのドキュメントが取得される か、 ツールが有効になるにつれて低下し始めます。 知識または機能を追加した後にエージェントの品質が低下した場合は、それらの機能の一部を別のエージェントに分割して接続します。 既存のエージェントは、接続されたエージェントがその部分を達成するために必要なタスクに関する情報のみを送信します。 接続エージェントは、独自のコンテキストウィンドウで動作し、ユーザー会話に含まれる他のドキュメントや機能から解放されます。
外部で開発されたエージェントとの統合
宣言型エージェントを使用すると、他の開発チームとの共同作業が容易になります。 各開発チームは、Connected Agent を使用して他のエージェントと統合することで、エージェントの機能と品質に集中できます。 マイクロサービスと同様に、各エージェントは他のエージェントに影響を与えることなく開発できます。 マイクロサービスとは異なり、エージェントはインターフェイスが変更されても相互に対話を続けることができます。
エージェント機能を複数のシナリオに共有する
エージェントは、一連のドキュメントとアクションでうまく機能する可能性がありますが、それでもユーザーにとっては困難です。 顧客と売上のリレーショナル データベースのテーブルとデータを理解するエージェントを考えてみましょう。 このエージェントは、店舗の監督者が在庫を管理するのにも、ビジネス アナリストが幹部に報告するのにも役立つ場合があります。 このエージェントを、会話のきっかけと指示を持つスーパーバイザーを保管するように調整されたエージェント、およびビジネス アナリストに合わせたエージェントに接続できた場合。 どちらのタイプのユーザーも、シナリオに合わせたエージェントを使用することでより多くの価値を得る可能性があります。
Connected エージェントの有効化
接続されたエージェントは、Microsoft Agent 365 エージェント レジストリに登録する必要があります。 既存の 宣言型エージェントのマニフェストにエージェントのタイトル ID を含めることで、他のエージェントに接続します。 もう一方のエージェントは、宣言型エージェントであるか、登録済みの Agent2Agent エージェント カードを持っている必要があります。
まず、接続するエージェントのタイトル ID を取得します。 エージェントのタイトル ID は、1 文字、アンダースコア、および GUID からなる文字列です。 宣言型エージェントについては、Microsoft 365 Agents Toolkit の プロビジョニング コマンドの出力または 開発者モードにあります。 Microsoft 365 エージェント登録の場合、これは agentRegistration オブジェクトの id プロパティです。
タイトル ID をidとして worker_agents プロパティに追加します。
worker_agents プロパティは、宣言型エージェント スキーマ バージョン 1.6 で追加されました。
認証と承認
宣言型エージェントは Microsoft 365 Copilot Chat 内で実行されるため、宣言型エージェントへの接続は Microsoft 365 Copilot に対するユーザーの既存の認証に依存します。 Microsoft Agent 365 に登録されている外部エージェントの場合、エージェント登録では、Microsoft 365 Copilot が外部エージェントに対して認証する方法を宣言する必要があります。 登録では、エージェント登録に認証構成を直接埋め込むのではなく、agentRegistration内の authorization オブジェクトを使用して既存の認証登録を参照します。 この分離により、認証構成をエージェント定義とは別に管理できます。 このデザインは API プラグイン マニフェストの設計を反映しています。
構文
{
"type": "None | OAuthPluginVault",
"referenceId": "{string}"
}
type プロパティは、外部エージェントが使用する認証スキームを指定します。
OAuthPluginVaultMicrosoft Entra SSO 登録を使用します。
referenceIdは、Teams 開発者ポータルで生成されたMicrosoft Entra SSO registration ID値です。 詳細については、「 Teams 開発者ポータルを使用する 」を参照してください。
ユーザーが接続エージェントを使用できるかどうかは、認証とは別に決定されます。 ユーザーは、自分で取得するか、管理者展開によって Connected Agent にアクセスできる必要があります。 管理者は、ユーザーに対して Microsoft Agent 365 に登録されている外部エージェントをインストールする必要があります。
ベスト プラクティス
宣言型エージェントは、接続されたエージェントの name、 description、および例のプロンプトに基づいて、接続するエージェントを選択します。 宣言型エージェントの場合、プロンプトの例はマニフェストのconversation_startersのtextフィールドです。 agentRegistration の場合、これはエージェント カード内の AgentSkill オブジェクトのexamples プロパティです。 エージェントの説明は、エージェントが何ができるかを人間とエージェントの両方に説明する必要があります。 たとえば、ビデオ ゲームの販売に関する構造化データを扱うエージェントについて、この説明を考えてみましょう。
A comprehensive video game sales analytics agent that provides detailed insights into
gaming industry data across multiple dimensions.
Analyze top-performing games, consoles, genres, and publishers with regional breakdowns
for North America, Europe, Japan, and global markets.
Discover best-selling titles of all time, platform-specific performance metrics, genre
popularity trends, and yearly sales patterns.
Compare sales figures across different publishers, identify market leaders by region,
and explore gaming industry evolution over time.
Whether you need to understand which games dominated specific platforms, analyze
publisher market share through visualizations like histograms, or track sales performance
across different years and regions, this agent delivers comprehensive gaming market
intelligence with precise data-driven answers.
プロンプトの例では、エージェントが処理できるプロンプトの種類をユーザーとエージェントの両方に通知する必要があります。 ユーザーは同じ概念に対して異なる用語を使用することがあるため、話の開始部分の言い回しを変えることを検討してください。 たとえば、訴訟に取り組む場合、適切な会話のスターターは、"重要"、"ケース"、"顧客"、"問題" という用語も使用する場合があります。 会話スターターの text フィールドのみが接続エージェントによって使用されます。
制限事項
アクティブなエージェントは、接続されているエージェントにのみテキストを送信します。 宣言型エージェントは、テキストまたはアダプティブ カードを返します。 Agent2Agent エージェント カードを持つエージェントは、テキスト、Base64 イメージ バイナリ、Base64 ファイル バイナリを返します。
接続エージェントの API プラグイン呼び出しを確認するように求めるメッセージが表示されている間、 アダプティブ カード がアクティブなエージェントに送信されます。 ユーザーにはアダプティブ カードが表示されず、ダイアログ ボックスを使用できません。 ただし、アクティブエージェントはアダプティブカードのデータコンテンツを処理します。