Skip to content

Latest spec #49344

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
jpalvarezl wants to merge 3 commits into
base: main
Choose a base branch
from
+642 −567
Open

Latest spec #49344

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
728a936
regened from top commit in release spec branch
jpalvarezl Jun 2, 2026
4660da8
regened projects
jpalvarezl Jun 2, 2026
2b4f318
Changelog/Readme
jpalvarezl Jun 2, 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
3 changes: 3 additions & 0 deletions sdk/ai/azure-ai-agents/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,11 @@

### Features Added

- Added protocol-style `listOptimizationCandidates(String, com.azure.core.http.rest.RequestOptions)` overloads on `AgentsClient` and `AgentsAsyncClient` for listing raw optimization candidate pages as `BinaryData`.

### Breaking Changes

- `listOptimizationCandidates` on `AgentsClient` and `AgentsAsyncClient` now returns paged optimization candidates (`PagedIterable<OptimizationCandidate>` / `PagedFlux<OptimizationCandidate>`) instead of `OptimizationCandidatePagedResult` / `Mono<OptimizationCandidatePagedResult>`. The `OptimizationCandidatePagedResult` model was removed. The protocol methods where adjusted accordingly.
### Bugs Fixed

### Other Changes
Expand Down
277 changes: 146 additions & 131 deletions sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsAsyncClient.java
View file
Open in desktop

Large diffs are not rendered by default.

251 changes: 122 additions & 129 deletions sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClient.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
import com.azure.ai.agents.models.CreateAgentVersionInput;
import com.azure.ai.agents.models.FoundryFeaturesOptInKeys;
import com.azure.ai.agents.models.JobStatus;
import com.azure.ai.agents.models.OptimizationCandidatePagedResult;
import com.azure.ai.agents.models.OptimizationCandidate;
import com.azure.ai.agents.models.OptimizationJob;
import com.azure.ai.agents.models.OptimizationJobInputs;
import com.azure.ai.agents.models.PageOrder;
Expand Down Expand Up @@ -4048,122 +4048,6 @@ public Response<Void> deleteOptimizationJobWithResponse(String jobId, RequestOpt
return this.serviceClient.deleteOptimizationJobWithResponse(jobId, requestOptions);
}

/**
* Returns a list of candidates for an optimization job.
*
* List candidates produced by a job.
* <p><strong>Query Parameters</strong></p>
* <table border="1">
* <caption>Query Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>limit</td><td>Integer</td><td>No</td><td>A limit on the number of objects to be returned. Limit can range
* between 1 and 100, and the
* default is 20.</td></tr>
* <tr><td>order</td><td>String</td><td>No</td><td>Sort order by the `created_at` timestamp of the objects. `asc`
* for ascending order and`desc`
* for descending order. Allowed values: "asc", "desc".</td></tr>
* <tr><td>after</td><td>String</td><td>No</td><td>A cursor for use in pagination. `after` is an object ID that
* defines your place in the list.
* For instance, if you make a list request and receive 100 objects, ending with obj_foo, your
* subsequent call can include after=obj_foo in order to fetch the next page of the list.</td></tr>
* <tr><td>before</td><td>String</td><td>No</td><td>A cursor for use in pagination. `before` is an object ID that
* defines your place in the list.
* For instance, if you make a list request and receive 100 objects, ending with obj_foo, your
* subsequent call can include before=obj_foo in order to fetch the previous page of the list.</td></tr>
* </table>
* You can add these to a request with {@link RequestOptions#addQueryParam}
* <p><strong>Header Parameters</strong></p>
* <table border="1">
* <caption>Header Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>Foundry-Features</td><td>String</td><td>No</td><td>A feature flag opt-in required when using preview
* operations or modifying persisted preview resources. Allowed values: "Evaluations=V1Preview",
* "Schedules=V1Preview", "RedTeams=V1Preview", "Insights=V1Preview", "MemoryStores=V1Preview",
* "Routines=V1Preview", "Toolboxes=V1Preview", "Skills=V1Preview", "DataGenerationJobs=V1Preview",
* "Models=V1Preview", "AgentsOptimization=V1Preview".</td></tr>
* </table>
* You can add these to a request with {@link RequestOptions#addHeader}
* <p><strong>Response Body Schema</strong></p>
*
* <pre>
* {@code
* {
* data (Required): [
* (Required){
* candidate_id: String (Optional)
* name: String (Required)
* config (Required): {
* agent_name: String (Optional)
* agent_version: String (Optional)
* model: String (Optional)
* system_prompt: String (Optional)
* skills (Optional): [
* (Optional){
* String: BinaryData (Required)
* }
* ]
* tools (Optional): [
* (Optional){
* String: BinaryData (Required)
* }
* ]
* }
* mutations (Required): {
* String: BinaryData (Required)
* }
* avg_score: double (Required)
* avg_tokens: double (Required)
* pass_rate: double (Required)
* task_scores (Required): [
* (Required){
* task_name: String (Required)
* query: String (Optional)
* scores (Required): {
* String: double (Required)
* }
* composite_score: double (Required)
* tokens: long (Required)
* duration_seconds: double (Required)
* passed: boolean (Required)
* error_message: String (Optional)
* rationales (Optional): {
* String: String (Required)
* }
* response: String (Optional)
* run_id: String (Optional)
* }
* ]
* is_pareto_optimal: boolean (Required)
* eval_id: String (Optional)
* eval_run_id: String (Optional)
* promotion (Optional): {
* promoted_at: long (Required)
* agent_name: String (Required)
* agent_version: String (Required)
* }
* }
* ]
* first_id: String (Optional)
* last_id: String (Optional)
* has_more: boolean (Required)
* }
* }
* </pre>
*
* @param jobId The optimization job id.
* @param requestOptions The options to configure the HTTP request before HTTP client sends it.
* @throws HttpResponseException thrown if the request is rejected by server.
* @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
* @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
* @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
* @return the response data for a requested list of items along with {@link Response}.
*/
@Generated
@ServiceMethod(returns = ReturnType.SINGLE)
public Response<BinaryData> listOptimizationCandidatesWithResponse(String jobId, RequestOptions requestOptions) {
return this.serviceClient.listOptimizationCandidatesWithResponse(jobId, requestOptions);
}

