Release azure-ai-agents and azure-ai-projects 2.2.0

[kaylieee]

This pull request refactors the Azure AI Agents SDK to remove the "Beta" prefix from the ToolboxesClient and ToolboxesAsyncClient, making these clients stable and updating their usage throughout the codebase. It also updates the preview features and improves the generated documentation for supported tool types.

Key changes:

Client Promotion and Refactoring

• Renamed BetaToolboxesClient to ToolboxesClient and BetaToolboxesAsyncClient to ToolboxesAsyncClient, updating all references, constructors, and service implementations accordingly. This includes moving from BetaToolboxesImpl to ToolboxesImpl and updating the builder methods to construct the new stable clients. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]

• Removed all builder methods and references to the old beta clients (BetaToolboxesClient and BetaToolboxesAsyncClient) from AgentsClientBuilder. [1] [2] [3] [4] [5] [6]

Feature Flags and Documentation

• Updated the preview feature flag from AGENTS_OPTIMIZATION_V1_PREVIEW to AGENTS_OPTIMIZATION_V2_PREVIEW for agent-related features.

• Expanded the list of supported tool types in the generated Javadoc for both clients, reflecting the latest available tool types (e.g., adding namespace, tool_search, etc.). [1] [2] [3] [4] [5] [6] [7]

Sample and Usage Updates

• Updated usage samples in the README.md to use the new stable client names (agentsClient and agentsAsyncClient instead of betaAgentsClient and betaAgentsAsyncClient). [1] [2]

[Copilot]

Pull request overview

This pull request updates the beta azure-ai-agents and azure-ai-projects Java SDKs to align with the latest TypeSpec/spec changes, including promoting the Toolboxes clients out of the beta-prefixed surface area, updating preview feature headers, and expanding/adjusting generated models and documentation.

Changes:

• Promotes BetaToolboxesClient / BetaToolboxesAsyncClient to ToolboxesClient / ToolboxesAsyncClient and updates usages across tests and samples.
• Updates Foundry preview feature opt-in keys (notably Agents Optimization v1 → v2) and adjusts header verification tests accordingly.
• Regenerates/updates multiple models (tools, optimization, routines) and refreshes Javadoc/tool type lists.

Reviewed changes

