Microsoft Foundry エージェントに接続する (プレビュー)

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

Microsoft Foundry Agent をカスタム エージェントに接続して、このエージェントを呼び出してユーザーまたはトリガーに応答できるようにします。

前提条件

Microsoft FoundryエージェントをCopilot Studioに接続する前に、FoundryエージェントがActivityプロトコルエンドポイントを有効にしている必要があります。 新たに作成されたFoundryエージェントは、デフォルトで Responses と A2A プロトコルのエンドポイントのみを公開します。 Activityエンドポイントが有効でない場合、Copilot Studioへの接続は実行時に400エラーで失敗します。 詳しくは「Foundry エージェントで受信 A2A を有効にする」をご覧ください。

現在、ActivityエンドポイントはREST APIまたはPython SDKを使ってプログラム的に有効化できます。 Microsoft Foundryポータルから有効化するオプションはありません。 「 エージェントの設定と共有」でイネーブルメント手順について詳しく学びましょう。

アクティビティエンドポイントを有効にした後も、Foundryポータルの エージェントのエンドポイント セクションは引き続き Responses と A2Aのみを表示します。 このUIの欠落は予想されており、変更が失敗したわけではありません。 アップデート後はCopilot Studioとの接続が正常に動作します。

Microsoft Foundry エージェントに接続する

1. メイン エージェントのエージェント ページに移動し、エージェントの追加を選択します。

2. 外部エージェントへの接続 で、使用可能なエージェントの種類から Microsoft Foundry を選択します。

3. 使用可能な接続の一覧から目的の接続を選択するか、Microsoft Foundry と Copilot Studio エージェントの間に新しい接続を作成します。 新しい接続を作成するには、Foundry プロジェクト エンドポイント URL を指定する必要があります。

   Note

   Copilot Studio から Microsoft Foundry エージェントに接続する場合、新しい Microsoft Foundry ポータルで作成されたエージェントにのみ接続できます。 前のポータルで作成したエージェントに接続すると、 404 - Version not foundを示すエラーが発生します。

4. 接続が作成されたら、 次へ を選択します。

5. SDK エージェントの適切な 名前 と 説明 を入力します。 この説明では、Microsoft Foundry エージェントの目的を記述し、メイン エージェントが使用するタイミングを理解できるようにする必要があります。 詳細については、効果的なメタデータの書き方 を参照してください。

6. 接続する Microsoft Foundry エージェントの エージェント ID を入力します。

7. 必要に応じて説明を調整して、メインエージェントの文脈に合ったものにしましょう。 たとえば、説明が重複する可能性がある他のツールやエージェントがある場合は、説明をより具体的にします。 説明を更新して、Copilot Studioがこのエージェントを呼び出すタイミングを理解できるようにしてください。

8. エージェントの追加 を選択します。

9. エージェントが作成されたら、すぐにエージェントをテストできます。 後で エージェント ID を調整する必要がある場合は、詳細ページで エージェント リストからエージェントを選択します。