Azure/azure-sdk-for-java com.azure+azure-ai-agents_2.1.0-beta.1

on GitHub

2.1.0-beta.1 (2026-05-12)

Features Added

• Added new ToolboxesClient and ToolboxesAsyncClient sub-clients (preview, opt-in via FoundryFeaturesOptInKeys.TOOLBOXES_V1_PREVIEW) for managing toolboxes and toolbox versions, with operations including createToolboxVersion, getToolbox, getToolboxVersion, listToolboxes, listToolboxVersions, updateToolbox, deleteToolbox, and deleteToolboxVersion. New buildToolboxesClient() and buildToolboxesAsyncClient() methods on AgentsClientBuilder.
• Added new AgentSessionFilesClient and AgentSessionFilesAsyncClient sub-clients for working with files in an agent session, with uploadSessionFile, downloadSessionFile, getSessionFiles, and deleteSessionFile. New buildAgentSessionFilesClient() and buildAgentSessionFilesAsyncClient() methods on AgentsClientBuilder.
• Added buildAgentScopedOpenAIClient(String agentName) and buildAgentScopedOpenAIAsyncClient(String agentName) to AgentsClientBuilder for constructing OpenAI clients targeting a specific agent's endpoint (base URL {endpoint}/agents/{agentName}/endpoint/protocols/openai). The default buildOpenAIClient() / buildOpenAIAsyncClient() continue to target {endpoint}/openai/v1.
• Added agent-session operations to AgentsClient and AgentsAsyncClient: createSession, getSession, deleteSession, listSessions, and getSessionLogStreamWithResponse. New related models: AgentSessionResource, AgentSessionStatus, SessionDirectoryEntry, SessionDirectoryListResponse, SessionFileWriteResponse, SessionLogEvent, SessionLogEventType, IsolationKeySource (with Kind), EntraIsolationKeySource, and HeaderIsolationKeySource.
• Added updateAgentDetails(String, UpdateAgentDetailsPatchRequest, ...) and updateAgentDetailsWithResponse on AgentsClient/AgentsAsyncClient for patching agent details, plus new UpdateAgentDetailsPatchRequest model.
• Added new agent-endpoint and identity model types for hosted agents: AgentEndpoint, AgentEndpointProtocol, AgentEndpointAuthorizationScheme (with Type), EntraAuthorizationScheme, BotServiceAuthorizationScheme, BotServiceRbacAuthorizationScheme, AgentIdentity, AgentBlueprintReference (with Type), ManagedAgentIdentityBlueprintReference, AgentCard, and AgentCardSkill. AgentDetails now exposes getAgentEndpoint, getInstanceIdentity, getBlueprint, getBlueprintReference, and getAgentCard. AgentVersionDetails now exposes getInstanceIdentity, getBlueprint, getBlueprintReference, and getAgentGuid.
• Added agent-versioning model types: VersionIndicator (with Type), VersionRefIndicator, VersionSelector (with Type), VersionSelectionRule, FixedRatioVersionSelectionRule, and CreateAgentVersionInput.
• HostedAgentDefinition now supports both container-based and code-based deployments: added ContainerConfiguration and CodeConfiguration model types, with new getContainerConfiguration/setContainerConfiguration, getCodeConfiguration/setCodeConfiguration, getProtocolVersions/setProtocolVersions, and setContainerProtocolVersions accessors. Container vs. code configuration is mutually exclusive (validated server-side).
• Added new preview tool WorkIqPreviewTool (and parameters WorkIQPreviewToolParameters) with discriminator value work_iq_preview. Added ToolType.WORK_IQ_PREVIEW.
• Added optional name and description properties (with getters and setters) to CodeInterpreterTool, CaptureStructuredOutputsTool, FileSearchTool, ImageGenTool, WebSearchTool, and WorkIqPreviewTool for user-defined tool labels.
• Added new feature-flag values to FoundryFeaturesOptInKeys: TOOLBOXES_V1_PREVIEW (Toolboxes=V1Preview) and SKILLS_V1_PREVIEW (Skills=V1Preview).
• Added new feature-flag values to AgentDefinitionOptInKeys: CONTAINER_AGENTS_V1_PREVIEW (ContainerAgents=V1Preview) and AGENT_ENDPOINT_V1_PREVIEW (AgentEndpoints=V1Preview).
• Added new toolbox samples under com.azure.ai.agents.toolboxes: CreateToolboxVersion, GetToolbox, GetToolboxVersion, ListToolboxes, ListToolboxVersions, UpdateToolbox, DeleteToolbox, and DeleteToolboxVersion.

Breaking Changes

• HostedAgentDefinition's canonical (@Generated) constructor changed from HostedAgentDefinition(List<ProtocolVersionRecord> containerProtocolVersions, String cpu, String memory) to HostedAgentDefinition(String cpu, String memory); containerProtocolVersions is now a mutable property set via setContainerProtocolVersions(...). The previous 3-argument constructor is retained for source compatibility but is no longer the recommended entry point.

Other Changes

• Regenerated client from the updated TypeSpec specification.