Regenerate Azure AI Agents client - #50412
Mike Guo (guotuofeng) merged 15 commits into
Conversation
|
Azure Pipelines: Successfully started running 278 pipeline(s). 36 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run. |
83fca5a to
c5283e1
Compare
c5283e1 to
47d31fc
Compare
There was a problem hiding this comment.
🟡 Changes recommended
Unresolved critical and moderate review findings remain.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
Regenerates the Azure AI Agents Java client from updated TypeSpec sources, adding voice, realtime, telephony, routing, toolbox, and protocol APIs while excluding WebSocket transport wiring.
Changes:
- Updates TypeSpec pins, dependencies, metadata, spell-check terms, and API acknowledgements.
- Regenerates clients, builders, REST implementations, polling strategies, and models.
- Adds preview API customizations and generated voice, realtime, and telephony surfaces.
Outstanding findings include critical import, preview-header, and model-serialization issues; a moderate polling-status issue; and nit-level missing @Beta annotations. These have 1–3 votes as recorded in the review.
File summaries
| File | Summary |
|---|---|
sdk/ai/cspell.yml |
Adds generated terminology. |
sdk/ai/azure-ai-agents/tsp-location.yaml |
Updates TypeSpec source and dependencies. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceType.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceResponseBaseStatus.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceResponseBaseOutputModality.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceResponseBaseObject1.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceResponseBaseObject.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceResponseAudio.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceOutputModality.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceModelType.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceConversationStatus.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAudioRole.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAudioContainerFormat.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAudioCodec.java |
Regenerated voice model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentTurnDetectionType.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentTransport.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentToolResponseScheduling.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentSystemToolName.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentSubagentAbortReason.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentSessionIncludeOption.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentSemanticVadTurnDetectionEagerness.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentResponseCreateParamsConversation.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentNoiseReductionType.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentInterimResponseTrigger.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentFunctionToolType.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentEndOfUtteranceThresholdLevel.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentEndOfUtteranceDetectionModel.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentEchoCancellationReferenceSource.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentAvatarType.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentAvatarOutputProtocol.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentAudioTimestampType.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentAudioInputConfigTranscriptionDelay.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/VoiceAgentAnimationOutputType.java |
Regenerated voice-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TranscriptionLanguage.java |
Regenerated transcription model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolType.java |
Regenerated tooling model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolConfig.java |
Regenerated tooling model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolChoiceOptions.java |
Regenerated tooling model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxVersions.java |
Regenerated toolbox model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxToolType.java |
Regenerated toolbox model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ToolboxTool.java |
Regenerated toolbox model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/Tool.java |
Regenerated tooling model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyTransferDestinationKind.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyProvider.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyOutboundRetryPolicyType.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyOutboundDestinationType.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyOperationStatus.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCampaignScheduleType.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCampaignRecipientImportStatus.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCampaignRecipientImportFormat.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCampaignDuplicateHandling.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCampaignConfigurationStatus.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCallTraceStatus.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCallTraceMode.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCallTimestampSource.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCallStatus.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCallLifecycleEventSource.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCallLifecycleEventOutcome.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyCallDurationBasis.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/TelephonyBindingStatus.java |
Regenerated telephony model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SessionAffinitySource.java |
Regenerated session-affinity model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SessionAffinityRequestMode.java |
Regenerated session-affinity model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SessionAffinityMode.java |
Regenerated session-affinity model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/SessionAffinityDecision.java |
Regenerated session-affinity model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeTurnDetectionType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeSessionCreateRequestUnionType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeServerEventResponseContentPartDonePartType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeServerEventResponseContentPartAddedPartType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeServerEventRateLimitsUpdatedRateLimitsName.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeServerEventConversationCreatedConversationObject.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeResponseStatusDetailsType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeResponseStatusDetailsReason.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeReasoningEffort.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeMcpErrorType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemObject.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageUserStatus.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageUserContentType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageUserContentDetail.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageSystemStatus.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageSystemContentType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageAssistantStatus.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemMessageAssistantContentType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemFunctionCallStatus.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeConversationItemFunctionCallOutputStatus.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeClientEventSessionUpdateSessionTruncation.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeClientEventSessionUpdateSessionOutputModality.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeAudioFormatsType.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeAudioFormatsAudioPcmRate.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RealtimeAudioFormatsAudioPcma.java |
Regenerated realtime model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RaiInvocationMode.java |
Regenerated responsible-AI model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/RaiInvocationContentType.java |
Regenerated responsible-AI model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/PublishTelephonyCampaignRequest.java |
Regenerated telephony request model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/PromptCacheBreakpointConfig.java |
Regenerated prompt model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/PromptAgentDefinition.java |
Regenerated prompt-agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/NoiseReductionType.java |
Regenerated audio model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ModelRouterDetails.java |
Regenerated routing model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/McpListToolsToolInputSchema.java |
Regenerated MCP model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/McpListToolsToolAnnotations.java |
Regenerated MCP model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/ImageDetail.java |
Regenerated image model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/GitHubCopilotHarness.java |
Regenerated GitHub Copilot model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/GitHubCopilotBuiltInTool.java |
Regenerated GitHub Copilot model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/FileInputDetail.java |
Regenerated file-input model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/CreateTranscriptionResponseJsonUsageType.java |
Regenerated transcription model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AzureCreateResponseOptions.java |
Regenerated response model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentOptimizationJobProgress.java |
Regenerated agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentKind.java |
Regenerated agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentEndpointProtocol.java |
Regenerated agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentDetails.java |
Regenerated agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/models/AgentDefinition.java |
Regenerated agent model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/SyncOperationLocationPollingStrategy.java |
Updates synchronous polling implementation. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/OperationLocationPollingStrategy.java |
Updates asynchronous polling implementation. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/models/TransferTelephonyCallRequest.java |
Regenerated implementation model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/models/AgentDefinitionOptInKeys.java |
Regenerated opt-in model. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/JsonMergePatchHelper.java |
Updates JSON merge-patch support. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/implementation/AgentsClientImpl.java |
Regenerated REST client implementation. |
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java |
Adds generated client factories and preview configuration. |
sdk/ai/azure-ai-agents/assets.json |
Updates generated asset metadata. |
Review details
Suppressed comments (5)
sdk/ai/azure-ai-agents/customizations/src/main/java/AgentsCustomizations.java:126
- The custom polling strategy now sends each GET through
AgentsServicePollUtils, but that helper parses the body without validatingresponse.getStatusCode(). A 401/404/5xx response (especially an empty one) is therefore returned asIN_PROGRESS, causing the poller to retry or time out instead of surfacing the service error. Preserve the generated 2xx validation for both async and sync polling before converting the body to aPollResponse.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java:718 - The generated telephony operations require the
voice_agents_v1_previewopt-in, but this builder creates the client withbuildInnerClient()and therefore does not prepend theFoundry-Features: VoiceAgents=V1Previewpolicy. Requests made through the sync telephony client can consequently be rejected as missing the preview feature; pass the same preview key used by the endpoint-conversations builder.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java:717 - This public factory returns the preview-only
BetaAgentTelephonyClient, but the factory itself is only@Generated. The other public preview factories in the beta builder are annotated@Beta; without the method annotation, API consumers do not receive the preview warning at the entry point. Mark this factory@Betaas well.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java:705 - This public factory returns the preview-only
BetaAgentEndpointConversationsAsyncClient, but the factory itself is only@Generated. The other public preview factories in the beta builder are annotated@Beta; without the method annotation, API consumers do not receive the preview warning at the entry point. Mark this factory@Betaas well.
sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java:727 - This public factory returns the preview-only
BetaAgentEndpointConversationsClient, but the factory itself is only@Generated. The other public preview factories in the beta builder are annotated@Beta; without the method annotation, API consumers do not receive the preview warning at the entry point. Mark this factory@Betaas well.
- Files reviewed: 81/407 changed files
- Comments generated: 4
- Review effort level: Lite
💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.
08ec0cf to
f049152
Compare
f049152 to
9c4f534
Compare
9c4f534 to
9073446
Compare
9073446 to
326968c
Compare
e9bf5a8 to
ce726ac
Compare
|
Pushed Agents fixes and synchronized the stack on 2026-09-15.
Both upper branches were pushed atomically without force. Stack bases remain #50407 -> #50412 -> #50408. The Agents foundation playback rerun passed after the test-name correction. On the combined Core tree, both packages built and passed Checkstyle, SpotBugs, Revapi, and Javadoc. Agents playback: 463 tests, 0 failures/errors, 26 skipped. Projects playback: 148 tests, 0 failures/errors, 24 skipped. No unrelated Schema Registry changes were committed. Live tests were not run; current CI results are separate. |
7b1e432 to
3ba5f33
Compare
3ba5f33 to
9e054ef
Compare
077c2ed to
4f79f97
Compare
4f79f97 to
422d361
Compare
Superseded
This PR was intentionally absorbed into #50407. The
myguo/voice-projects-generatedbranch now points to the same combined Projects + generated Agents foundation commit (422d36171d9). Review the combined foundation in #50407.Previous Description
Agents foundation of the original three-PR stack, based on #50407. Its generated Agents changes, tests, preview annotations, polling updates, release notes, and recording assets are now included directly in #50407.
The upper handwritten Core PR remains #50408 and is being retargeted directly to #50407.
Validation
Before consolidation, the combined foundation passed:
No generated content was rewritten during consolidation; #50407 was fast-forwarded to this PR's existing head.