Microsoft Foundry のエージェント

Foundry Agent Service は、AI エージェントを構築、デプロイ、スケーリングするためのマネージドプラットフォームです。任意のフレームワーク、Foundry モデルカタログからサポートされているモデル、およびモデル推論とツールの 1 つのエントリポイントを使用してビルドします。

Foundry は、プロンプトエージェントまたは音声ベースのプロンプトエージェントを定義し、Foundry で実行したり、独自のコードをホストされたエージェントとしてパッケージ化したり、既に別の場所で実行しているエージェントから Responses API を呼び出したりするなど、宣言型から完全なコードまで、さまざまな範囲でユーザーを満たします。ビルド方法を選択すると、各パスがカバーされます。

エージェントサービスの概要

コンポーネント	それが何をするか
エージェントランタイム	ホストとスケールは、プロンプトエージェントとホスト型エージェントを呼び出します。会話、ツール呼び出し、エージェントのライフサイクルを管理します。
ツールボックス	Web 検索、ファイル検索、コードインタープリター、MCP サーバー、カスタム関数など、一連のツールを 1 回キュレーションします。その後、一元化された認証、ガバナンス、およびバージョン管理を使用して、単一のマネージド MCP エンドポイントを介してエージェント間でそれらを共有します。
モデル	GPT-4o、Llama、DeepSeek など、Foundry モデルカタログの多くのモデルで動作します。エージェントコードを変更せずにモデルをスワップします。
可観測性	エンドツーエンドのトレース、メトリック、評価、Application Insights の統合。エージェントが行うすべての決定を確認し、その品質を測定します。
最適化	エージェントオプティマイザー (プレビュー) は、エージェントの動作を評価し、プロンプトエージェントとホステッドエージェントのより優れた命令、スキル、ツールの説明、モデルの選択を自動的に生成します。
ID とセキュリティ	Microsoft Entra の ID、RBAC、コンテンツフィルター、仮想ネットワークの分離。エンタープライズレベルの信頼が組み込まれています。
公開	エージェントをバージョン管理し、安定したエンドポイントを作成し、Microsoft Teams、Microsoft Copilot、および Entra エージェントレジストリを使用して共有します。

ビルド方法を選択する

Tip

初めてエージェントを作成しますか? Foundry ポータルまたはコードを使用してプロンプトエージェントを作成するためのクイックスタートを使用して、プロンプトエージェントから始めます。

Foundry では、1 つのモデル呼び出しから完全にコンテナー化されたエージェントまで、いくつかの方法でビルドできます。実行しようとしている内容に基づいてパスを選択します。

テキストの管理を最小限にしますか?プロンプトエージェントから開始します。手順、モデル、およびツールを構成する。Foundry では、コードやインフラストラクチャなしで実行されます。
管理されたリアルタイム音声エクスペリエンスが必要ですか?音声ベースのプロンプトエージェントを作成します。音声エクスペリエンスを構成し、オーケストレーションコードを自分でホストせずに Voice Live 経由で接続します。
Foundry でフルコントロールが必要ですか?ホストされているエージェントをデプロイします。独自のコードとフレームワークをコンテナーとして使用する。Foundry では、マネージドエンドポイント、スケーリング、ID を使用して実行されます。
他の場所でエージェントコードを既に実行していますか?管理するエージェントリソースなしで Foundry モデルとツールを使用するには、Responses API を直接呼び出します。

プロンプトエージェント、音声ベースのプロンプトエージェント、およびホストされるエージェントは、この概要で説明するエージェントの種類です。次のセクションでは、信頼して選択できるように、それぞれの値を分割します。

エージェントの種類

エージェントサービスには、3 種類のエージェントが用意されています。選択すると、ビルドする量と Foundry が管理する量が設定されます。

プロンプトエージェント: 最速のパス。命令、モデル、ツールを定義すると、Foundry は管理するコードやインフラストラクチャなしでエージェントを実行します。
音声ベースのプロンプトエージェント: 管理されたリアルタイム音声エージェント。モデル、命令、オーディオ、およびツールを構成し、Voice Live を介してエージェントに接続します。
ホストされるエージェント: 最も制御が多いエージェント。独自のコードとフレームワークを持ち込み、Foundry はマネージドエンドポイント、スケーリング、ID を持つコンテナーとして実行します。

プロンプトエージェント

