Microsoft Foundry Hosted Agentsの本番利用について

お問い合わせいただきありがとうございます。

C# / .NET 向けの Microsoft.Agents.AI.Foundry.Hosting を使用した Microsoft Foundry Hosted Agents の本番利用について、公開されている Microsoft 公式ドキュメントを確認しました。

結論

現時点で公開ドキュメントから確認できる内容は、以下のとおりです。

• Microsoft Foundry Hosted Agents の **マネージド ホスティングサービスは一般提供（GA）**されています。
• 一方、Microsoft.Agents.AI.Foundry.Hosting の提供状態については、公式ドキュメント間でインストール例の表記が一致していません。
• 特定の SDK バージョンとプロトコルを固定した場合の将来互換性、旧プロトコルのサポート期間、廃止時の事前通知期間は、確認した公開ドキュメントには明記されていません。
• Hosting SDK の GA 予定日、GA までに予定されている破壊的変更、移行作業も明記されていません。
• Production 環境で prerelease SDK を使用した場合の、SDK 不具合やサービスとの互換性障害に対する修正保証についても、具体的な規定は確認できません。

以下、ご質問ごとに回答します。

1. 互換性保証について

Microsoft Foundry Hosted Agents のサービス提供状態について、公式ドキュメントには次の記載があります。

「Microsoft Foundry Hosted Agents は一般提供されており、独自のコードまたは優先エージェント フレームワークを使用して構築されたエージェントをサポートしています。」

出典：Foundry がホストするエージェント

また、Hosted Agent が公開できるプロトコルについては、次のように記載されています。

「ホストされるエージェントは、1 つ以上のプロトコルを公開できます。ほとんどの会話エージェントの応答から始めます。」

同じページでは、以下の2つのプロトコルが案内されています。

• Responses：OpenAI 互換のチャット、ストリーミング、応答履歴、会話スレッドを使用する場合
• Invocations：カスタム JSON、Webhook 形式のエンドポイント、または非会話処理を使用する場合

出典：Microsoft Agent Framework のエージェントを Foundry でホストされるエージェントとしてホストする

一方、確認した公開ドキュメントには、以下の事項は記載されていません。

• 特定の SDK バージョンを固定した場合の将来互換性
• Microsoft 側のサービス更新後も既存エージェントが継続動作するという保証
• Responses／Invocations プロトコルのバージョン別サポート期間
• 旧プロトコルの廃止時期
• 廃止前の通知期間
• SDK と Hosted Agents サービス間の互換性保証期間

したがって、特定の SDK バージョンおよびプロトコル構成を固定した場合でも、将来のサービス更新後に既存エージェントが継続動作することを、公開ドキュメントに基づいて保証することはできません。

これは、将来の互換性がないことを意味するものではありません。公開ドキュメント上、互換性保証の条件やサポート期間を確認できないため、保証の有無を断定できないという回答になります。

2. Hosting SDK の GA化に伴う変更について

Hosted Agents のマネージド ホスティングサービスは、前述のとおり一般提供されています。

一方、C# / .NET 向けの Microsoft.Agents.AI.Foundry.Hosting については、公式ドキュメント間でインストール例の表記が一致していません。

「Foundry がホストするエージェント」では、次のように --prerelease を付けたコマンドが掲載されています。

dotnet add package Microsoft.Agents.AI.Foundry.Hosting --prerelease

出典：Foundry がホストするエージェント

一方、「Microsoft Agent Framework のエージェントを Foundry でホストされるエージェントとしてホストする」では、次のように --prerelease を付けないコマンドが掲載されています。

dotnet add package Microsoft.Agents.AI.Foundry.Hosting

出典：Microsoft Agent Framework のエージェントを Foundry でホストされるエージェントとしてホストする

このため、これらのインストール例だけを根拠として、現在の C# Hosting SDK が GA または prerelease のいずれであるかを確定的に判断することは困難です。

また、確認した公開ドキュメントには、以下の情報は掲載されていません。

