1.0.0-beta.21 (2026-04-14)
これは大規模なアーキテクチャの書き換えです。このパッケージは、軽量なホスティング基盤として再設計されました。以前はこのパッケージに同梱されていたプロトコル実装は、専用のプロトコルパッケージへ移動しました(Azure.AI.AgentServer.Responses、Azure.AI.AgentServer.Invocations)。
前回までのベータ版からアップグレードするには、移行ガイド(Migration Guide)
をご覧ください。
破壊的変更
- パッケージ分割:すべての Responses API プロトコル型(モデル、呼び出しハンドラー、SSE ストリーミング)は
Azure.AI.AgentServer.Responsesに移動しました。すべての Invocations プロトコル型はAzure.AI.AgentServer.Invocationsに移動しました。このパッケージには、共有されるホスティング基盤のみが含まれます。 - 依存関係の削除:
Azure.AI.AgentServer.Contractsは不要になりました。生成された OpenAI Responses API のモデルは、Azure.AI.AgentServer.Responsesに組み込まれるようになりました。 - 依存関係の削除:
Azure.AI.Projects、Microsoft.Agents.AI.*、およびModelContextProtocolパッケージは、このパッケージの依存関係ではなくなりました。 - API の再設計:従来の
IAgentInvocation/AgentInvocationContext/CreateResponseRequestの API 表面は、AgentHostBuilderとプロトコル固有のハンドラー抽象(Responses のResponseHandler、Invocations のInvocationHandler)に置き換えられました。 - 名前空間の変更:以前
Azure.AI.AgentServer.Core.Responses.*またはAzure.AI.AgentServer.Contracts.*の名前空間を使用していたコードは、Azure.AI.AgentServer.Responsesに切り替える必要があります。
追加された機能
AgentHostBuilderによるライブラリ所有のホスティング基盤(構成可能なビルダー パターン)。Azure.Monitor.OpenTelemetry.AspNetCoreによる OpenTelemetry の統合、および OTLP エクスポータのサポート。- ヘルスエンドポイントを
/readinessに追加し、稼働確認(liveness)および準備完了(readiness)プローブに対応。 AgentHostBuilder.RegisterProtocol()によるマルチプロトコル構成。プロトコルパッケージは、本 API の上に構築された拡張メソッド(例:AddResponses<T>()、AddInvocations<T>())を提供します。- ドレイン期間を設定可能な、きめ細かなシャットダウン(graceful shutdown)。
- SDK のバージョン情報を含む、すべての応答に対するサーバー ユーザーエージェント
x-platform-serverヘッダー。 - プロトコルパッケージがユーザーエージェントの識別子セグメントを登録するための
ServerUserAgentRegistry。 - スタンドアロン(Tier 3)構成向けの
AddAgentServerUserAgent()およびUseAgentServerUserAgent()拡張。 - Azure AI Foundry プラットフォームの変数解決のための
FoundryEnvironment。 - リクエスト ID のバゲージによる分散トレースコンテキストの伝播。
前のバージョン(1.0.0-beta.21 より前)
1.0.0-beta.21 より前のバージョンは、モノリシックなアーキテクチャを使用しており、Azure.AI.AgentServer.Core
がプロトコルのロジックを同梱し、生成されたモデルのために Azure.AI.AgentServer.Contracts に依存していました。
これらのバージョンは、新しい 3 パッケージのアーキテクチャに置き換えられました。詳細については、
移行ガイド(Migration Guide)
をご覧ください。