指示、モデルの選択、ツールなど、構成を通じてプロンプトエージェントを完全に定義します。クイックスタート用に Foundry ポータルで作成するか、SDK または REST API を使用してプログラムで定義して CI/CD ワークフローと統合します。いずれの場合でも、Foundry がエージェントを実行します。保守するアプリケーションコードはなく、セキュリティを最適化、スケーリング、監視するためのコンテナーやパッケージもありません。

開始する 2 つのパス:

ポータル優先: Foundry ポータルで対話形式でエージェントを作成し、プレイグラウンドでテストしてから、アプリケーションコードから呼び出します。
コード優先: デプロイパイプラインで SDK または REST API を使用してエージェントを定義し、バージョン管理、コードレビュー、自動ロールアウトを有効にします。

最適な用途: すぐに使い始めたい場合、内部ツール、本番環境のエージェントでカスタムのオーケストレーションロジックを必要としない場合、そしてインフラ管理の負担がないマネージドランタイムを求めるチーム。

音声対応プロンプトエージェント

音声ベースのプロンプトエージェントは、リアルタイムの話し合いのためのマネージドエージェントです。エージェント定義でモデル、命令、オーディオ設定、オプションのあいさつ文、およびツールを構成します。 Foundry Agent Service はエージェントのライフサイクルを管理し、音声認識、ターンテイク、モデル操作、音声合成に Voice Live を使用します。

音声ベースのプロンプトエージェントは、マネージドモデルと、サポートされている場合は独自のモデルデプロイをサポートします。個々のテキスト要求を送信する代わりに、リアルタイムの WebSocket 経由でエージェントに接続します。セットアップとサポートされているクライアント言語については、「クイックスタート: 音声ベースのプロンプトエージェントを作成する」を参照してください。音声アーキテクチャ、リソース、および現在のプレビューの制限については、「音声ベースのエージェントのしくみ」を参照してください。

最適な用途: 音声オーケストレーションサービスを自分で実装せずに、低待機時間のオーディオ操作を必要とする顧客向けの音声エクスペリエンス、コールセンターシナリオ、アプリケーション。

ホスト型エージェント

Hosted agents は、Agent Framework でビルドするコードベースのエージェントです。 LangGraph、OpenAI Agents SDK、Anthropic Agent SDK、GitHub Copilot SDK、または独自のコード。エージェントをソースコードのコンテナーイメージまたは .zip ファイルとして配布します (.zip ファイルを持ち込むと、Foundry によってイメージが自動的にビルドされます)。Foundry では、マネージドエンドポイント、自動スケーリング、専用のMicrosoft Entra ID、セッションレベルの状態の永続化、エンドツーエンドの可観測性を使用して実行されます。

内部的には、エージェントコードは Foundry プロジェクトエンドポイントを呼び出してモデル推論とツールオーケストレーションを行います。このエンドポイントを使用すると、カタログから Foundry モデルにアクセスできます。また、ファイル検索、コードインタープリター、Web 検索などの標準ツール、SharePoint、WorkIQ、Fabric IQ などの追加のツールなど、プラットフォームツールの統合セットにアクセスできます。

最適な用途: 独自のカスタムコードを呼び出すエージェント向け。次いで、カスタムオーケストレーションロジック、マルチエージェントシステム、カスタムプロトコル（Webhook、音声、AG-UI）など、Foundry にホスティング、スケーリング、ID 管理を任せながら、エージェントロジックを完全に制御したいケースにも適しています。

エージェントの種類を比較する

	プロンプトエージェント	音声対応プロンプトエージェント	ホスト型エージェント
作成画面	ポータル、SDK、または REST	ポータル、SDK、または REST を使用したエージェント定義	Agent Framework、LangGraph、OpenAI Agents SDK、Anthropic Agent SDK、GitHub Copilot SDK、カスタムコード
Foundry モデル + プラットフォームツール	はい	はい(Voice Live および構成済みのエージェントツールを使用)	はい (Foundry プロジェクトエンドポイントの Responses API を使用)
スキルのサポート	はい	はい	はい
保守対象のランタイムコード	なし	マネージド音声オーケストレーションにはありません	はい、エージェントロジック
管理のためのコンピューティング	なし、完全マネージド	なし、完全マネージド	コンテナーコンピューティング、Foundry マネージド
マネージドエンドポイント	はい	はい、リアルタイムの WebSocket	はい
Autoscale	自動、Foundry管理: 要求量に応じて拡張可能	Foundry and Voice Live によって管理される	自動、Foundry マネージド。セッションおよび要求ボリュームごとにコンテナーインスタンスをスケーリングする
エージェント ID (Entra)	はい	はい	各エージェント専用の自動設定
コストモデル	呼び出しごとの推論とツールの使用	ライブ音声とモデル利用、サービスの料金を見る	呼び出しごとの推論 + ツール使用量 + コンテナーコンピューティング
最適な用途	迅速な立ち上げ、カスタムオーケストレーションを必要としない運用エージェント	音声オーケストレーションコードをホストしないリアルタイムの音声操作	カスタムコードを呼び出すエージェント。2 次的に、カスタムオーケストレーションロジック

