Skip to content

Release 2.3.0 for azure-ai-agents and azure-ai-projects #49951

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kaylieee wants to merge 18 commits into
base: main
Choose a base branch
from
Open

Release 2.3.0 for azure-ai-agents and azure-ai-projects #49951

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
de9bc02
regen projects
kaylieee Jul 21, 2026
e2abd21
regen agents
kaylieee Jul 21, 2026
0ddf0a8
update samples and tests
kaylieee Jul 28, 2026
218ee19
sample and test fixes
kaylieee Jul 28, 2026
781bd80
regen agents and projects
kaylieee Jul 28, 2026
ed03f4e
add new beta decorators
kaylieee Jul 28, 2026
142eb36
Merge branch 'main' into kaylieee/release/2.3.0
kaylieee Aug 4, 2026
1b47978
regen
kaylieee Aug 4, 2026
ebd49aa
temp disable
kaylieee Aug 4, 2026
99e228d
regen
kaylieee Aug 4, 2026
6ed1ac8
regen spacing
kaylieee Aug 4, 2026
eca5b89
temp disable
kaylieee Aug 4, 2026
fdbf3db
rename and preview decorator update
kaylieee Aug 4, 2026
51a8279
update versioning
kaylieee Aug 4, 2026
dc5e239
remove unnecessary polling injection
kaylieee Aug 4, 2026
03779db
Merge branch 'main' into kaylieee/release/2.3.0
kaylieee Aug 4, 2026
7ca7be7
update version client txt
kaylieee Aug 4, 2026
1824bf6
regen spacing
kaylieee Aug 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions eng/versioning/version_client.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ com.azure:azure-data-sdk-parent;1.3.0;1.3.0
com.azure:azure-sdk-parent;1.6.0;1.6.0
com.azure:azure-client-sdk-parent;1.7.0;1.7.0
com.azure:azure-ai-agents-persistent;1.0.0-beta.2;1.0.0-beta.3
com.azure:azure-ai-agents;2.2.0;2.3.0-beta.1
com.azure:azure-ai-agents;2.2.0;2.3.0
com.azure:azure-ai-anomalydetector;3.0.0-beta.5;3.0.0-beta.6
com.azure:azure-ai-contentsafety;1.0.19;1.1.0-beta.1
com.azure:azure-ai-contentunderstanding;1.0.0;1.1.0-beta.3
Expand All @@ -53,7 +53,7 @@ com.azure:azure-ai-openai-assistants;1.0.0-beta.5;1.0.0-beta.6
com.azure:azure-ai-openai-realtime;1.0.0-beta.1;1.0.0-beta.1
com.azure:azure-ai-openai-stainless;1.0.0-beta.1;1.0.0-beta.1
com.azure:azure-ai-personalizer;1.0.0-beta.1;1.0.0-beta.2
com.azure:azure-ai-projects;2.2.0;2.3.0-beta.1
com.azure:azure-ai-projects;2.2.0;2.3.0
com.azure:azure-ai-speech-transcription;1.0.0;1.1.0-beta.1
com.azure:azure-ai-textanalytics;5.5.14;5.6.0-beta.1
com.azure:azure-ai-textanalytics-perf;1.0.0-beta.1;1.0.0-beta.1
Expand Down
4 changes: 3 additions & 1 deletion sdk/ai/azure-ai-agents/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
# Release History

## 2.3.0-beta.1 (Unreleased)
## 2.3.0 (Unreleased)

### Features Added

### Breaking Changes

### Bugs Fixed

- Fixed `BetaAgentsClient` / `BetaAgentsAsyncClient` `beginCreateOptimizationJob` long-running operations, which were failing because poll requests carried `Foundry-Features: MemoryStores=V1Preview` instead of the beta-agents preview opt-ins the endpoint requires. The offending header was being injected into the polling context by a customization that predated the builder-level `Foundry-Features` policy; the customization has been removed so that poll GETs now inherit the same per-client preview-features value the pipeline already stamps on the initial request.

### Other Changes

