Foundry IQは、あなたのエージェントをAzure AI Foundryで構築されたナレッジベースに接続します。 Foundry IQ ナレッジベース は、1つ以上のエンタープライズデータソースと検索および関連性設定を一つの再利用可能な資産にまとめます。 組織内の誰かがすでに構築・調整したナレッジベースに接続すると、エージェントはそのコンテンツに関する質問に答えられます。Copilot Studioでセットアップを再現する必要はありません。
Foundry IQはコンポーネントパネルの ツール ボタンからエージェントに追加されます。
Note
この記事の機能は、GitHub Copilot harnessを搭載するエージェントやワークフローで使用されています。
使用率に基づく請求は、エージェントの使用、構築、テスト、評価に適用されます。 これらの行動はCopilotクレジットを消費することがあります。 詳細は「GitHub Copilot harnessで動くエージェントのコスト管理」をご覧ください。
Foundry IQに接続する際、以下の通りです:
- あなたの組織のチームがすでにAzure AI Foundryであなたのエージェントのドメインに合ったナレッジベースを構築し調整しています。
- エージェントには、Copilot Studioで自分で知識をモデリングするのではなく、そのチームのリトリーバル設定を使ってほしいのです。
Prerequisites
- GitHub Copilotハーネスで作成されたエージェントです。 詳しくは 「エージェント作成」をご覧ください。
- Azure AI Foundry で付与された、少なくとも 1 つの Foundry IQ ナレッジ ベースへのアクセス。 ピッカーには、あなたがアクセスできるナレッジベースのみが表示されます。
Note
エージェントは1エージェントにつきFoundry IQの接続を1つしか持てません。
新しいFoundry IQ接続を作成
- Copilot Studio でエージェントを開きます。
- ビルド タブを選択します。
- コンポーネントパネルで 「ツール 」を選択して「 ツールを追加」 ダイアログを開きます。
- Foundry IQを選択してください。
- [新しい接続を作成する] を選択します。
-
認証タイプを選択してください:APIキー、クライアント証明書認証、サービスプリンシパル(Microsoft Entra IDアプリケーション)、またはMicrosoft Entra ID Integrated。
- APIキーについては、Foundry IQ Search ServiceエンドポイントとAPIキーを入力します。
- クライアント証明書認証には、Foundry IQ Search Serviceエンドポイント、テナントID、クライアントID、クライアント証明書シークレット、証明書パスワードを入力します。
- Service Principalには、Foundry IQ Search Serviceエンドポイント、テナントID、クライアントID、クライアントシークレットを入力します。
- Microsoft Entra ID Integratedの場合は、Foundry IQ Search Serviceエンドポイントを入力してください。
- を選択してを作成します。
- 接続が作成されたら、「 次」を選択します。
- リストからナレッジベースを選択し、エージェント に追加を選択します。
- 保存を選びます。
- 保存後、ビルドタブのツールセクションでFoundry IQ接続が接続されたツールとして表示されます。
- 新たに追加されたFoundry IQ接続を選択し、名前と説明を更新してください。 説明はできるだけ詳細であるべきで、説明はオーケストレーションを助けます。
- 保存を選びます。
Foundry IQの知識源をテストしましょう
- [プレビュー] タブを選択します。
- ナレッジベースが答えられるテスト問題を送ってください。
- 応答のアクティビティ トレースを開きます。
アクティビティトレースでは、Foundry IQが検索ステップを処理し、エージェントに返したアイテムが一覧化されています。 エージェントはそれらの項目を使って回答をまとめます。 トレースにFoundry IQの取得ステップが表示されない場合は、 Build タブでナレッジベースが選択されていること、そして質問がナレッジベースがカバーするデータの範囲内であることを確認しましょう。
Tip
期待通りの結果が得られない場合は、Copilot Studioではなく、ナレッジベース自体をAzure AI Foundryで調整してください。 ナレッジベースの所有者と協力して、情報源や検索手順、ランキングを調整しましょう。
Foundry IQ接続の削除
- ビルドタブでツールを選択してください。
- コンポーネントパネルで接続済みのFoundry IQナレッジベースを選択し、接続を解除するために x を選びます。
Note
Copilot Studioで接続を削除しても、Azure AI Foundryのナレッジベースは削除または変更されません。