エフェメラルエージェントに Responses API を使用する

独自のコードから Responses API を直接呼び出すと、エージェントの定義 (命令、ツール、モデル) が Foundry の永続化されたリソースとしてではなく、アプリケーションコード内に存在する エフェメラルエージェントを構築します。各呼び出しでは、プロセス内でエージェントがアセンブルされ、Responses API に対して実行されるため、Foundry で作成、更新、または削除するエージェントはありません。

このパターンは、次の場合に使用します。

アプリに付属するエージェントロジック。 定義バージョンは、他のユーザーがアプリと同期し続ける必要がある個別の Foundry リソースとしてではなく、ソース管理とコードレビューを通じてコードの残りの部分と共に行われます。
リソースのオーバーヘッドのない Foundry 機能。 カタログモデル、プラットフォームツール、プロジェクトスコープデータ、On-Behalf-Of 認証、プロジェクトレベルの可観測性とガバナンスは引き続き取得できます。すべてFoundry プロジェクトのエンドポイントを通じて。

詳細については、「クイックスタート: Responses API を使用する」を参照してください。

音声ベースのエージェントのしくみ

音声ベースのプロンプトエージェントは、リアルタイムの音声会話を実行します。 Foundry ポータルまたは SDK を使用してエージェントを構成し、マイクを使用してテストし、ブラウザーエクスペリエンスまたは電話番号チャネルを使用できるようにします。 Foundry はエージェントのライフサイクルと音声オーケストレーションを管理するため、そのインフラストラクチャは自分でホストしません。

Important

音声ベースのエージェントと、関連する監視、評価、アバター、WebRTC、テレフォニー機能の一部がプレビュー段階にあります。プレビュー機能は、サービスレベルアグリーメントなしで提供され、サポート、セキュリティ、コンプライアンス、可用性の要件を確認するまで、運用環境のワークロードには推奨されません。

音声ベースのエージェントでは、2 つのモデルアーキテクチャがサポートされています。

自然な音声対音声

Caller audio
  -> realtime speech model
  -> spoken response

このアーキテクチャは、自然で待機時間の短い会話用に最適化されています。リアルタイムモデルは、音声入力と出力を直接処理します。サポートされる設定と音声ファミリは、選択したモデルによって異なります。

カスケードテキストモデル

Caller audio
  -> speech recognition
  -> text model
  -> speech synthesis
  -> spoken response

このアーキテクチャでは、より広範なテキストモデルとAzure音声の選択肢が提供されます。また、文字起こし、フレーズリスト、ターン検出、中間応答を明示的に制御することもできますが、各ステージはエンドツーエンドの待機時間に影響します。

コアリソース

ポータルで作成される一般的な音声エージェントでは、次の機能が使用されます。

Foundry リソースとプロジェクト。
バージョン管理された音声ベースのプロンプトエージェント。
フルマネージドの Voice Live モデル、または対象となるお客様がデプロイしたモデル。
選択したアーキテクチャで必要とされる場合の、Foundry Tools の Azure Speech による文字起こしまたは音声合成機能。
トレース、監視、評価データ向けの Application Insights。
Teams Phone 拡張の着信通話向けの Azure Communication Services および Azure Event Grid、または Twilio 電話番号チャネル向けの Twilio プロジェクトへの接続。

フルマネージドの Voice Live モデルを使用する場合は、個別のオーディオモデルをデプロイする必要はありません。モデルの可用性と動作は、リソースとリージョンに対して動的に読み込まれます。

現在のポータルで境界をサポートする