• Microsoft.Agents.AI.Foundry.Hosting の GA 予定日
• GA までに予定されている破壊的変更
• prerelease 版から GA 版への移行手順
• prerelease 版と GA 版との API 互換性
• prerelease 版で作成したエージェントの移行要否

したがって、GA の予定時期や、GA化までに必要となるコード変更および移行作業について、公開情報から具体的に案内することはできません。

なお、「エージェント アプリケーションから新しいエージェント エンドポイントへの移行と発行エクスペリエンス」には、次の記載があります。

「既存のエージェント アプリケーションは、引き続きエンドポイントを介してトラフィックを処理します。」

「プロジェクト エンドポイントは下位互換性のために引き続き使用できます（ただし、推奨パスではなくなりました）。」

出典：エージェント アプリケーションから新しいエージェント エンドポイントへの移行と発行エクスペリエンス

ただし、この移行文書は、従来の Agent Application／Deployment モデルから新しいエージェント オブジェクトモデルへの移行を説明するものです。Microsoft.Agents.AI.Foundry.Hosting の prerelease 版から GA 版への移行や、Hosting SDK の互換性を説明する文書ではありません。

3. Production 環境におけるサポートについて

Microsoft Foundry Hosted Agents のトラブルシューティング文書では、問題の診断方法や、プラットフォーム側の遅延が疑われる場合のサポートリクエストについて、次のように案内されています。

「サポート リクエストを作成します。応答 ID、タイムスタンプ、セッション開始の種類、待機時間ヘッダーを含めます。」

出典：ホストされるエージェントをデバッグする

また、Foundry Agent Service の FAQ には、次の記載があります。

「この記事で質問に対する回答が見つからない場合でも、ヘルプが必要な場合は、Foundry Tools のサポートとヘルプ オプションを参照してください。Foundry Agent Service は Foundry Tools の一部です。」

出典：Foundry Agent Service に関してよく寄せられる質問

これらの記載から、Hosted Agents に関する問題について、診断情報を収集してサポートへ問い合わせるための案内が用意されていることは確認できます。

ただし、確認した公開ドキュメントには、prerelease SDK の Production 利用について、以下の事項を保証する記載はありません。

• prerelease SDK 自体の不具合が、GA 製品と同じ条件でサポートされること
• 使用中の prerelease バージョンに対して修正が提供されること
• 修正または回避策が一定期間内に提供されること
• 旧 prerelease バージョンへの hotfix または backport
• SDK と Hosted Agents サービス間の将来互換性
• prerelease SDK に対する SLA
• GA まで破壊的変更が行われないこと

したがって、サポートへの問い合わせが可能であることと、特定の prerelease SDK バージョンに対する修正提供が保証されることは、分けて考える必要があります。

公開情報のみを根拠として、prerelease SDK の不具合またはサービスとの互換性障害に対する修正提供、修正時期、特定バージョンへの修正反映を保証することはできません。

本番利用にあたっての推奨事項

Microsoft.Agents.AI.Foundry.Hosting を Production 環境で採用する場合は、サービスの GA 状態と、実際に使用する NuGet パッケージの提供状態を分けて評価することを推奨します。

具体的には、以下をご検討ください。

1. 使用する NuGet パッケージの正確なバージョンを固定する
2. SDK 更新前後に /responses または /invocations の回帰テストを実施する
3. 検証済みのコンテナーイメージおよびエージェントバージョンへ切り戻せる構成を用意する
4. 応答 ID、UTC タイムスタンプ、SDK バージョン、使用プロトコル、コンテナーログを記録する
5. 本番採用前に、使用予定の具体的な SDK バージョンを提示したうえで、契約中の Azure サポートを通じて問い合わせ受付範囲と修正提供方針を確認する

以上より、現時点では、Hosted Agents のマネージド ホスティングサービスは GA である一方、C# Hosting SDK の提供状態、将来互換性、GA予定、旧プロトコルのサポート期間、および prerelease SDK に対する修正保証については、公開ドキュメントだけでは確定できません。

そのため、本番採用にあたっては、対象バージョンの固定、事前検証、回帰テスト、切り戻し手段の準備を前提とし、製品固有のサポート条件については Azure サポートへ個別に確認することを推奨します。