Foundry Agent Service に関する一般的な質問に対する回答を見つけます。
この記事で質問に対する回答が見つからない場合でも、ヘルプが必要な場合は、 Foundry Tools のサポートとヘルプ オプションを参照してください。 Foundry Agent Service は Foundry Tools の一部です。
始めるには、以下を参照してください。
セットアップとアクセス
基本的なセットアップと標準セットアップの違いは何ですか?
基本的なセットアップでは 、エージェントの状態が Microsoft が管理するリソースに格納されます。
Standard セットアップ では、機能ホストを介して接続する Azure リソースにエージェント データ (スレッド、ファイル、ベクター ストア) が格納されます。
セットアップ オプションを比較し、適切なものを選択するには、「環境と機能ホストのセットアップ」を参照してください。
必要なアクセス許可 (RBAC ロール) は何ですか？
ロールの要件は、実行している内容によって異なります。 一般的なロールは次のとおりです。
- Azure AI アカウント所有者: アカウントとプロジェクトを作成する
- Azure AI ユーザー: エージェントの作成と編集
- ロール ベースのアクセス制御管理者 (または 所有者): 接続されているリソースにロールを割り当てるための標準セットアップに必要です
標準セットアップの場合は、 Microsoft.Authorization/roleAssignments/write アクセス許可も必要です。
ロールの完全な要件については、Microsoft Foundry の 必要なアクセス許可 と ロールベースのアクセス制御 (RBAC) に関するページを参照してください。
Foundry Agent Service を初めて使用する場合は、どこから始める必要がありますか?
「 環境のセットアップ」から始めて、最初のエージェントを作成します。
- クラシック エクスペリエンス: クイック スタート: 新しいエージェントを作成する
- 新しい Foundry エクスペリエンス: クイック スタート: コードでエージェントの使用を開始する
全般
Foundry Agent Service API で使用されるデータを保存しますか?
Yes. Foundry Agent Service はステートフル API です。つまり、データが保持されます。 Foundry Agent Service API には、次の 2 種類のデータが格納されます。
- ステートフル エンティティ: 使用中に作成された会話と応答。
- ファイルとベクター ストア: Foundry Agent Service のセットアップ中に、または応答生成の一部としてアップロードされたデータ。
会話と応答のしくみについては、 エージェントランタイムコンポーネントを参照してください。
このデータはどこに格納されますか?
- 基本的なセットアップ: データは、論理的に分離されたセキュリティで保護された Microsoft が管理するストレージ アカウントに格納されます。
-
標準セットアップ: データは独自の Azure リソースに格納されるため、完全な所有権と制御が得られます。
- Azure Storage: ファイルと添付ファイル
- Azure Cosmos DB: スレッドと会話の履歴
- Azure AI Search: ベクター ストア
データの格納場所を制御するセットアップ オプションについては、「 環境を設定する」を参照してください。
このデータはどのくらいの期間保存されますか?
明示的に削除しない限り、データは保持されます。 エージェント データを削除するには、API または SDK を使用してスレッド、ファイル、またはベクター ストアを削除します。
概念と用語 (会話や応答など) については、 エージェントランタイムコンポーネントを参照してください。
Foundry Agent Service は CMK 暗号化をサポートしていますか?
- 基本的なセットアップでは、Microsoft マネージド キーのみがサポートされます。
- Standard セットアップでは、カスタマー マネージド キー (CMK) がサポートされます。
Microsoft はモデルのトレーニングに自分のデータを使用しますか?
いいえ。Microsoft では、モデルのトレーニングにデータを使用しません。 詳細については、 責任ある AI のドキュメントを参照してください。
データは地理的にどこに格納されますか?
Foundry Agent Service エンドポイントはリージョンであり、データはエンドポイントと同じリージョンに格納されます。 詳細については、Azure データ所在地のドキュメントをご覧ください。
Foundry Agent Service の料金はどのように請求されますか?
各エージェントで使用している基本モデルの推論コスト (入力と出力) が課金されます (たとえば、gpt-4-0125)。 複数のエージェントを作成した場合、各エージェントにアタッチされている基本モデルに対して課金されます。
コード インタープリター ツールを有効にした場合、セッションごとの使用に対して課金されます。 たとえば、エージェントが 2 つのスレッドでコード インタープリターを同時に呼び出す場合、このアクティビティによって 2 つのコード インタープリター セッションが作成されます。 これらの各セッションには課金されます。
既定では、各セッションは 1 時間アクティブです。 ユーザーが同じスレッドで最大 1 時間コード インタープリターに指示を与え続ける場合、この料金は 1 回だけ支払われます。
ファイル検索は、使用するベクター ストレージに基づいて課金されます。
詳細については、 価格に関するページを参照してください。
Foundry Agent Service を使用する場合、追加の価格またはクォータはありますか?
No. Foundry Agent Service でモデルを使用する場合、すべてのクォータが適用されます。
ツールと統合
コード インタープリターやファイル検索などのツールについては、どこで学習できますか?
ツールの 概要から始めて、ツール固有のガイダンスを参照してください。
エージェント データ用に独自のストレージ、Azure Cosmos DB、または Azure AI Search を使用するにはどうすればよいですか?
機能ホストを使用し、独自のリソースを接続します。
- 概念: 機能ホスト
- 方法: 独自のリソースを使用する
監視と操作
Foundry Agent Service を監視する方法
使用状況と監視のオプションを理解するには、「 メトリック」 および 「サービスの監視」を参照してください。
ビジネス継続性とディザスター リカバリー (BCDR) に対して行う必要がある操作
エージェント サービスの BCDR ガイダンスは、セットアップとプロビジョニングするリソースによって異なります。 現在のガイダンスについては、 エージェントの BCDR を参照してください。
仮想ネットワーク
仮想ネットワークの分離とは
仮想ネットワークは、Azure リソースへの受信および送信アクセスをセキュリティで保護するのに役立ちます。 Azure の仮想ネットワーク統合によってネットワーク分離を実現します。
Agent Service プライベート ネットワークの要件と制限事項については、「 Foundry Agent Service で仮想ネットワークを使用する方法」を参照してください。
サブネットの委任が必要な理由
エージェント サービス ネットワークでは、Azure Container Apps が使用されます。 仮想ネットワークにデプロイするときは、 Microsoft.App/environmentsに委任された専用サブネットを使用する必要があります。
詳細については、「 Foundry Agent Service と仮想ネットワーク構成で仮想ネットワークを使用する方法 」を参照 してください。
仮想ネットワークの分離をサポートするリージョンは何ですか?
仮想ネットワーク分離のリージョンの可用性は変更される可能性があります。 現在サポートされているリージョンと制限事項については、「 Foundry Agent Service で仮想ネットワークを使用する方法」を参照してください。
パブリックまたはプライベートのクラス A、B、C のサブネットでサポートされているクラス範囲は何ですか?
プライベート IP 範囲のみがサポートされています。
- クラス A: 10.0.0.0/8
- クラス B: 172.16.0.0/12
- クラス C: 192.168.0.0/16
パブリック IP 範囲は、エージェント サブネットではサポートされていません。
エージェント サブネットの最小サイズと、いくつの IP を使用する必要がありますか?
推奨される委任されたエージェント のサブネット サイズは /24 です。 最小値は /27 です。
サイズ設定のガイダンスと IP の使用方法については、「Foundry Agent Service と仮想ネットワークの構成で仮想ネットワークを使用する方法」を参照してください。
Foundry Agent Service の仮想ネットワークの最小アドレス範囲と推奨アドレス範囲は何ですか?
エージェント サブネットとプライベート エンドポイントにアドレス空間がある限り、仮想ネットワークのアドレス範囲は何でもかまいません。
ピアリングされた仮想ネットワークを使用できますか? 異なる仮想ネットワークにリソースを含めることができますか?
Yes. 仮想ネットワークはサブスクリプション内にあり、任意の仮想ネットワークとピアリングできる必要があります。 ただし、データ転送にはコストがかかるため、お勧めしません。 要件は、すべてのリソースが Microsoft Foundry リソースと同じリージョンに存在する必要があるということです。
Azure ファイアウォールを使用している場合は、許可リストに FQDN を追加する必要がありますか?
Yes. 「 Azure Container Apps での Azure Firewall の使用」の説明に従って、マネージド ID に必要な完全修飾ドメイン名 (FQDN) を許可するか、 AzureActiveDirectory サービス タグを許可します。
エージェント サービスのプライベート ネットワークガイダンスについては、「 Foundry Agent Service で仮想ネットワークを使用する方法」を参照してください。
複数の Microsoft Foundry リソースで仮想ネットワークを再利用できますか?
はい。複数の Microsoft Foundry リソースで同じ仮想ネットワークを再利用できます。 ただし、各 Foundry リソースには専用のエージェント ランタイム サブネットが必要です。エージェント サブネットを複数の Foundry リソース間で共有することはできません。
仮想ネットワークは Foundry と同じリソース グループに存在する必要がありますか?
同じリソース グループ内に存在する必要はありませんが、同じリージョンに存在する必要があります。
エージェントにツールを追加する場合は、どのような追加構成が必要ですか?
ネットワークで保護されたセットアップを使用している場合、一部のツールでは、プライベート エンドポイントやリソース接続などの追加の構成が必要です。
現在のガイダンスと制限事項については、「 Foundry Agent Service で仮想ネットワークを使用する方法」を参照してください。