エージェントに接続済みエージェントを追加する (GitHub Copilot)

接続エージェントを使って、プライマリ エージェントが特定のタスクを専門エージェントに委任できるようにします。 この記事では、もう一つの公開されたCopilot Studioエージェントを接続エージェントとして追加し、委任が期待通りに機能しているかを確認する方法を紹介します。

Note

このエージェントを構築するために使われるフレームワークは使用量ベースの請求を採用しています。 エージェントの使用、構築、テスト、評価にはCopilotクレジットが消費されることがあります。 使用 量ベースの請求の概要についてはこちらをご覧ください。

各接続済みエージェントは、同じ「接続されたエージェントを追加」ダイアログから追加します。 このガイダンスは、エージェントがCopilot Studioで構築されている場合でも、Microsoft Foundryでホストされている場合でも、Agent2Agent(A2A)プロトコルを介してアクセスされている場合でも適用されます。 この記事では、Copilot Studio のエージェントの接続について説明します。 代わりにMicrosoft Foundryエージェントを接続するには、「Microsoft Foundryエージェントを接続エージェントとして追加」をご覧ください。 A2Aプロトコルを介してリモートエージェントを接続するには、「 接続されたエージェントとしてA2Aエージェントを追加する」を参照してください。 Microsoft 365 エージェント SDKで構築されたエージェントを接続するには、「Add a Microsoft 365 エージェント SDK agent as a connected agent(接続エージェントとして追加)」をご覧ください。

Prerequisites

  • GitHub Copilotハーネスで作成されたエージェントで、メインエージェントとして設定されました。 エージェントを作成する (プレビュー) を参照してください。
  • 同じ環境でGitHub Copilotハーネスを搭載した少なくとも1つのエージェントが存在します。 他のエージェントは公開され、接続可能として設定されている必要があります。
  • 主エージェントの作成者は、接続するエージェントの所有者であるか、またはそのエージェントが作成者に共有されている必要があります。

Note

親エージェントへのアクセスが自動的に接続されたエージェントへのアクセスを付与するわけではありません。 接続された各エージェントを、すべての対象ユーザーまたはグループと個別に共有してください。

Copilot Studio エージェントを追加する

  1. Copilot Studio にサインインします。

  2. プライマリ エージェントとして使用したいエージェントを選択して開いてください。

  3. エージェントナビゲーションバーで「 ビルド 」タブを選択します。

  4. コンポーネント パネルで接続されたエージェントを選択し、接続済みエージェントを追加ダイアログを開きます。

  5. 「接続するエージェントの追加」ダイアログから、利用可能な Copilot Studio エージェントを閲覧または検索し、接続したいエージェントを選択します。

  6. エージェントの機能を確認し、接続エージェントをいつ使用すべきかの明確な説明を加えましょう。

  7. 接続を選択します。

  8. 接続済みエージェントがコンポーネント パネルに表示されているか確認してください。

オーケストレーターが接続されたエージェントにルーティングする方法

接続されたエージェントを追加すると、オーケストレーション ランタイムがいつそのエージェントに処理を委任するかを自動的に決定します。 ルーティングの判断基準は以下の通りです:

  • 接続済みエージェントの名前と説明
  • ユーザーのメッセージと会話のコンテキスト
  • プライマリ エージェントの指示

Tip

接続された各エージェントについて明確かつ具体的な説明を作成し、オーケストレーターがリクエストのルーティング先を正確に判断できるようにしてください。 接続されたエージェントの説明が重複しないようにしてください。

テストの委譲

接続されたエージェントを追加した後:

  1. エージェント ナビゲーション バーで、プレビュー タブを選択します。

  2. 接続されたエージェントのドメインに適したメッセージを送りましょう。

  3. 応答が接続されたエージェントから届いており、適切であることを確認しましょう。

  4. 接続されたエージェントのドメイン外にメッセージを送り、プライマリエージェントがそれを処理できることを確認してください。