- Updated version of `openai` client library to `4.45.0`.
Expand Down
2 changes: 1 addition & 1 deletion sdk/ai/azure-ai-agents/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Various documentation is available to help you get started
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-agents</artifactId>
<version>2.2.0</version>
<version>2.3.0</version>
</dependency>
```
[//]: # ({x-version-update-end})
Expand Down
37 changes: 35 additions & 2 deletions sdk/ai/azure-ai-agents/customizations/beta-annotations.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,39 @@
type;class_name;annotation_description;member_name
class;com.azure.ai.agents.models.AgentDefinition;Preview API. DraftAgents=V1Preview, ExternalAgents=V1Preview, WorkflowAgents=V1Preview;
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.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;
Comment thread
kaylieee marked this conversation as resolved.
class;com.azure.ai.agents.models.MemoryItem;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemoryItemKind;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemoryOperation;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemoryOperationKind;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemorySearchItem;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemorySearchOptions;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemorySearchPreviewTool;Preview API. preview_tool;
class;com.azure.ai.agents.models.MemorySearchToolCall;Preview API. preview_tool;
class;com.azure.ai.agents.models.MemoryStoreDefaultDefinition;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemoryStoreDefaultOptions;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemoryStoreDefinition;Preview API. MemoryStores=V1Preview;
Expand All @@ -21,6 +45,7 @@ class;com.azure.ai.agents.models.MemoryStoreSearchResponse;Preview API. MemorySt
class;com.azure.ai.agents.models.MemoryStoreUpdateCompletedResult;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemoryStoreUpdateResponse;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MemoryStoreUpdateStatus;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.MicrosoftFabricPreviewTool;Preview API. preview_tool;
class;com.azure.ai.agents.models.OptimizationAgentIdentifier;Preview API. AgentsOptimization=V2Preview;
class;com.azure.ai.agents.models.OptimizationCandidate;Preview API. AgentsOptimization=V2Preview;
class;com.azure.ai.agents.models.OptimizationDatasetCriterion;Preview API. AgentsOptimization=V2Preview;
Expand All @@ -38,5 +63,13 @@ class;com.azure.ai.agents.models.OptimizationOptions;Preview API. AgentsOptimiza
class;com.azure.ai.agents.models.OptimizationReferenceDatasetInput;Preview API. AgentsOptimization=V2Preview;
class;com.azure.ai.agents.models.ProceduralMemoryItem;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.PromotionInfo;Preview API. AgentsOptimization=V2Preview;
class;com.azure.ai.agents.models.ReminderPreviewToolboxTool;Preview API. preview_tool;
class;com.azure.ai.agents.models.SharepointGroundingToolCall;Preview API. preview_tool;
class;com.azure.ai.agents.models.SharepointGroundingToolCallOutput;Preview API. preview_tool;
class;com.azure.ai.agents.models.SharepointGroundingToolParameters;Preview API. preview_tool;
class;com.azure.ai.agents.models.SharepointPreviewTool;Preview API. preview_tool;
class;com.azure.ai.agents.models.ToolboxSearchPreviewToolboxTool;Preview API. preview_tool;
class;com.azure.ai.agents.models.UserProfileMemoryItem;Preview API. MemoryStores=V1Preview;
class;com.azure.ai.agents.models.WorkflowAgentDefinition;Preview API. WorkflowAgents=V1Preview;
class;com.azure.ai.agents.models.WorkIqPreviewTool;Preview API. preview_tool;
class;com.azure.ai.agents.models.WorkIqPreviewToolboxTool;Preview API. preview_tool;
14 changes: 2 additions & 12 deletions sdk/ai/azure-ai-agents/customizations/src/main/java/AgentsCustomizations.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,21 +52,11 @@ private void renameImageGenToolSize(LibraryCustomization customization, Logger l
private void modifyPollingStrategies(LibraryCustomization customization, Logger logger) {
customization.getClass("com.azure.ai.agents.implementation", "OperationLocationPollingStrategy")
.customizeAst(ast -> ast.getClassByName("OperationLocationPollingStrategy")
.ifPresent(clazz -> {
clazz.getConstructors().get(1).getBody().getStatements()
.set(0, StaticJavaParser.parseStatement("super(PollingUtils.OPERATION_LOCATION_HEADER, AgentsServicePollUtils.withFoundryFeatures(pollingStrategyOptions));"));

clazz.addMember(StaticJavaParser.parseMethodDeclaration("@Override public Mono<PollResponse<T>> poll(PollingContext<T> pollingContext, TypeReference<T> pollResponseType) { return super.poll(pollingContext, pollResponseType).map(AgentsServicePollUtils::remapStatus); }"));
}));
.ifPresent(clazz -> clazz.addMember(StaticJavaParser.parseMethodDeclaration("@Override public Mono<PollResponse<T>> poll(PollingContext<T> pollingContext, TypeReference<T> pollResponseType) { return super.poll(pollingContext, pollResponseType).map(AgentsServicePollUtils::remapStatus); }"))));

customization.getClass("com.azure.ai.agents.implementation", "SyncOperationLocationPollingStrategy")
.customizeAst(ast -> ast.getClassByName("SyncOperationLocationPollingStrategy")
.ifPresent(clazz -> {
clazz.getConstructors().get(1).getBody().getStatements()
.set(0, StaticJavaParser.parseStatement("super(PollingUtils.OPERATION_LOCATION_HEADER, AgentsServicePollUtils.withFoundryFeatures(pollingStrategyOptions));"));

clazz.addMember(StaticJavaParser.parseMethodDeclaration("@Override public PollResponse<T> poll(PollingContext<T> pollingContext, TypeReference<T> pollResponseType) { return AgentsServicePollUtils.remapStatus(super.poll(pollingContext, pollResponseType)); }"));
}));
.ifPresent(clazz -> clazz.addMember(StaticJavaParser.parseMethodDeclaration("@Override public PollResponse<T> poll(PollingContext<T> pollingContext, TypeReference<T> pollResponseType) { return AgentsServicePollUtils.remapStatus(super.poll(pollingContext, pollResponseType)); }"))));
}

private void annotateBetaClients(LibraryCustomization customization, Logger logger) {
Expand Down
2 changes: 1 addition & 1 deletion sdk/ai/azure-ai-agents/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

<groupId>com.azure</groupId>
<artifactId>azure-ai-agents</artifactId>
<version>2.3.0-beta.1</version> <!-- {x-version-update;com.azure:azure-ai-agents;current} -->
<version>2.3.0</version> <!-- {x-version-update;com.azure:azure-ai-agents;current} -->
<packaging>jar</packaging>

<name>Microsoft Azure SDK for Agents</name>
Expand Down
12 changes: 12 additions & 0 deletions sdk/ai/azure-ai-agents/revapi.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,18 @@
"code": "java.field.removed",
"old": "field com.azure.ai.agents.models.ToolType.FABRIC_DATAAGENT_PREVIEW",
"justification": "Breaking change in beta operation: ToolType.FABRIC_DATAAGENT_PREVIEW was renamed to FABRIC_DATA_AGENT_PREVIEW for consistent naming."
},
{
"regex": true,
"code": "java\\.method\\.removed",
"old": "method .* com\\.azure\\.ai\\.agents\\.BetaAgents(Async)?Client::createOptimizationJob(WithResponse)?\\(.*\\)",
"justification": "Breaking change in beta operation: createOptimizationJob was replaced by the long-running-operation beginCreateOptimizationJob to align with the current AgentsOptimization preview contract."
},
{
"code": "java.field.enumConstantOrderChanged",
"old": "field com.azure.ai.agents.models.ToolboxToolType.TOOLBOX_SEARCH_PREVIEW",
"new": "field com.azure.ai.agents.models.ToolboxToolType.TOOLBOX_SEARCH_PREVIEW",
"justification": "Breaking change in preview enum: a new preview constant was inserted earlier in ToolboxToolType, shifting the ordinal of TOOLBOX_SEARCH_PREVIEW. Ordinal-based code is not supported for preview enum constants."
}
]
}
Expand Down
Loading
Loading