能力	現在の音声ベースの動作
ブラウザーのテスト	エージェントのプレイグラウンドからサポートされています。
Web アプリのプレビュー	エージェントエンドポイントが応答プロトコルをサポートしている場合に使用できます。
電話番号	Teams Phone の拡張性と Twilio。
ダイレクト SIP	現在、サポートされている顧客フローとして提供されていません。
Microsoft Teams および Microsoft 365 Copilot アプリの公開	現在、標準のテキストエージェントカードは、音声ベースのチャネルレイアウトには表示されません。これは電話統合パスとして記述しないでください。
アバター	WebRTC 経由のブラウザービジュアル出力。電話の発信者は音声のみを受信します。
Monitoring	音声固有の概要カード、トークンの内訳、接続の待機時間のグラフには、Application Insights が必要です。
トレース	音声トレースには Responses API `response_id`がないため、音声トレースでは単一のトレース指向ビューが使用されます。
評価	既存の会話からの完全な会話評価がサポートされています。音声エージェントでは、単一ターン評価とシミュレートされた会話の評価は現在サポートされていません。
トレースからのデータセットの作成	現在、トレースページアクションは音声エージェントでは使用できません。

可用性と料金

可用性は、Foundry リソースリージョン、選択したモデル、選択した音声、サブスクリプション、および有効なプレビュー機能によって異なります。特定のモデルに依存する前に、ポータルを確認します。

潜在的な料金には、生成 AI モデルの入力と出力、音声認識と合成、カスタム音声トレーニングとホスティング、アバターの使用、Application Insights のインジェストとリテンション、Azure Communication Services通話と電話番号、Microsoft Teamsとテレフォニーサービス、接続されたツールとデータサービスが含まれます。コストの詳細については、音声ベースのエージェントの価格に関するページを参照してください。

音声対応エージェントのドキュメント

Article	この用途:
音声ベースのプロンプトエージェントを作成する	マネージド音声エージェントを作成し、ライブセッションに接続して、音声ターンを完了します。
音声エージェントを構成する	モデルを選択し、文字起こし、言語、音声、アバター、ターン検出、オーディオ強化、中間応答、ツールを構成します。
テレフォニーチャネルを統合する	Teams Phone の拡張性または Twilio を音声エージェントと統合します。
音声エージェントのトレース、監視、評価	音声会話をトレース、監視、評価します。
音声ベースのエージェントのベストプラクティス	命令、待機時間、認識、安全性、プライバシー、ハンドオフ、テスト、リリースコントロールを適用します。

モデルサポート

Agent Service は、Foundry モデルカタログで使用できる多くのモデルで動作します。完全な一覧については、 Foundry ポータルを参照してください。

ツールとツールボックス

エージェントは 、ツールを使用して世界に作用します。 Foundry には、Web 検索、ファイル検索、コードインタープリター、メモリなどの組み込みツールが用意されていますが、関数、OpenAPI 仕様、MCP サーバーを使用してカスタムツールを追加することもできます。完全なセットについては、ツールボックスの概要を参照してください。

ツールボックスは、これらのツールを単一の再利用可能な単位にグループ化します。ツールを 1 回キュレーションすると、Foundry は、フレームワークに関係なく、任意のエージェントまたはランタイムが使用できる 1 つのマネージド MCP 互換エンドポイントの背後にそれらを公開します。ツールボックスは認証、ガバナンス、およびバージョン管理を一元化するため、すべてのエージェントを再処理するのではなく、1 か所でツールを更新できます。新しいバージョンを作成し、テストし、準備ができたら既定に昇格します。詳細については、「 Foundry のツールボックスとは」を参照してください。

MCP リモートサーバーに接続して認証する

Foundry では、Azure DevOps MCP サーバーなど、エージェントに追加できるリモート MCP サーバーがサポートされています。 Azure DevOps組織を接続してエージェントアクセスを有効にし、エージェントが実行できるアクションを制御するために使用可能なツールのサブセットを構成します。 Functions MCP Webhook エンドポイント (/runtime/webhooks/mcp) を使用して、Azure Functionsでホストされているカスタム MCP サーバーを接続して、カスタムツールをエージェントに公開することもできます。

MCP サーバーとその他のツール接続でサポートされる認証オプションは次のとおりです。

キーベースのアクセス
Microsoft Entra (エージェントのマネージド ID またはプロジェクトのマネージド ID を使用)
OAuth ID パススルー (On-Behalf-Of)
必要に応じて、認証されていないアクセス

これらの認証オプションは、ツール構成で管理されている資格情報とスコープを使用してリモート MCP サーバーを接続する場合にも適用されます。

開発ライフサイクル

Agent Service では、完全な build-test-deploy-monitor ワークフローがサポートされています。

