Azure.AI.AgentServer.Core Namespace

Static entry point for creating agent servers. Use CreateBuilder(String[]) to compose protocols and build the server. For one-line startup, use the protocol-specific Run methods provided by each protocol package (e.g., ResponsesServer.Run<T>()).

Represents a configured and runnable agent server application. Wraps the underlying WebApplication and provides escape-hatch access for advanced scenarios.

Composable builder for configuring and starting an agent server. Wraps WebApplicationBuilder (via CreateSlimBuilder(String[])) and exposes protocol registration, health checks, tracing, shutdown, and escape hatches.

Extension methods for standalone (Tier 3) server setups that do not use AgentHostBuilder. Registers all Core middleware services and adds them to the pipeline in one call each.

Configuration options for the agent server host.

Provides strongly-typed access to Foundry platform environment variables injected by the Azure AI Foundry hosting infrastructure. All values are read once in the static constructor and cached for the lifetime of the process.

Carries the platform-injected isolation keys for a single request. The Foundry platform sets x-agent-user-isolation-key and x-agent-chat-isolation-key headers on every protocol request (e.g., /responses, /invocations). These opaque partition keys let handlers scope user-private and conversation-shared state without inspecting user identity.

Defines the HTTP header names used across the AgentServer platform. These headers form the wire contract between the Foundry platform, agent containers, and downstream storage services.

Registry that collects version identity segments from protocol packages. Each protocol registers its identity string (e.g., azure-ai-agentserver-responses/1.0.0 (dotnet/10.0)) during route mapping, and the Azure.AI.AgentServer.Core.Internal.ServerVersionMiddleware reads all segments to compose the final x-platform-server response header.