Release 2.3.0 for azure-ai-agents and azure-ai-projects - #49951
Open
kaylieee wants to merge 6 commits into
Open
Conversation
kaylieee
requested review from
a team,
dargilco,
glecaros,
jpalvarezl and
trrwilson
as code owners
July 28, 2026 00:57
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the Azure AI Agents and Azure AI Projects Java SDKs for the 2.3.0 release, primarily by expanding preview tool coverage/annotations, improving generated JavaDoc to better reflect request/response shapes, and aligning clients/samples with updated service behaviors (notably data-generation LROs and new evaluation warning payloads).
Changes:
- Added/expanded preview tool model types and corresponding beta annotations (including toolbox tool type additions).
- Updated data generation job creation to use long-running operation pollers and adjusted samples/tests accordingly.
- Introduced new evaluation warning models and surfaced them on evaluator-related resources; improved generated JavaDoc wording across multiple clients/impls.
Reviewed changes
Copilot reviewed 106 out of 108 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| sdk/ai/azure-ai-projects/tsp-location.yaml | Updates TypeSpec source commit and consolidates OpenAI directories into openai. |
| sdk/ai/azure-ai-projects/src/test/java/com/azure/ai/projects/DataGenerationJobsClientTests.java | Updates test to use beginCreateGenerationJob(...).poll().getValue() and removes allowPreview(true) usage. |
| sdk/ai/azure-ai-projects/src/test/java/com/azure/ai/projects/DataGenerationJobsAsyncClientTests.java | Updates async test to use beginCreateGenerationJob(...).next() and removes allowPreview(true) usage. |
| sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/SkillsPackageSample.java | Adjusts skill zip packaging and sets uploaded skill version as default. |
| sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/DataGenerationJobWithEvaluationSample.java | Switches to LRO-based data generation job creation and removes allowPreview(true). |
| sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/DataGenerationJobsSample.java | Updates sample to create jobs via LRO poller; adjusts sample job options. |
| sdk/ai/azure-ai-projects/src/samples/java/com/azure/ai/projects/DataGenerationJobsAsyncSample.java | Updates async sample to create jobs via LRO poller; adjusts sample job options. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/TaskGenerationDataGenerationJobOptions.java | Adds new preview job options model for task_generation data generation jobs. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarningSource.java | Adds extensible enum for rubric input-quality warning source. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarningSeverity.java | Adds extensible enum for rubric input-quality warning severity. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarningCode.java | Adds extensible enum for rubric input-quality warning codes. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/RubricGenerationInputQualityWarning.java | Adds model representing rubric-generation input-quality advisories. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/HumanEvaluationPreviewRuleAction.java | Marks rule action model as preview via @Beta. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/GenerationWarningType.java | Adds extensible enum for warning categories on generated evaluator versions. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/EvaluatorVersion.java | Surfaces generation provenance (generation_job_id) and warning categories on evaluator versions. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/EvaluatorGenerationJob.java | Adds input_quality_warnings list to evaluator generation jobs. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/DataGenerationJobType.java | Adds TASK_GENERATION job type constant. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/DataGenerationJobOptions.java | Adds discriminator support for task_generation options. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/SyncOperationLocationPollingStrategy.java | Adds generated sync polling strategy for Operation-Location based LROs. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/PollingUtils.java | Adds generated polling utilities for retry-after parsing and deserialization. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/OperationLocationPollingStrategy.java | Adds generated async polling strategy for Operation-Location based LROs. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/DeploymentsImpl.java | Improves generated JavaDoc wording (“Retrieves…”). |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/DatasetsImpl.java | Improves generated JavaDoc wording and casing (“dataset version”). |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaSkillsImpl.java | Clarifies multipart content parameter JavaDoc. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaModelsImpl.java | Improves model-version operation JavaDoc wording and request-body parameter descriptions. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaEvaluationTaxonomiesImpl.java | Improves update taxonomy JavaDoc wording. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DeploymentsClient.java | Aligns JavaDoc wording with impl (“Retrieves…”). |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DeploymentsAsyncClient.java | Aligns JavaDoc wording with impl (“Retrieves…”). |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DatasetsClient.java | Aligns JavaDoc wording with impl (“Retrieves…”). |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/DatasetsAsyncClient.java | Aligns JavaDoc wording with impl (“Retrieves…”). |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaSkillsClient.java | Clarifies multipart content parameter JavaDoc. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaSkillsAsyncClient.java | Clarifies multipart content parameter JavaDoc. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaModelsClient.java | Aligns JavaDoc wording with impl for model version operations. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaModelsAsyncClient.java | Aligns JavaDoc wording with impl for model version operations. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaEvaluationTaxonomiesClient.java | Improves update taxonomy JavaDoc wording. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaEvaluationTaxonomiesAsyncClient.java | Improves update taxonomy JavaDoc wording. |
| sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaDatasetsClient.java | Reworks data-generation create into LRO (beginCreateGenerationJob) and updates job option docs. |
| sdk/ai/azure-ai-projects/customizations/beta-annotations.csv | Adds preview annotations for newly introduced evaluation and data-generation models. |
| sdk/ai/azure-ai-agents/tsp-location.yaml | Updates TypeSpec source commit and consolidates OpenAI directories into openai. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionsSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionsAsyncSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionLogStreamSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionLogStreamAsyncSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionFilesSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/SessionFilesAsyncSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/AgentEndpointSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/samples/java/com/azure/ai/agents/hostedagents/AgentEndpointAsyncSample.java | Removes unnecessary allowPreview(true) for beta clients. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesClient.java | Updates tool type documentation to include toolbox_search alongside preview variant. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/ToolboxesAsyncClient.java | Updates tool type documentation to include toolbox_search alongside preview variant. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/WorkIqPreviewToolboxTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/WorkIqPreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolSearchToolboxTool.java | Adds new toolbox tool model for non-preview toolbox_search. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxToolType.java | Adds enum value TOOLBOX_SEARCH. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxTool.java | Adds discriminator support for toolbox_search. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxSearchPreviewToolboxTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointPreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointGroundingToolParameters.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointGroundingToolCallOutput.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SharepointGroundingToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ReminderPreviewToolboxTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/OptimizationOptions.java | Adds max_stalls option field with JSON serialization/deserialization. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MicrosoftFabricPreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemorySearchToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemorySearchPreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemoryCommandToolCallOutput.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/MemoryCommandToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricIqPreviewToolboxTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricIqPreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricDataAgentToolParameters.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricDataAgentToolCallOutput.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FabricDataAgentToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CreateAgentVersionInput.java | Narrows preview annotation scope to specific fields instead of the whole model. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolParameters.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolConnectionParameters.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolCallOutput.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationPreviewToolboxTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BrowserAutomationPreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchToolParameters.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchToolCallOutput.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchPreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/BingCustomSearchConfiguration.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AzureUserSecurityContext.java | Adds model for end-user security context (Defender for Cloud integration). |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AzureFunctionToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AzureCreateResponseOptions.java | Adds user_security_context field with JSON serialization/deserialization. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentIdentityStatus.java | Adds extensible enum for agent identity status (active/disabled). |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentIdentity.java | Adds status field to agent identity JSON model. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentDefinition.java | Removes preview annotation from the entire type (reduces over-scoping). |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2AToolCallOutput.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2AToolCall.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2APreviewToolboxTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/A2APreviewTool.java | Adds @Beta preview-tool annotation. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/ToolboxesImpl.java | Updates tool type documentation to include toolbox_search alongside preview variant. |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/AgentsImpl.java | Updates generated API docs (instance identity status, multipart param descriptions, session ownership wording). |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClient.java | Updates generated API docs (instance identity status, multipart param descriptions, session ownership wording). |
| sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsAsyncClient.java | Updates generated API docs (instance identity status, multipart param descriptions, session ownership wording). |
| sdk/ai/azure-ai-agents/customizations/beta-annotations.csv | Adds preview-tool and field-level beta annotations for newly introduced preview surface. |
Comment on lines
+102
to
+106
| new AzureException(String.format( | ||
| "Operation failed or cancelled with status code %d," | ||
| + ", '%s' header: %s, and response body: %s", | ||
| response.getStatusCode(), PollingUtils.OPERATION_LOCATION_HEADER, operationLocationHeader, | ||
| response.getValue()))); |
Comment on lines
87
to
90
| try (ZipOutputStream zipOutputStream = new ZipOutputStream(outputStream)) { | ||
| zipOutputStream.putNextEntry(new ZipEntry(SKILL_NAME + "/SKILL.md")); | ||
| zipOutputStream.putNextEntry(new ZipEntry("SKILL.md")); | ||
| zipOutputStream.write(skillMarkdown.getBytes(StandardCharsets.UTF_8)); | ||
| zipOutputStream.closeEntry(); |
Comment on lines
+101
to
102
| SimpleQnADataGenerationJobOptions options = new SimpleQnADataGenerationJobOptions(15) | ||
| .setModelOptions(new DataGenerationModelOptions(model)); |
Comment on lines
+109
to
110
| SimpleQnADataGenerationJobOptions options = new SimpleQnADataGenerationJobOptions(15) | ||
| .setModelOptions(new DataGenerationModelOptions(model)); |
jpalvarezl
reviewed
Jul 28, 2026
| * An A2A (Agent-to-Agent) tool call. | ||
| */ | ||
| @Immutable | ||
| @Beta(warningText = "Preview API. preview_tool") |
Member
There was a problem hiding this comment.
Is this correctly flagged as beta?
jpalvarezl
reviewed
Jul 28, 2026
jpalvarezl
left a comment
jpalvarezl
left a comment
Member
There was a problem hiding this comment.
This is looking great and I am really happy we are surfacing LROs the right way. Not sure if there are still some ops that need to be migrated that weren't LROs but should have been, but I am happy to see that things are flagged the right way in the upstream spec.
| * The output of an A2A (Agent-to-Agent) tool call. | ||
| */ | ||
| @Fluent | ||
| @Beta(warningText = "Preview API. preview_tool") |
Member
There was a problem hiding this comment.
this one too. (Just commenting on these because they don't have Preview on the name and are being marked as beta).
| * An Azure Function tool call. | ||
| */ | ||
| @Immutable | ||
| @Beta(warningText = "Preview API. preview_tool") |
Member
There was a problem hiding this comment.
We may want to investigate why this is being marked as beta.
| * A bing custom search configuration. | ||
| */ | ||
| @Fluent | ||
| @Beta(warningText = "Preview API. preview_tool") |
Member
There was a problem hiding this comment.
Another beta marker that I am not sure if it should be marked as such.
| * A Bing custom search tool call. | ||
| */ | ||
| @Immutable | ||
| @Beta(warningText = "Preview API. preview_tool") |
| * The output of a Bing custom search tool call. | ||
| */ | ||
| @Fluent | ||
| @Beta(warningText = "Preview API. preview_tool") |
| */ | ||
| @Generated | ||
| @ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION) | ||
| public PollerFlux<BinaryData, BinaryData> beginCreateOptimizationJob(BinaryData job, |
Member
There was a problem hiding this comment.
Not entirely sure, but we may need to add a code customization that injects the beta header. I believe we already do it (did it ?) for MemoryStores, we may need to adjust it.
Comment on lines
+2
to
+29
| class;com.azure.ai.agents.models.A2APreviewTool;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.A2APreviewToolboxTool;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.A2AToolCall;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.A2AToolCallOutput;Preview API. preview_tool; | ||
| field;com.azure.ai.agents.models.AgentVersionDetails;Preview API. DraftAgents=V1Preview;draft | ||
| class;com.azure.ai.agents.models.AzureFunctionToolCall;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BingCustomSearchConfiguration;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BingCustomSearchPreviewTool;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BingCustomSearchToolCall;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BingCustomSearchToolCallOutput;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BingCustomSearchToolParameters;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BrowserAutomationPreviewTool;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BrowserAutomationPreviewToolboxTool;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BrowserAutomationToolCall;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BrowserAutomationToolCallOutput;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BrowserAutomationToolConnectionParameters;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.BrowserAutomationToolParameters;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.ChatSummaryMemoryItem;Preview API. MemoryStores=V1Preview; | ||
| class;com.azure.ai.agents.models.CreateAgentVersionInput;Preview API. DraftAgents=V1Preview, ExternalAgents=V1Preview, WorkflowAgents=V1Preview; | ||
| field;com.azure.ai.agents.models.CreateAgentVersionInput;Preview API. DraftAgents=V1Preview, ExternalAgents=V1Preview, WorkflowAgents=V1Preview;definition | ||
| field;com.azure.ai.agents.models.CreateAgentVersionInput;Preview API. DraftAgents=V1Preview;draft | ||
| class;com.azure.ai.agents.models.ExternalAgentDefinition;Preview API. ExternalAgents=V1Preview; | ||
| class;com.azure.ai.agents.models.FabricDataAgentToolCall;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.FabricDataAgentToolCallOutput;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.FabricDataAgentToolParameters;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.FabricIqPreviewTool;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.FabricIqPreviewToolboxTool;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.MemoryCommandToolCall;Preview API. preview_tool; | ||
| class;com.azure.ai.agents.models.MemoryCommandToolCallOutput;Preview API. preview_tool; |
Member
There was a problem hiding this comment.
I'd investigate all these new tool additions as beta that don't have preview in the name. Apologies for the comment spam throughout the PR.
| * @param <U> the type of the final result object to deserialize into, or BinaryData if raw response body should be | ||
| * kept | ||
| */ | ||
| public final class OperationLocationPollingStrategy<T, U> extends OperationResourcePollingStrategy<T, U> { |
Member
There was a problem hiding this comment.
We may need to replicate here what we do in agents to inject the beta headers for requests. Unless you didn't hit any issues with live service testing.
| * @return the {@link PollerFlux} for polling of data Generation Job resource. | ||
| */ | ||
| @Generated | ||
| @ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION) |
Member
There was a problem hiding this comment.
Just flagging the same feedback as earlier, we may need to add some customization to inject the beta header at the poller utils level. See what we do for MemoryStores as reference. Unless, of course, live tests are passing and we are already good.
| */ | ||
| @Generated | ||
| @ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION) | ||
| public PollerFlux<BinaryData, BinaryData> beginCreateEvaluatorGenerationJob(BinaryData job, |
Member
There was a problem hiding this comment.
flagging op for possible missing beta header on intermediate polling requests
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces several preview tool classes and updates API documentation in the Azure AI Agents SDK. The main changes are the addition of new preview tool annotations, improvements to the API JavaDoc comments for clarity, and the inclusion of a new optional
statusfield in theinstance_identityobject throughout the API documentation.Preview tool support and annotation updates:
A2APreviewTool,BingCustomSearchPreviewTool,BrowserAutomationPreviewTool,MicrosoftFabricPreviewTool,SharepointPreviewTool,WorkIqPreviewTool, etc.) with correspondingPreview API. preview_toolannotations inbeta-annotations.csv. [1] [2] [3]API documentation improvements:
AgentsAsyncClient.javato clarify that thecontentparameter is "The content multipart request content" instead of just "The content parameter". [1] [2] [3] [4] [5]Instance identity enhancements:
statusfield (with possible valuesactiveordisabled) to theinstance_identityobject in the API documentation for agent creation, update, and related methods. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]These changes improve the SDK's preview tool coverage, clarify API usage for developers, and add flexibility for agent instance identity management.