Copilot reviewed 87 out of 93 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
sdk/ai/azure-ai-projects/tsp-location.yaml	Updates upstream spec commit pin and removes an additional directory entry.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/TimerRoutineTrigger.java	Switches JSON representation of at to Unix epoch seconds while keeping OffsetDateTime API.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RoutineRun.java	Changes status to BinaryData and updates JSON (de)serialization accordingly.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/models/FoundryFeaturesOptInKeys.java	Removes toolboxes preview opt-in and updates optimization preview key to V2.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaRoutinesImpl.java	Updates embedded schema docs to reflect status: BinaryData.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaRoutinesClient.java	Updates embedded schema docs to reflect status: BinaryData.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaRoutinesAsyncClient.java	Updates embedded schema docs to reflect status: BinaryData.
sdk/ai/azure-ai-agents/tsp-location.yaml	Updates upstream spec commit pin and removes an additional directory entry.
sdk/ai/azure-ai-agents/src/test/java/com/azure/ai/agents/toolboxes/ToolboxSamplesTests.java	Updates tests to use GA ToolboxesClient / ToolboxesAsyncClient.
sdk/ai/azure-ai-agents/src/test/java/com/azure/ai/agents/SessionLogSyncTest.java	Switches session log test to GA AgentsClient.
sdk/ai/azure-ai-agents/src/test/java/com/azure/ai/agents/SessionLogAsyncTest.java	Switches session log test to GA AgentsAsyncClient.
sdk/ai/azure-ai-agents/src/test/java/com/azure/ai/agents/hostedagents/HostedAgentContainerSamplesTests.java	Updates hosted agent sample tests to use GA clients for session operations.
sdk/ai/azure-ai-agents/src/test/java/com/azure/ai/agents/hostedagents/CodeAgentSamplesTests.java	Updates code agent sample tests to use GA clients.
sdk/ai/azure-ai-agents/src/test/java/com/azure/ai/agents/FoundryFeaturesHeaderVerificationTest.java	Updates optimization preview key to V2 and removes toolboxes preview header assertions.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/UpdateToolbox.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/ToolboxSearchToolboxSample.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/ToolboxesAsyncSample.java	Updates sample to use ToolboxesAsyncClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/ListToolboxVersions.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/ListToolboxes.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/GetToolboxVersion.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/GetToolbox.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/DeleteToolboxVersion.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/DeleteToolbox.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/toolboxes/CreateToolboxVersion.java	Updates sample to use ToolboxesClient.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/ReadmeSamples.java	Updates README-backed samples to use GA agents clients for session log streaming.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/utils/HostedAgentsSampleUtils.java	Refactors helpers to use GA agents clients for session creation/cleanup.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionsSample.java	Updates sample to GA agents client for sessions.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionsAsyncSample.java	Updates sample to GA agents async client for sessions.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionLogStreamSample.java	Updates sample to GA agents client for session logs + endpoint config.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionLogStreamAsyncSample.java	Updates sample to GA agents async client for session logs + endpoint config.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionFilesSample.java	Updates sample to GA agents client for session files.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionFilesAsyncSample.java	Updates sample to GA agents async client for session files.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/CodeAgentSample.java	Updates sample to GA agents client for code-agent operations.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/CodeAgentAsyncSample.java	Updates sample to GA agents async client for code-agent operations.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/AgentEndpointSample.java	Updates sample to GA agents client for endpoint configuration.
sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/AgentEndpointAsyncSample.java	Updates sample to GA agents async client for endpoint configuration.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesClient.java	Promotes toolbox sync client and updates tool type docs; needs a small JavaDoc fix.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesAsyncClient.java	Promotes toolbox async client and updates tool type docs; needs a small JavaDoc fix.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/WebSearchPreviewTool.java	Adds search_content_types support.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolType.java	Adds new tool type constants (computer/namespace/tool_search).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolSearchToolParam.java	Adds new tool-search tool model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolSearchExecutionType.java	Adds tool-search execution type enum.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/Tool.java	Extends discriminator handling for new tool types.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SearchContentType.java	Adds web search content type enum.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/PromoteCandidateResult.java	Removes obsolete optimization promotion result model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/PromoteCandidateInput.java	Removes obsolete optimization promotion input model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationReferenceDatasetInput.java	Adds dataset reference input model for optimization.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationOptions.java	Renames/reshapes options (max_iterations → max_candidates).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationJobResult.java	Reshapes job result fields (baseline/best now candidate IDs).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationJobProgress.java	Updates progress field name (current_iteration → candidates_completed).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationJobListItem.java	Adds list-item model; currently has broken empty toJson.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationJobInputs.java	Reshapes optimization inputs (datasets + evaluator refs).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationJob.java	Updates optimization job resource shape and warnings handling.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationInlineDatasetInput.java	Adds inline dataset input model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationEvaluatorRef.java	Renames dataset ref model to evaluator ref model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationDatasetItem.java	Adds inline dataset item model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationDatasetInputType.java	Adds discriminator enum for dataset inputs.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationDatasetInput.java	Adds base discriminated dataset input model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationDatasetCriterion.java	Adds per-item evaluation criterion model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationCandidate.java	Reshapes candidate payload (mutations + summary metrics).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationAgentIdentifier.java	Renames optimization agent identifier model type.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationAgentDefinition.java	Removes obsolete optimization agent definition model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/NamespaceToolParam.java	Adds namespace tool model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/McpTool.java	Adds defer_loading support.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/IncludeEnum.java	Documents web_search_call.results include value.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ImageGenTool.java	Expands size-related JavaDoc for image generation tool.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FunctionToolParam.java	Adds function tool parameter model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FunctionTool.java	Adds defer_loading support.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/EmptyModelParam.java	Adds empty-parameter schema model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/DatasetInfo.java	Removes obsolete dataset info model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CustomToolParameter.java	Adds defer_loading support.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ComputerTool.java	Adds computer tool model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CandidateResults.java	Removes obsolete candidate results model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CandidateMetadata.java	Removes obsolete candidate metadata model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CandidateFileInfo.java	Removes obsolete candidate file info model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CandidateDeployConfig.java	Removes obsolete candidate deploy config model.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentProtocol.java	Adds a2a protocol constant.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentDefinition.java	Adjusts discriminator routing order (hosted first).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/models/FoundryFeaturesOptInKeys.java	Removes toolboxes preview opt-in and updates optimization preview key to V2.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/models/AgentDefinitionOptInKeys.java	Removes several preview opt-in keys (hosted/endpoints/code agents).
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/AgentsClientImpl.java	Wires GA ToolboxesImpl into the inner client and removes beta toolboxes wiring.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java	Removes beta toolboxes builders and adds GA toolboxes builders; updates preview header composition.
sdk/ai/azure-ai-agents/README.md	Updates session log snippets to use GA agents clients.

Comments suppressed due to low confidence (2)

sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesClient.java:32

• The class-level JavaDoc still says this initializes an "AgentsClient". This is now ToolboxesClient, so the summary is misleading in generated docs.
  sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesAsyncClient.java:38
• The class-level JavaDoc still says this initializes an "AgentsClient". This is now ToolboxesAsyncClient, so the summary is misleading in generated docs.