Skip to content

Regenerate Azure AI Agents client - #50412

Merged
Mike Guo (guotuofeng) merged 15 commits into
myguo/voice-projects-generatedfrom
myguo/voice-agents-generated
Sep 16, 2026
Merged

Mike Guo (guotuofeng) merged 15 commits into
myguo/voice-projects-generatedfrom
myguo/voice-agents-generated

Conversation

@guotuofeng

@guotuofeng Mike Guo (guotuofeng) commented Sep 11, 2026

Copy link
Copy Markdown
Member

Superseded

This PR was intentionally absorbed into #50407. The myguo/voice-projects-generated branch 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:

  • Projects: 103 tests total, 79 passed, 24 skipped, zero failures/errors.
  • Agents: 320 tests total, 300 passed, 20 skipped, zero failures/errors.
  • Both modules passed Checkstyle with zero violations and strict RevApi against 2.5.0.
  • Main, test, sample, Javadoc, and Java 8 compilation completed as part of the clean package builds.

No generated content was rewritten during consolidation; #50407 was fast-forwarded to this PR's existing head.

@azure-pipelines

Copy link
Copy Markdown
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.

Copilot AI lite review requested due to automatic review settings September 11, 2026 02:17

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 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 validating response.getStatusCode(). A 401/404/5xx response (especially an empty one) is therefore returned as IN_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 a PollResponse.
    sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java:718
  • The generated telephony operations require the voice_agents_v1_preview opt-in, but this builder creates the client with buildInnerClient() and therefore does not prepend the Foundry-Features: VoiceAgents=V1Preview policy. 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 @Beta as 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 @Beta as 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 @Beta as 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.

Comment thread sdk/ai/azure-ai-agents/customizations/src/main/java/AgentsCustomizations.java Outdated
Comment thread sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java Outdated
Comment thread sdk/ai/azure-ai-agents/src/main/java/com/azure/ai/agents/AgentsClientBuilder.java Outdated
@guotuofeng
Mike Guo (guotuofeng) force-pushed the myguo/voice-agents-generated branch 2 times, most recently from 08ec0cf to f049152 Compare September 11, 2026 05:48
Comment thread sdk/ai/azure-ai-agents/customizations/src/main/java/AgentsCustomizations.java Outdated
Comment thread sdk/ai/azure-ai-agents/customizations/src/main/java/AgentsCustomizations.java Outdated
Comment thread sdk/ai/azure-ai-agents/customizations/src/main/java/AgentsCustomizations.java Outdated
@guotuofeng

Copy link
Copy Markdown
Member Author

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.

@guotuofeng
Mike Guo (guotuofeng) force-pushed the myguo/voice-agents-generated branch 2 times, most recently from 7b1e432 to 3ba5f33 Compare September 15, 2026 11:21
@guotuofeng
Mike Guo (guotuofeng) merged commit 422d361 into main Sep 16, 2026
10 checks passed
@guotuofeng
Mike Guo (guotuofeng) deleted the myguo/voice-agents-generated branch September 16, 2026 06:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants