Microsoft Foundry Agent Service では、迅速なプロトタイプ作成のための完全パブリック セットアップから、独自の仮想ネットワーク内でのネットワーク分離を完了するまで、いくつかのネットワーク オプションがサポートされています。 この記事では、オプションを比較し、各オプションを共通の目標にマップし、選択したオプションのデプロイ テンプレートと構成ガイドを示します。
オプションを選択したら、リンクされた方法に従ってデプロイし、デプロイを検証します。 問題が発生した場合は、リンクされたトラブルシューティング ガイダンスを使用してください。
既定のネットワークの動作
ネットワーク構成なしで Foundry リソースを作成すると、完全にパブリックなベースラインが得られます。
- 受信: Foundry エンドポイントにパブリック インターネット経由で到達できます。 有効な資格情報とエンドポイント URL を持つ任意の呼び出し元に到達できます。
- アウトバウンド: エージェントはパブリック ネットワーク経由でデータと Azure リソースにアクセスでき、インターネットからアクセス可能なエンドポイントにのみアクセスできます。
- ストレージ: エージェントの状態では、既定でMicrosoftマネージド ストレージが使用されます。 独自のストレージやその他のAzure リソースを持ち込む場合は、ネットワークセットアップの一環として、それらのリソースへのネットワーク アクセスを構成します。
次のセクションのいずれかのオプションを選択するまで、プライベートな内容はありません。 各オプションは、受信側、送信側、またはその両方を変更します。
ネットワーク オプション
ネットワーク構成では、次の 2 つの関連する決定が組み合わせられます。
- 送信 (エグレス) アクセス: エージェントがデータやその他のAzure リソースに到達する方法。 この決定によって、主な分離が決まります。エグレスをパブリックにするか、仮想ネットワークに限定して、トラフィックがプライベート ネットワークに残るようにします。 仮想ネットワークは、お客様が持ち込んで管理するもの (BYO 仮想ネットワーク) または Microsoft が管理するもののいずれかです。
- 受信アクセス: Foundry エンドポイントにアクセスできるネットワーク パブリック (オプションで選択した IP アドレスに制限されます) またはプライベート エンドポイント経由のプライベート。
2 つの決定が結び付いています。 仮想ネットワークでエグレスを分離すると、Foundry エンドポイントへの受信アクセスもプライベート エンドポイントを経由します。これは、その仮想ネットワーク内のリソースがプライベート ネットワーク経由でエンドポイントに到達するためです。 エグレス モデルから始めます。これは、選択によって分離と使用可能な受信オプションが決まるからです。 次の表は、3 つのエグレス モデルと、各モデルで利用可能な受信オプションを示しています。
| エグレス モデル | インバウンドの選択肢 | 最適な用途 |
|---|---|---|
| パブリック エグレス | パブリック (必要に応じて選択された IP アドレス)、または仮想ネットワーク内のプライベート エンドポイント | エグレス経路の遮断なし。 プロトタイプ作成とテストにはパブリック受信を使用し、エグレスがパブリックのまま呼び出し元を制限するにはプライベート エンドポイントを使用します。 |
| BYO 仮想ネットワーク | 仮想ネットワーク内のプライベート エンドポイント | IP 範囲、ピアリング、ルーティングを制御する完全な分離。 エージェントは、委任して管理するサブネットに挿入されます。 |
| マネージド仮想ネットワーク | 仮想ネットワーク内のプライベート エンドポイント | IP 範囲を管理しない完全な分離、または IP 領域が重複する場合。 エージェントは、Microsoftマネージド仮想ネットワークで実行されます。 |
パブリック エグレスでは、プライベート エンドポイントを追加すると、着信パスのみがセキュリティで保護されます。呼び出し元は Foundry エンドポイントにプライベートに到達しますが、エージェントのエグレスは分離されません。
BYO 仮想ネットワークを使用すると、独自のデータ リソースを持ち込んだり、プラットフォームで管理されるデータ リソースを使用したりできます。 詳細については、「 独自の仮想ネットワークの持ち込み要件」を参照してください。
Note
ネットワーク分離は、Foundry アカウントとプロジェクト レベルで適用されます。 これには、ホストされているエージェント、プロンプト エージェント、およびアカウント内の他の Foundry リソースが含まれます。 2 種類のエージェントは、分離されたセットアップ内でネットワーク リソースを異なる方法で使用します。 詳細については、 Foundry Agent Service ネットワークの詳細を参照してください。
シナリオ別のネットワーク オプション
次の表は、一般的な目標を推奨オプションとデプロイ テンプレートにマップします。 コードとしてのインフラストラクチャ テンプレートは、Foundry サンプル インフラストラクチャセットアップ リポジトリ (Bicep、Terraform ミラーを使用) にあります。
| あなたの目標 | 推奨されるオプション | を使用してデプロイする |
|---|---|---|
| 動作するエージェントへの最短ルート、分離なし | パブリック、Microsoftマネージド ストレージ | 最初のホステッド エージェント のクイックスタートをデプロイする (Azure Developer CLI または VS Code) |
| エージェント データを独自のAzure リソースに保持し、分離しない | パブリック、顧客所有ストレージの持ち込み（標準） | 41-standard-agent-setup |
| エンドポイントを呼び出すことができるユーザーを制限します。パブリック エグレスは許容可能です | プライベート エンドポイントを使用したパブリック エグレス | 10-private-network-basic |
| パブリック エグレスなしで完全に分離し、ネットワークを制御し、独自のデータ リソースを持ち込みたい | 持ち込みデータ リソースを使用する BYO 仮想ネットワーク (ネットワークで保護された標準) | 15-private-network-standard-agent-setup |
| パブリック エグレスなしで完全に分離し、ネットワークを制御しますが、データ リソースを管理したくない | プラットフォームで管理されるデータ リソースを含む BYO 仮想ネットワーク | 11-private-network-basic-vnet |
| 完全に分離されますが、IP 範囲を管理できないか、IP アドレス空間が重複しています | 管理された仮想ネットワーク | 18-managed-virtual-network |
| API ゲートウェイの背後での完全な分離 | Azure API Managementを使用した BYO 仮想ネットワーク | 16-private-network-standard-agent-apim-setup |
| エージェントからオンプレミス リソースにアクセスする | BYO 仮想ネットワークと VPN または ExpressRoute |
15-private-network-standard-agent-setup に加えて 、オンプレミス リソースにアクセスする |
完全なテンプレート カタログと各テンプレートのプロビジョニングについては、 インフラストラクチャのセットアップ README を参照してください。
Bring Your Own 仮想ネットワークの要件
BYO 仮想ネットワークとマネージド仮想ネットワークの両方で、完全な分離が提供されます。 違いは、誰がネットワークを運用するかです。マネージド仮想ネットワークでは、このセクションの要件への対応は Microsoft が自動的に行います。 既に管理しているネットワーク (独自の IP 範囲、ファイアウォール、ピアリング、ルーティング) を完全に制御する場合は、BYO 仮想ネットワークを選択します。
BYO 仮想ネットワークを選択する場合は、デプロイする前にこれらの要件を計画してください。 セットアップ手順と詳細解説で、それらについて詳しく説明しています。
- 専用の委任されたサブネット。 サブネットを
Microsoft.App/environmentsに委任します。 サブネットを複数の Foundry リソースで共有することはできません。 予想されるスケールに合わせてサイズを変更します。 「サブネット のサイズを計画する」を参照してください。 - RFC 1918 のアドレス空間のみ。
10.0.0.0/8、172.16.0.0/12、または192.168.0.0/16を使用します。 パブリック範囲と CGNAT 範囲はサポートされていません。 クラス A (10.x) の範囲は、特定のリージョンでのみ使用できます。 - データ リソースの選択。 BYO 仮想ネットワークでは、エージェント データ リソース (Azure Storage、Azure AI 検索、Azure Cosmos DB) を提供する方法を選択します。
- プラットフォームで管理されるデータ リソース。 独自のものを持ち込んだり構成したりしないように、マルチテナントのプラットフォームで管理されるデータ リソースを使用します。 このオプションは、エージェントがカスタマー マネージド データ リソース (多くのホスト型エージェント シナリオなど) を必要としない場合や、Azure Cosmos DBなどのリソースの容量計画を回避する場合に選択します。 このオプションを選択すると、使用しないデータ リソースを設定する必要がなくなります。
- 独自のデータ リソースを持ち込みます。 独自のAzure Storage、Azure AI 検索、およびAzure Cosmos DBを使用して、すべてのエージェント データがテナント内に維持されるようにします。 所有および管理するリソースにエージェント データが必要な場合は、このオプションを選択します。
- Foundry アカウントのプライベート エンドポイントとプライベート DNS ゾーン、および持ち込むデータ リソースごとに、名前解決は仮想ネットワーク内にとどまります。
- Foundry リソースと仮想ネットワークに対して同じリージョン。 その他のリソースは異なるリージョンに存在する可能性があります。リージョン間のコストへの影響があります。
Important
Foundry アカウントを作成するときに、仮想ネットワークの構成を設定します。 ネットワークインジェクションは、リソースの作成フローの一部であり、既存のアカウントに追加することはできません。 ネットワーク構成は、最初のホストされたエージェントを作成するときに有効になり、後でネットワークインジェクションを変更することはできません。 別のネットワーク構成に移動するには、新しいプロジェクトを作成します。 構成はアカウント レベルで適用されるため、ホストされるエージェントとプロンプト エージェントの両方が対象になります。 アカウントを作成する前に、BYO 仮想ネットワークを決定します。
BYO 仮想ネットワーク オプション (委任されたサブネット、ホストされたエージェントマイクロ VM、およびデータ リソースへのプライベート エンドポイント) のトポロジ図については、 Foundry Agent Service ネットワークの詳細を参照してください。
ネットワーク分離を使用したツールのサポート
すべてのエージェント ツールがネットワーク分離をサポートしているわけではありません。 一部のツールは仮想ネットワークの背後でサポートされておらず、プライベート ネットワークではなくパブリック インターネット経由で宛先に到達するツールもあります。 分離されたセットアップにコミットする前に、 ネットワーク分離を使用してエージェント ツール を確認し、エージェントが使用するツールがサポートされていることを確認します。
サブネット のサイズを計画する
サブネットは少なくとも /27 である必要があり、割り当てた後はサイズを変更できないため、予想されるスケールに合わせてサイズを変更できます。 Foundry アカウント内のすべてのプロジェクトがサブネットを共有するため、アカウント内のすべてのプロジェクト、エージェント、および同時セッションの組み合わせ使用を計画します。 Azureでは、内部使用のためにすべてのサブネットに 5 つの IP アドレスが予約されます。
- ホストされるエージェントは 、独自のネットワーク インターフェイスを持つ専用の Micro VM で実行されるため、それぞれがサブネットから IP アドレスを使用します。 IP 使用率は、プロジェクトの数、各プロジェクトのホストされているエージェント、およびそれらの同時セッションに応じてスケーリングされます。 また、新しいリビジョンでは、古いリビジョンと新しいリビジョンが並行して実行されるときに、ロールアウト中に IP アドレスが一時的に使用されます。
- プロンプト エージェント は、リビジョンごとに IP アドレスを使用しません。 実行するプロンプト エージェントまたはリビジョンの数に関係なく、IP アドレスの小さな静的プール (プロジェクトあたり最大約 10 個) が使用されます。
| サブネットのサイズ | レコメンデーション |
|---|---|
| /24 | ホスト型エージェントを使用した運用環境に推奨されます。 複数のプロジェクトにまたがるホスト型エージェントのスケール拡張、同時セッションのサポート、インプレース アップグレードへの対応に備えて、余力を確保します。 |
| /27 | サポートされる最小値。 プロンプト エージェントを実行するとき、または小規模なホステッド エージェントのデプロイを実行する場合に、運用環境で機能します。 ホスト型エージェントと同時セッション数をスケーリングするための余裕が少なくなります。 |
IP 割り当てモデル、同時セッション制限、およびサイズ計算については、 Foundry Agent Service ネットワークの詳細を参照してください。
ホストされたエージェントとプロンプト エージェントの比較
ネットワーク オプションは Foundry アカウント全体に適用されますが、「 サブネット サイズの計画」の説明に従って、2 つのエージェントの種類でネットワーク リソースが異なる方法で消費されます。 どちらの種類も、仮想ネットワーク内のプライベート エンドポイントを介してリソースに到達します。
次のステップ
- セットアップ方法またはテーブルのテンプレートを使用してオプションをデプロイします。
- デプロイを検証します。サブネットの委任、パブリック アクセスが無効になっていることを確認し、エンドポイントが仮想ネットワーク内からプライベート IP アドレスに解決されることを確認します。 デプロイの確認を参照してください。
- トラブルシューティング ガイドを使用して、デプロイまたは接続エラー のトラブルシューティングを行います。