3.0.0 (2026-11-12)
Breaking Changes
-
AzureFunctionDefinitionFunctionwas removed, please use the same class fromAzure.AI.Extensions.OpenAI. -
Renamed
GenerateVoiceAgentRequesttoGenerateVoiceAgentContentandUpdateToolboxRequesttoUpdateToolboxContent. -
Removed the
AgentCard(string, IEnumerable<AgentCardSkill>)andVersionSelector(IEnumerable<VersionSelectionRule>)constructors. Use the parameterless constructors and setVersion/SkillsandVersionSelectionRuleswith initializers. -
TelephonyTransferTargetconstructor no longer takesname; set theNameproperty instead. -
AgentReferenceclass was removed, please use classAgentReferencefromAzure.AI.Extensions.OpenAIpackage. -
MCPToolboxToolwas renamed toMcpToolboxTool. -
PSTNTelephonyTransferDestinationwas renamed toPstnTelephonyTransferDestination. -
The order of
GetAgentVersionsAsyncandGetAgentVersionsarguments was changed. Now it isstring agentName, bool? includeDrafts, int? limit = default, AgentListOrder? order = default, string after = default, string before = default, CancellationToken cancellationToken = default. -
The
DownloadAgentCodeandDownloadAgentCodeAsyncmethods ofAgentAdministrationClientare now returningClientResult<BinaryData>andTask<ClientResult<BinaryData>>respectively. -
The
DownloadandDownloadAsyncmethods ofAgentSessionFilesare now returning returningClientResult<BinaryData>andTask<ClientResult<BinaryData>>respectively. -
Renamed the following models and their
ProjectsAgentsModelFactorymethods:Previous Replacement AgentOptimizationCandidatePromotionInfoAgentOptimizationCandidatePromotionHeaderTelemetryEndpointAuthHeaderTelemetryEndpointAuthenticationInlineSkillParamInlineSkillInlineSkillSourceParamInlineSkillSourceSkillReferenceAgentSkillReferenceSkillReferenceParamSkillReferenceTelemetryConfigTelemetryConfigurationVersionRefIndicatorVersionReferenceIndicatorVoiceAgentAudioConfigVoiceAgentAudioConfigurationVoiceAgentAudioInputConfigVoiceAgentAudioInputConfigurationVoiceAgentAudioOutputConfigVoiceAgentAudioOutputConfigurationVoiceAgentAvatarConfigVoiceAgentAvatarConfigurationVoiceAgentAvatarVideoParamsVoiceAgentAvatarVideoParametersVoiceAgentGreetingConfigVoiceAgentGreetingConfigurationVoiceAgentInterimResponseConfigVoiceAgentInterimResponseConfigurationVoiceAgentLlmGeneratedGreetingConfigVoiceAgentLlmGeneratedGreetingConfigurationVoiceAgentLlmInterimResponseConfigVoiceAgentLlmInterimResponseConfigurationVoiceAgentPostCallConfigVoiceAgentPostCallConfigurationVoiceAgentSoundscapeConfigVoiceAgentSoundscapeConfigurationVoiceAgentSoundscapeSourceConfigVoiceAgentSoundscapeSourceConfigurationVoiceAgentSoundscapeTrackConfigVoiceAgentSoundscapeTrackConfigurationVoiceAgentSoundscapeWorkingTrackConfigVoiceAgentSoundscapeWorkingTrackConfigurationVoiceAgentStaticInterimResponseConfigVoiceAgentStaticInterimResponseConfigurationVoiceAgentSubagentConfigVoiceAgentSubagentConfigurationVoiceAgentTemplateGreetingConfigVoiceAgentTemplateGreetingConfigurationVoiceAgentTurnDetectionConfigVoiceAgentTurnDetectionConfiguration -
SkillReferenceandProjectsAgentsModelFactory.SkillReferencenow refer to the formerSkillReferenceParamcontainer skill. UseAgentSkillReferenceandProjectsAgentsModelFactory.AgentSkillReferencefor the previous agent skill reference. -
Renamed the following properties and their corresponding model-factory parameters where present. Type names in the table reflect the renamed models above.
Type Previous Replacement A2AToolboxTool,A2APreviewToolboxToolBaseUrlBaseUriTelephonyBinding,TelephonyBindingListItemIncomingCallUrlIncomingCallUriVoiceAgentAudioOutputConfigurationCustomLexiconUrl,CustomTextNormalizationUrlCustomLexiconUri,CustomTextNormalizationUriVoiceAgentAvatarVideoBackgroundImageUrlImageUriVoiceAgentMcpToolServerUrlServerUriTelephonyCallRecord,TelephonyCallSummary,VoiceAudioItem,VoiceGeneratedAudioItem,VoiceRecordingDurationMsDurationVoiceAudioItem,VoiceGeneratedAudioItemStartOffsetMsStartOffsetAgentOptimizationJobRunDurationMsRunDurationAgentOptimizationCandidateEvaluation,AgentOptimizationJobLatencyAvgLatencyMsAvgLatencySessionConfigurationIdleTimeoutSecondsIdleTimeoutVoiceAgentEndOfUtteranceDetectionTimeoutMsTimeoutVoiceAgentInterimResponseConfigurationLatencyThresholdMsLatencyThresholdFileSearchToolboxToolMaxNumResultsMaxResultCountUserConversationSimulationConfigurationDesiredNumTurns,MaxNumTurnsDesiredTurnCount,MaxTurnCountToolboxPoliciesRaiConfigContentFilterConfiguration -
On
VoiceAgentServerVadTurnDetection,VoiceAgentAzureSemanticVadTurnDetection,VoiceAgentAzureSemanticVadEnTurnDetection, andVoiceAgentAzureSemanticVadMultilingualTurnDetection, renamedPrefixPaddingMs,SilenceDurationMs, andSpeechDurationMstoPrefixPadding,SilenceDuration, andSpeechDuration. OnVoiceAgentServerVadTurnDetection,IdleTimeoutMswas also renamed toIdleTimeout, andIdleTimeout,PrefixPadding, andSilenceDurationchanged fromlong?toTimeSpan?. Convert millisecond values withTimeSpan.FromMilliseconds. The corresponding model-factory parameters changed as well. -
On those four turn-detection types and
VoiceAgentSemanticVadTurnDetection, renamedCreateResponseandInterruptResponsetoCreateResponseEnabledandInterruptResponseEnabled, including the corresponding model-factory parameters. -
CallableToolAllowedCaller,VoiceAgentAudioInputConfigTranscriptionDelay,VoiceAgentAudioTimestampType,VoiceAgentEchoCancellationReferenceSource, andVoiceAgentSessionIncludeOptionchanged from enums to extensible structs. Replace enum-specific casts and constantswitchcases with comparisons against their static values. -
AllowedCallersis now get-only onCodeInterpreterToolboxTool,McpToolboxTool, andVoiceAgentMcpTool; add items to the collection instead of replacing it. TheShellToolboxTool.AllowedCallerssetter was also removed. -
Renamed
AgentAdministrationClient.GetAgentOptimizationJobCandidatesClienttoGetAgentOptimizationJobCandidates. -
AgentAdministrationClient.GetSessionLogStreamandGetSessionLogStreamAsyncare now experimental and require theAAIP001diagnostic to be suppressed on supported target frameworks. -
Renamed the
internalMaxOutputTokensnamed parameter ofProjectsAgentsModelFactory.VoiceAgentDefinitiontomaxOutputTokens.
Bugs Fixed
- Fixed the cancellation of
ToolboxRecordupdate.