Azure.AI.AgentServer.Invocations_1.0.0-beta.2

Azure OpenAI .NET Releases / 2026/4/19

📰 ニュースDeveloper Stack & InfrastructureModels & Research

要点

  • Azure.AI.AgentServer.Invocations_1.0.0-beta.2では、Invocationsプロトコルの全エンドポイント(GET、Cancel、OpenAPI)にx-agent-session-idレスポンスヘッダーを追加し、仕様に合わせた挙動にしています。
  • 変更により、ユーザー/チャットのアイソレーションキーが「存在するか」をログに出す一方で、キーの値自体は一切記録しないようにしています。
  • Tier 1およびTier 2構成向けに受信HTTPリクエストのログを強化し、メソッド、パス、ステータスコード、所要時間、x-request-idやx-ms-client-request-idなどの相関ヘッダーを記録します。
  • 破壊的変更としてInvocationsActivitySourceがinternal化され、開発者が直接トレーシングアクティビティを作成する必要がなくなり、フレームワーク側で管理されます。
  • 併せてAzure.AI.AgentServer.Coreへの依存を更新し、分散トレース相関のためのHttpClient計装が追加されています。

1.0.0-beta.2 (2026-04-17)

追加機能

  • GET、Cancel、および OpenAPI エンドポイントで x-agent-session-id のレスポンスヘッダーを追加しました。POST
    エンドポイントはすでにヘッダーを設定していました。すべての Invocations プロトコルのエンドポイントが仕様 §8 に従ってこれを含むようになりました。

  • すべての
    エンドポイント ハンドラーのログ(POST、GET、Cancel)に、分離キーの有無に関するログ(HasUserIsolationKeyHasChatIsolationKey)を追加しました。キーの値は一切ログに記録されません。

  • 起動設定のログを追加しました。ホスト起動時に、プロトコル登録が Information レベルでログに記録されます。

  • Tier 1 および Tier 2 のセットアップに対する inbound リクエスト ログを追加しました(InvocationsServer.Run() または
    AgentHost.CreateBuilder() 経由)。すべての受信 HTTP リクエストは、メソッド、パス、ステータス
    コード、所要時間、および相関ヘッダー(x-request-idx-ms-client-request-id)とともにログに記録されます。

重大な変更

  • InvocationsActivitySource を internal にしました。アクティビティ ソースは
    フレームワークによって管理されるため、ハンドラーでトレーシング アクティビティを直接作成する必要はありません。

その他の変更

  • Azure.AI.AgentServer.Core への依存を 1.0.0-beta.22 に更新しました。これにより、分散トレースの相関のための outbound
    HttpClient の計測が追加されます。