作成: ポータルまたは SDK でプロンプトエージェントを定義するか、Responses API を呼び出すホスト型エージェントを作成します。
テスト: エージェントプレイグラウンドでエージェントとチャットするか、ローカルで実行します。 Azure Functionsでホストされているカスタム MCP サーバーを含む MCP サーバー統合は、公開前にツールの接続性、アクセス許可、動作を検証するために、プレイグラウンドで直接実行できます。
トレース: エージェントトレースを使用して、すべてのモデル呼び出し、ツール呼び出し、および決定を検査します。
評価: 評価を実行して品質を測定し、回帰をキャッチします。
最適化: エージェントオプティマイザーを使用して、ホストされるエージェントの指示を自動的に改善します。
発行: 安定したエンドポイントを使用して、エージェントをマネージドリソースに昇格させます。
監視: サービスメトリックとダッシュボードを使用して、パフォーマンスと信頼性を追跡します。

詳細なチュートリアルについては、「エージェント開発ライフサイクル」を参照してください。

エンタープライズ機能

Agent Service は、デプロイするすべてのエージェントにエンタープライズレベルのインフラストラクチャを提供します。

エージェント ID: 各エージェントは専用のMicrosoft Entra ID を持つことができます。これにより、資格情報を共有することなく、リソースと API へのセキュリティで保護されたスコープアクセスが可能になります。エージェント ID は、Azure Functionsでホストされているものを含む外部 MCP サーバーに対して認証でき、構成時に OAuth On-Behalf-Of (OBO) パススルーがサポートされます。
プライベートネットワーク: Azure仮想ネットワーク内でエージェントを実行して、完全なネットワーク分離とデータ所在地の要件への準拠を実現します。プライベートネットワークは、プロンプトエージェントで使用できます。ホストされるエージェントは、独自のAzure Virtual Network (BYO VNet) をサポートします。各セッションは、VNet に接続された VM 分離サンドボックスで実行されます。
ロールベースのアクセス制御: Microsoft EntraとAzure RBAC によるきめ細かなアクセス許可。エージェントを作成、呼び出し、管理できるユーザーを制御します。
コンテンツの安全性: 統合コンテンツフィルターは、迅速な挿入リスク (クロスプロンプトインジェクションを含む) を軽減し、安全でない出力を防ぐのに役立ちます。

環境のセットアップ手順については、「環境のセットアップ」を参照してください。

Agent Service には、エージェントが開発から運用に自信を持って移行できるように、組み込みのバージョン管理と発行が用意されています。

バージョン管理: エージェントを反復処理すると、バージョンが自動的にスナップショットされます。以前のバージョンにロールバックするか、バージョン間の変更を比較します。
発行: 安定したエンドポイントを使用して、エージェントをマネージドリソースに昇格させます。発行されたエージェントは、プロジェクト用に構成されたエンタープライズ ID とアクセス制御を継承し、プログラムで呼び出すことができます。
配布: Microsoft Copilotおよび Teams と Entra Agent Registry を通じて公開されたエージェントを共有し、ユーザーが既に作業している場所にエージェントを配置します。 Foundry Agent Service では、Microsoft 365発行用の OpenResponses およびアクティビティプロトコル、カスタムアプリとサービスとの柔軟なエンドポイント統合のための呼び出しプロトコル、エージェント間通信用の A2A プロトコルがサポートされています。 A2A v1.0 は一般公開されており、v0.3 はプレビューのままです。

セキュリティ、プライバシー、コンプライアンス

Agent Service は、ID、ネットワーク、データ処理、および安全性を厳密に制御する必要があるエンタープライズワークロード向けに設計されています。

安全制御: 安全でない出力を減らし、クロスプロンプトインジェクション攻撃 (XPIA) を含む迅速なインジェクションリスクを軽減するために、統合されたガードレールを使用します。
ネットワークの分離とデータ所在地の制御: 要件を満たすために、仮想ネットワークと独自のリソースを使用します。
独自のリソースの作成: コンプライアンスと運用のニーズを満たすために、独自のAzure リソース (ストレージ、Azure AI 検索、Azure Cosmos DBなど) を使用します。「独自のリソースを使用する」を参照してください。
応答可能な AI ガイダンス: より広範な推奨事項とガバナンスリソースについては、「Microsoft Foundry に対応する AI を参照してください。

環境を設定する
エージェント開発ライフサイクル
最初のホステッドエージェントをデプロイする
Foundry ツールボックスの概要
最初のホステッドエージェントをデプロイする
音声ベースのプロンプトエージェントを作成する
音声ベースのエージェントのベストプラクティス
ツールカタログ
クォータ、制限、地域サポート
ヘルプやコミュニティに接続するには、Microsoft AI Discord に参加してください。

フィードバック

このページはお役に立ちましたか?

最終更新: 2026-09-25