Azure.AI.AgentServer.Core_1.0.0-beta.21

Azure OpenAI .NET Releases / 2026/4/16

📰 ニュースDeveloper Stack & InfrastructureSignals & Early TrendsTools & Practical Usage

要点

  • Azure.AI.AgentServer.Core バージョン 1.0.0-beta.21 では、AgentHostBuilder を介した軽量なホスティング基盤としてパッケージを再設計する、大規模なアーキテクチャの刷新が導入されます。
  • プロトコルのサーフェスが専用パッケージに分割されました。レスポンス API は Azure.AI.AgentServer.Responses に移動し、インボケーション API は Azure.AI.AgentServer.Invocations に移動することで、Core は共有ホスティング専用として整理されています。
  • アップグレードに影響する複数の重大な変更があります。Azure.AI.AgentServer.Contracts の削除、従来の IAgentInvocation / AgentInvocationContext / CreateResponseRequest API を ResponseHandler / InvocationHandler 抽象化に置き換え、必要な名前空間の変更が含まれます。
  • この更新により、Core パッケージから Azure.AI.Projects、Microsoft.Agents.AI.*、および ModelContextProtocol への依存が削除されます。
  • 新機能として、OpenTelemetry(Azure.Monitor.OpenTelemetry.AspNetCore)と OTLP 対応、/readiness ヘルスエンドポイント、RegisterProtocol() によるマルチプロトコル構成、ドレイン期間付きのグレースフルシャットダウン、バージョン付きのアイデンティティセグメントを含むサーバーのユーザーエージェントヘッダーが追加されます。

1.0.0-beta.21 (2026-04-14)

これは大規模なアーキテクチャの書き換えです。このパッケージは、軽量なホスティング基盤として再設計されました。以前はこのパッケージに同梱されていたプロトコル実装は、専用のプロトコルパッケージへ移動しました(Azure.AI.AgentServer.ResponsesAzure.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.ProjectsMicrosoft.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)
をご覧ください。