/**
* Get a candidate by id.
*
Expand Down Expand Up @@ -4571,13 +4455,13 @@ public void deleteOptimizationJob(String jobId) {
* @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
* @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
* @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
* @return the response data for a requested list of items.
* @return the response data for a requested list of items as paginated response with {@link PagedIterable}.
*/
@Generated
@ServiceMethod(returns = ReturnType.SINGLE)
public OptimizationCandidatePagedResult listOptimizationCandidates(String jobId,
@ServiceMethod(returns = ReturnType.COLLECTION)
public PagedIterable<OptimizationCandidate> listOptimizationCandidates(String jobId,
FoundryFeaturesOptInKeys foundryFeatures, Integer limit, PageOrder order, String after, String before) {
// Generated convenience method for listOptimizationCandidatesWithResponse
// Generated convenience method for listOptimizationCandidates
RequestOptions requestOptions = new RequestOptions();
if (foundryFeatures != null) {
requestOptions.setHeader(HttpHeaderName.fromString("Foundry-Features"), foundryFeatures.toString());
Expand All @@ -4594,8 +4478,8 @@ public OptimizationCandidatePagedResult listOptimizationCandidates(String jobId,
if (before != null) {
requestOptions.addQueryParam("before", before, false);
}
return listOptimizationCandidatesWithResponse(jobId, requestOptions).getValue()
.toObject(OptimizationCandidatePagedResult.class);
return serviceClient.listOptimizationCandidates(jobId, requestOptions)
.mapPage(bodyItemValue -> bodyItemValue.toObject(OptimizationCandidate.class));
}

/**
Expand All @@ -4610,15 +4494,15 @@ public OptimizationCandidatePagedResult listOptimizationCandidates(String jobId,
* @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
* @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
* @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
* @return the response data for a requested list of items.
* @return the response data for a requested list of items as paginated response with {@link PagedIterable}.
*/
@Generated
@ServiceMethod(returns = ReturnType.SINGLE)
public OptimizationCandidatePagedResult listOptimizationCandidates(String jobId) {
// Generated convenience method for listOptimizationCandidatesWithResponse
@ServiceMethod(returns = ReturnType.COLLECTION)
public PagedIterable<OptimizationCandidate> listOptimizationCandidates(String jobId) {
// Generated convenience method for listOptimizationCandidates
RequestOptions requestOptions = new RequestOptions();
return listOptimizationCandidatesWithResponse(jobId, requestOptions).getValue()
.toObject(OptimizationCandidatePagedResult.class);
return serviceClient.listOptimizationCandidates(jobId, requestOptions)
.mapPage(bodyItemValue -> bodyItemValue.toObject(OptimizationCandidate.class));
}

/**
Expand Down Expand Up @@ -5328,4 +5212,113 @@ public PromoteCandidateResult promoteOptimizationCandidate(String jobId, String
return promoteOptimizationCandidateWithResponse(jobId, candidateId, BinaryData.fromObject(candidateRequest),
requestOptions).getValue().toObject(PromoteCandidateResult.class);
}

/**
* Returns a list of candidates for an optimization job.
*
* List candidates produced by a job.
* <p><strong>Query Parameters</strong></p>
* <table border="1">
* <caption>Query Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>limit</td><td>Integer</td><td>No</td><td>A limit on the number of objects to be returned. Limit can range
* between 1 and 100, and the
* default is 20.</td></tr>
* <tr><td>order</td><td>String</td><td>No</td><td>Sort order by the `created_at` timestamp of the objects. `asc`
* for ascending order and`desc`
* for descending order. Allowed values: "asc", "desc".</td></tr>
* <tr><td>after</td><td>String</td><td>No</td><td>A cursor for use in pagination. `after` is an object ID that
* defines your place in the list.
* For instance, if you make a list request and receive 100 objects, ending with obj_foo, your
* subsequent call can include after=obj_foo in order to fetch the next page of the list.</td></tr>
* <tr><td>before</td><td>String</td><td>No</td><td>A cursor for use in pagination. `before` is an object ID that
* defines your place in the list.
* For instance, if you make a list request and receive 100 objects, ending with obj_foo, your
* subsequent call can include before=obj_foo in order to fetch the previous page of the list.</td></tr>
* </table>
* You can add these to a request with {@link RequestOptions#addQueryParam}
* <p><strong>Header Parameters</strong></p>
* <table border="1">
* <caption>Header Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>Foundry-Features</td><td>String</td><td>No</td><td>A feature flag opt-in required when using preview
* operations or modifying persisted preview resources. Allowed values: "Evaluations=V1Preview",
* "Schedules=V1Preview", "RedTeams=V1Preview", "Insights=V1Preview", "MemoryStores=V1Preview",
* "Routines=V1Preview", "Toolboxes=V1Preview", "Skills=V1Preview", "DataGenerationJobs=V1Preview",
* "Models=V1Preview", "AgentsOptimization=V1Preview".</td></tr>
* </table>
* You can add these to a request with {@link RequestOptions#addHeader}
* <p><strong>Response Body Schema</strong></p>
*
* <pre>
* {@code
* {
* candidate_id: String (Optional)
* name: String (Required)
* config (Required): {
* agent_name: String (Optional)
* agent_version: String (Optional)
* model: String (Optional)
* system_prompt: String (Optional)
* skills (Optional): [
* (Optional){
* String: BinaryData (Required)
* }
* ]
* tools (Optional): [
* (Optional){
* String: BinaryData (Required)
* }
* ]
* }
* mutations (Required): {
* String: BinaryData (Required)
* }
* avg_score: double (Required)
* avg_tokens: double (Required)
* pass_rate: double (Required)
* task_scores (Required): [
* (Required){
* task_name: String (Required)
* query: String (Optional)
* scores (Required): {
* String: double (Required)
* }
* composite_score: double (Required)
* tokens: long (Required)
* duration_seconds: double (Required)
* passed: boolean (Required)
* error_message: String (Optional)
* rationales (Optional): {
* String: String (Required)
* }
* response: String (Optional)
* run_id: String (Optional)
* }
* ]
* is_pareto_optimal: boolean (Required)
* eval_id: String (Optional)
* eval_run_id: String (Optional)
* promotion (Optional): {
* promoted_at: long (Required)
* agent_name: String (Required)
* agent_version: String (Required)
* }
* }
* }
* </pre>
*
* @param jobId The optimization job id.
* @param requestOptions The options to configure the HTTP request before HTTP client sends it.
* @throws HttpResponseException thrown if the request is rejected by server.
* @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
* @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
* @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
* @return the response data for a requested list of items as paginated response with {@link PagedIterable}.
*/
@Generated
@ServiceMethod(returns = ReturnType.COLLECTION)
public PagedIterable<BinaryData> listOptimizationCandidates(String jobId, RequestOptions requestOptions) {
return this.serviceClient.listOptimizationCandidates(jobId, requestOptions);
}
}
Loading
Loading