チュートリアル: Foundry IQ のプライベート エージェント検索をデプロイする

Important

この一連のチュートリアルでは、エージェント型検索用の 2026-08-01-preview REST API を使用します。 2026-08-01-preview は、Azure サブスクリプションの一部としてユーザーにライセンス付与され、Microsoft製品使用条件Microsoft製品およびサービス データ保護補遺 ("DPA")、および Microsoft Azure プレビューの追加使用条件に適用される条件に従います。

この 3 部構成のチュートリアル シリーズでは、Foundry と Azure AI 検索 を使用して Foundry IQ 用のエンド ツー エンドのプライベート エージェント検索アーキテクチャMicrosoftデプロイする方法について説明します。 受信接続、送信依存関係、および取得ランタイムがデプロイ全体にどのように適合するかを説明します。

このチュートリアルでは、次の操作を行います。

  • Foundry と Azure AI 検索 の間に受信プライベート接続を確立します。
  • Azure AI 検索 からのアウトバウンド プライベート依存関係を構成する。
  • ナレッジ ソース、ナレッジ ベース、プロジェクト接続、およびエージェントを使用して、エンドツーエンドの取得を検証します。

プライベートエージェント型検索とは?

プライベート エージェント型検索は、エージェントがパブリック エンドポイントではなく、プライベート ネットワーク経路を介して知識を取得するパターンです。 このチュートリアルでは、エージェントから検索へのパスとストレージへの検索パスは、プライベート エンドポイント、共有プライベート リンク、およびプライベート DNS ゾーンにとどまります。 Search-to-Foundry 埋め込み依存関係もプライベート送信アクセス用に構成されていますが、インジェスト時間埋め込み呼び出しは現在も Foundry の信頼されたサービス バイパスに依存しています。

Tip

このチュートリアルは、プライベート ネットワーク バージョンのチュートリアルです。Azure AI 検索を使用してエンド ツー エンドのエージェント検索ソリューションを構築します。 どちらのチュートリアルでもマネージド ID とロールベースのアクセスを使用しますが、このバージョンではプライベート接続が重視され、各手順で受信と送信の検証が追加されます。

このチュートリアルのサービス

デプロイでは、次のサービスがプロビジョニングされます。 このチュートリアルでは、各サービスを異なる方法で操作します。

Service 役割
Foundry (リソースとプロジェクト) エージェントのランタイムを調整し、プロジェクト接続、エージェント、およびエージェントを機能させる GPT-5 ファミリ モデルをホストします。 パート 3 では、コンテンツのベクター化に使用Azure AI 検索text-embedding-3-large埋め込みモデルもデプロイします。
Azure AI 検索 プライベート Blob コンテンツをナレッジ ソースに取り込んでベクトル化し、その後、ナレッジ ベースとその MCP エンドポイントを通じてエージェント型検索を提供します。 コンテンツ アクセス用のAzure Blob Storageへのプライベート送信呼び出しを行います。 Foundry 埋め込み依存関係の場合、このチュートリアルではターゲット リソースの openai_account 共有プライベート リンクを使用します。インジェスト時間埋め込み呼び出しは現在、信頼されたサービス バイパスにも依存しています。
Azure Blob Storage ナレッジ ソースが取り込むソース ドキュメントと、エージェント検索用のインデックスを格納します。
Azure Cosmos DB メッセージ、会話履歴、エージェント メタデータなど、標準エージェントセットアップのエージェントの状態を格納します。 デプロイによって自動的にプロビジョニングされ、構成や直接使用は行われません。

このチュートリアルの構成

次の表は、各パートで実行する内容、関連するコンポーネント、および次のパートに進む前に成功を確認する方法を示しています。

要素 結果 Components 成功基準
1 - 受信 Foundry から Azure AI 検索 へのプライベート要求パス。
  • 仮想ネットワークとサブネット
  • プライベート エンドポイント
  • プライベート DNS ゾーン
  • Foundry と Azure AI 検索 プライベート アクセスの設定
VNet 内のクライアントからは、Microsoft Foundry および Azure AI 検索 のエンドポイントはプライベート IP アドレスとして解決され、TCP 443 番ポートで接続を受け付けます。
2 - 送信 Azure AI 検索からAzure Blob Storageおよび Foundry へのプライベート依存関係パス。
  • 共有プライベート リンク
  • ターゲット側の承認
  • 管理されたアイデンティティー
  • Azure Blob Storage と Foundry の依存関係の RBAC
Azure Blob Storage と Microsoft Foundry の共有プライベート リンクは Approved の状態を示しており、Azure AI 検索 のマネージド ID は、割り当てられた Blob ロールとモデル ロールを保持しています。
3 - 取得の検証 プライベートな検索経路を通じて、根拠に基づく回答を返すエージェント。
  • 知識源
  • ナレッジベース
  • プロジェクト接続
  • エージェントの構成
検証プロンプトは、ソース ドキュメントへの引用と共に、BLOB コンテンツに基づいて回答を返します。

次のステップ