Azure SDK for .NET (June 2026)
The Azure SDK team is pleased to announce our June 2026 client library releases.
112 packages released this month.
Stable Packages (24)
-
Azure AI Transcription
-
Core - Client - Core
-
Identity Broker
-
Key Vault - Certificates
-
Resource Management - App Service
-
Resource Management - Application Insights
-
Resource Management - Batch
-
Resource Management - Certificateregistration
-
Resource Management - Compute.Recommender
-
Resource Management - Computelimit
-
Resource Management - Container Service
-
Resource Management - Data Protection
-
Resource Management - Fileshares
-
Resource Management - Managed Network Fabric
-
Resource Management - Storage
-
Storage - Blobs
-
Storage - Blobs Batch
-
Storage - Common
-
Storage - Files Data Lake
-
Storage - Files Share
-
Storage - Queues
-
System.ClientModel
-
Text Translation
-
Voice Live
Patch Updates (20)
-
Blob Storage Key Store for .NET Data Protection
-
Key Encryptor for .NET Data Protection
-
OpenTelemetry Exporter
-
Resource Management - Artifactsigning
-
Resource Management - Authorization
-
Resource Management - Azure VMware Solution
-
Resource Management - Container Instances
-
Resource Management - Cosmos DB
-
Resource Management - Data Box
-
Resource Management - Data Box Edge
-
Resource Management - Data Factory
-
Resource Management - Data Migration
-
Resource Management - Dell.Storage
-
Resource Management - Dynatrace
-
Resource Management - Elastic
-
Resource Management - ElasticSan
-
Resource Management - Front Door
-
Resource Management - NetApp Files
-
Resource Management - Private DNS
-
WebJobs Extensions - Web PubSub
Beta Packages (43)
-
AI Agent Server - Core
-
AI Foundry
-
Azure AI Search
-
Confidential Ledger
-
Content Understanding
-
Identity Broker
-
Key Vault - Administration
-
Key Vault - Certificates
-
Key Vault - Keys
-
Key Vault - Secrets
-
Resource Management - Azure Stack HCI
-
Resource Management - Chaos
-
Resource Management - Cloudhealth
-
Resource Management - Compute Schedule
-
Resource Management - Computebulkactions
-
Resource Management - Connectedcache
-
Resource Management - Container Apps
-
Resource Management - Container Service Fleet
-
Resource Management - Content Delivery Network
-
Resource Management - DNS
-
Resource Management - DNS Resolver
-
Resource Management - Datadog
-
Resource Management - Device Provisioning Services
-
Resource Management - Edgeactions
-
Resource Management - Event Grid
-
Resource Management - Event Hubs
-
Resource Management - Fabric
-
Resource Management - Horizondb
-
Resource Management - Managed Grafana
-
Resource Management - Managed Service Identity
-
Resource Management - Monitor.Pipelinegroups
-
Resource Management - Monitor.Slis
-
Resource Management - Monitor.Workspaces
-
Resource Management - Notification Hubs
-
Resource Management - Redhatopenshift
-
Resource Management - Resiliencemanagement
-
Resource Management - Resource Mover
-
Resource Management - Self Help
-
Resource Management - Service Networking
-
Resource Management - Traffic Manager
-
Storage - Blobs ChangeFeed
-
Voice Live
-
unknown
Release highlights
AI Agent Server - Core 1.0.0-beta.25 Changelog
Bugs Fixed
- Corrected
FoundryEnrichmentProcessorto emit the Agent365 blueprint telemetry key asmicrosoft.a365.agent.blueprint.id(previously emitted asgen_ai.agent.blueprint.idin this code path).
AI Agent Server - Core 1.0.0-beta.24 Changelog
Features Added
- Added Agent365 tracing export support with managed identity token acquisition when
FOUNDRY_AGENT365_TRACING_ENABLEDis set. - Added
AgentInstanceClientId,AgentBlueprintClientId,AgentTenantId, andIsAgent365TracingEnabledproperties toFoundryEnvironment. - Added
FoundryEnrichmentProcessorattributes:gen_ai.agent.blueprint.id,microsoft.tenant.id, andmicrosoft.foundry.agent.typeon telemetry spans. - Added
W3CBaggagePropagatormiddleware that parses the W3Cbaggageheader intoActivity.Baggageon all target frameworks (net8.0, net9.0, net10.0). - Configured W3C Trace Context and Baggage propagators via
Sdk.SetDefaultTextMapPropagatorfor outgoing request propagation. - Added conditional exporter registration: Azure Monitor, OTLP, and Agent365 exporters activate only when their respective environment variables are set.
- Added
PlatformHeaders.ErrorSource(x-platform-error-source),PlatformHeaders.ErrorDetail(x-platform-error-detail), and error source value constants (ErrorSourceUser,ErrorSourcePlatform,ErrorSourceUpstream) for error classification per container-image-spec §8. - Replaced
Azure.Monitor.OpenTelemetry.AspNetCorewith the unifiedMicrosoft.OpenTelemetrydistro for telemetry. The new distro auto-detects Azure Monitor and OTLP exporters from environment variables and eliminates the need for duplicate-instrumentation guards. - Added
FoundryEnvironment.WebSocketKeepAliveInterval(sourced from theWS_KEEPALIVE_INTERVALenvironment variable) for the newinvocations_ws(WebSocket) protocol. Wired throughAgentHostMiddlewareExtensions.UseAgentServerCoreinto Kestrel’sWebSocketOptions.KeepAliveInterval, so a positive value emits RFC 6455 protocol-level Ping frames (opcode0x9) that keep idle WebSocket connections alive across upstream proxy / load-balancer idle timeouts. Disabled by default (Timeout.InfiniteTimeSpan). UseAgentServerCorenow also callsIApplicationBuilder.UseWebSockets, so any protocol library that hosts WebSocket endpoints (e.g., the Invocations/invocations_wsendpoint) works out of the box without the consumer having to wireUseWebSocketsthemselves.
AI Foundry 2.1.0-beta.3 Changelog
Features Added
- Added
AIProjectModelsclient for model weights management, accessible viaAIProjectClient. - Added memory store item CRUD operations for management of memories inside the
MemoryStore.
AI Foundry 2.1.0-beta.2 Changelog
Bugs Fixed
- Fixed missing header required by
ProjectInsights.
Features Added
- Added
DataGenerationJobsclient for synthetic data generation, accessible viaAIProjectClient. - Added data generation job types:
DataGenerationJob,DataGenerationJobInputs,DataGenerationJobResult,DataGenerationModelOptions,DataGenerationTokenUsage. - Added data generation job options:
SimpleQnADataGenerationJobOptions,TaskDataGenerationJobOptions,ToolUseFineTuningDataGenerationJobOptions,TracesDataGenerationJobOptions. - Added data generation source types:
AgentDataGenerationJobSource,DatasetDataGenerationJobSource,FileDataGenerationJobSource,PromptDataGenerationJobSource,TracesDataGenerationJobSource. - Added data generation output types:
DatasetDataGenerationJobOutput,FileDataGenerationJobOutput.
Azure AI Search 12.1.0-beta.1 Changelog
Features Added
- Added support for
2026-05-01-previewservice version. - Added MCP server knowledge source types:
McpServerKnowledgeSource,McpServerKnowledgeSourceParameters,McpServerAuthentication,McpServerFoundryConnectionAuthentication,McpServerStoredHeadersAuthentication,McpServerHeaders,McpServerTool,McpServerToolInclusionMode,McpServerOutputParsing,McpServerAutoOutputParsing,McpServerJsonOutputParsing,McpServerSplitOutputParsing,McpServerNoneOutputParsing, and related configuration models. - Added knowledge source types:
FabricDataAgentKnowledgeSource,FabricOntologyKnowledgeSource,FileKnowledgeSource,IndexedSqlKnowledgeSource, andWorkIQKnowledgeSourcewith associated parameters and retrieval params. - Added knowledge base reference types:
KnowledgeBaseFabricDataAgentReference,KnowledgeBaseFabricOntologyReference,KnowledgeBaseWorkIQReference,KnowledgeBaseMcpServerReference,KnowledgeBaseFileReference,KnowledgeBaseRemoteSharePointReference,KnowledgeBaseIndexedSharePointReference, andKnowledgeBaseIndexedSqlReference. - Added knowledge source file management operations:
UploadKnowledgeSourceFileAsync,GetKnowledgeSourceFilesAsync, andDeleteKnowledgeSourceFileAsynconSearchIndexClient, along with theKnowledgeSourceFilemodel. - Added
FreshnessPolicyfor freshness-based document boosting, andEnableFreshnessproperty onKnowledgeSourceReferencefor per-source freshness opt-in. - Added
AIServicesclass for configuring AI Services resources onKnowledgeSourceIngestionParameters. - Added
KnowledgeSourceContentExtractionModefor specifying content extraction behavior during ingestion. - Added
KnowledgeRetrievalOutputModefor controlling knowledge base retrieval output format. - Added knowledge source vectorizer types:
KnowledgeSourceVectorizerandKnowledgeSourceAzureOpenAIVectorizer. - Added knowledge base activity record types for all knowledge source kinds:
KnowledgeBaseFileActivityRecord,KnowledgeBaseMcpServerActivityRecord, and per-source activity records with associated argument types. - Added
ContentColumnMappingandEmbeddingColumnMappingfor column mapping configuration. - Added
SharePointConnectorAppRegistrationfor SharePoint connector authentication. - Added
PurviewSensitivityLabelInfofor Purview sensitivity label support. - Added
WorkIQAttributionfor WorkIQ attribution tracking. - Added
AssetStorefor asset store configuration. - Added
KnowledgeSourceSynchronizationErrorfor knowledge source sync error reporting. - Added
failOnError,maxOutputDocuments, andenableImageServingproperties toKnowledgeSourceParams. - Added
KnowledgeBaseImageContentwith public constructor and settableUrlproperty.
Azure AI Transcription 1.0.0 Changelog
Breaking Changes
- Removed
TranscriptionResult.PhrasesByChanneland the associatedTranscribedPhrasestype. UseTranscriptionResult.Phrasesfor the flat phrase list andTranscriptionResult.CombinedPhrasesfor the per-channel combined transcript.
Blob Storage Key Store for .NET Data Protection 1.5.3 Changelog
Bugs Fixed
- Fixed a misalignment between the explicit
net8.0target of this package and itsMicrosoft.AspNetCore.DataProtectiondependency, which does not offer anet8.0asset in the 10.x version. The dependency now resolves to version 8.0.26 when targetingnet8.0, ensuring consumers receive a framework-compatible asset and eliminating the associated dependency warnings.
Confidential Ledger 1.4.1-beta.5 Changelog
Bugs Fixed
- Improved redirect performance for write operations by caching the latest primary node URL from redirect responses and reusing it for subsequent non-GET requests. The cache is lazily populated and refreshed whenever the service redirects to a different primary node.
Content Understanding 1.2.0-beta.2 Changelog
Bugs Fixed
- Filtered service-emitted
LLMStats:telemetry entries from the renderedrai_warningsfront matter inToLlmInput.
Core - Client - Core 1.58.0 Changelog
Bugs Fixed
- Fixed
NullReferenceExceptionthrown byOperation.RehydrateAsync/ArmOperation.RehydrateAsync(and the resulting operation’sUpdateStatusAsync/Value) when the rehydrated long-running operation has completed with a failure.OperationState.FailureandOperationState<T>.Failurenow honor their documented contract and materialize a defaultRequestFailedExceptionfrom the raw response when the caller passesnull, matching the behavior of the non-rehydration polling path. - Fixed
DiagnosticScopeto mark the parentActivityContextas remote (IsRemote = true) when a traceparent is provided viaSetTraceContextorAddLink. The traceparent in these paths is always extracted from an external source (e.g. a messaging broker’s application properties), so samplers that distinguish local vs. remote parents — such as theRateLimitedSamplerused by the Azure Monitor OpenTelemetry exporter — can now make correct decisions for activities started from incoming messages.
Features Added
- Adopt System.ClientModel 1.14.0
Core - Client - Core 1.57.0 Changelog
Breaking Changes
- Removed experimental (
SCME0002)WithAzureCredentialextension methods onClientSettingsandIClientBuilder. For DI, useAddAzureClient<TClient, TSettings>/AddKeyedAzureClient<TClient, TSettings>(which registerAzureCredentialResolverautomatically), or callAddAzureCredentialResolver()followed byAddClient<TClient, TSettings>/AddKeyedClient<TClient, TSettings>. For standalone scenarios, useIConfiguration.GetAzureClientSettings<T>(...)orIConfiguration.GetAzureCredentialSettings(...).
Features Added
- Added
RequestContent.Create(BinaryContent)overload that adapts aSystem.ClientModel.BinaryContentinstance into aAzure.Core.RequestContentinstance. - Added experimental (
SCME0002)AzureCredentialResolverthat resolves Azure token credential sections (e.g.AzureCliCredential,ManagedIdentityCredential,ChainedTokenCredential) intoTokenCredentialinstances.ApiKeyCredentialsections are not claimed — clients dispatch onCredential.CredentialSourcethemselves. - Added experimental (
SCME0002) extensions onAzure.Identity.ConfigurationExtensions: AddAzureCredentialResolver()onIServiceCollectionandIHostApplicationBuilder— idempotent DI registration.IConfiguration.GetAzureCredentialSettings(sectionName, ...)— returnsCredentialSettings?withTokenProviderpopulated for token sources andKeypopulated for inline ApiKey sources, so a single call site can dispatch on either shape without binding aClientSettings.IConfiguration.GetAzureClientSettings<T>(sectionName, params CredentialResolver[] resolvers)— resolver-aware overload.- The Azure OpenAI default-scope quirk now writes
Credential:Scopeat the credential-section root (the canonical SCM 1.12.0+ location) instead ofCredential:AdditionalProperties:Scope. SCM 1.12.0 reads both locations so existing configs continue to work.
Core - Client - Core 1.56.0 Changelog
Features Added
- Added experimental
TokenRequestCallbackproperty andTokenRequestCallbackContexttype to MSAL-backed credential options to allow customizing token request body parameters before they are sent to the identity provider.
Core - Client - Core 1.59.0 Changelog
Bugs Fixed
- Fixed
BearerTokenAuthenticationPolicyso that theAuthorizationheader is no longer re-attached to a request that has been redirected to a different host. Previously,RedirectPolicywould strip theAuthorizationheader before following a redirect, but the per-retryBearerTokenAuthenticationPolicywould re-add the cached bearer token to the redirected request — including when the redirect target was a different host. The policy now detects when the request URI authority has changed since it last authorized the message, defensively strips anyAuthorizationheader, and skips both re-authorization and theWWW-Authenticate(CAE)401handler so that no bearer token is sent to — or fetched in response to a challenge from — the redirect target. Same-host redirects, normal (non-redirected) requests, and CAE handling against the original host are unchanged. Callers who explicitly enabled auto-redirect (viaHttpPipelineTransportOptions.IsClientRedirectEnabled = trueorRedirectPolicy.SetAllowAutoRedirect(message, true)) and depended on the bearer token being re-attached on cross-host redirects should construct a separate client targeting the redirect-target host with a credential bound to that host’s resource.
Features Added
- Added experimental (
AZID0004) mTLS Proof-of-Possession token binding support for managed identity scenarios, including dynamic host capability detection via MSAL and transport certificate rotation APIs onBearerTokenAuthenticationPolicy.
Identity Broker 1.7.0 Changelog
Features Added
- Added
BrokerCredentialResolverandAddBrokerCredentialResolver()extensions for config- and DI-based resolution ofBrokerCredentialandVisualStudioCodeCredentialsources. (Experimental,SCME0002.)
Identity Broker 1.8.0-beta.1 Changelog
Features Added
- Added
ManagedIdentityCredentialAttestationOptionsto enable Credential Guard key attestation support for managed identity mTLS Proof-of-Possession flows.
Key Encryptor for .NET Data Protection 1.6.3 Changelog
Bugs Fixed
- Fixed a misalignment between the explicit
net8.0target of this package and itsMicrosoft.AspNetCore.DataProtectiondependency, which does not offer anet8.0asset in the 10.x version. The dependency now resolves to version 8.0.26 when targetingnet8.0, ensuring consumers receive a framework-compatible asset and eliminating the associated dependency warnings.
Key Vault - Administration 4.9.0-beta.1 Changelog
Features Added
- Added
KeyVaultEkmClientto support External Key Management operations.
Key Vault - Administration 4.9.0-beta.2 Changelog
Features Added
- Added support for Proof-of-Possession (PoP) token binding in the Key Vault authentication policy.
Key Vault - Certificates 4.10.0-beta.1 Changelog
Features Added
- Added an experimental PlatformManaged property on CertificatePolicy for Azure Key Vault internal usage. Any calls using this property will fail and it is not recommended to be used at this point. #59537
Key Vault - Certificates 4.9.0 Changelog
Features Added
- Includes all changes from 4.9.0-beta.1.
Key Vault - Certificates 4.10.0-beta.2 Changelog
Features Added
- Added support for Proof-of-Possession (PoP) token binding in the Key Vault authentication policy.
Key Vault - Keys 4.11.0-beta.1 Changelog
Features Added
- Added the
ExternalKeymodel and the new methodsCreateExternalKeyandCreateExternalKeyAsyncinKeyClientfor registering a Key Vault key whose material is held in an external HSM.
Key Vault - Keys 4.11.0-beta.2 Changelog
Features Added
- Added support for Proof-of-Possession (PoP) token binding in the Key Vault authentication policy.
Key Vault - Secrets 4.12.0-beta.1 Changelog
Features Added
- Added support for Proof-of-Possession (PoP) token binding in the Key Vault authentication policy.
OpenTelemetry Exporter 1.8.1 Changelog
Features Added
- Added GenAI main agent attribution support. Automatically propagates
microsoft.gen_ai.main_agent.*attributes from parent spans to child spans and log records, enabling end-to-end tracing of AI agent orchestration. (#59368)
Resource Management - App Service 1.5.0 Changelog
Resource Management - Application Insights 1.1.0 Changelog
Resource Management - Artifactsigning 1.0.1 Changelog
Resource Management - Authorization 1.1.7 Changelog
Resource Management - Azure Stack HCI 1.3.0-beta.2 Changelog
Resource Management - Azure VMware Solution 1.6.1 Changelog
Resource Management - Batch 1.7.0 Changelog
Resource Management - Certificateregistration 1.0.0 Changelog
Resource Management - Chaos 1.2.0-beta.1 Changelog
Resource Management - Chaos 1.2.0-beta.2 Changelog
Resource Management - Cloudhealth 1.0.0-beta.3 Changelog
Resource Management - Compute Schedule 1.2.0-beta.4 Changelog
Resource Management - Compute.Recommender 1.0.0 Changelog
Resource Management - Computebulkactions 1.0.0-beta.1 Changelog
Resource Management - Computelimit 1.1.0 Changelog
Resource Management - Connectedcache 1.0.0-beta.3 Changelog
Resource Management - Container Apps 1.6.0-beta.1 Changelog
Resource Management - Container Instances 1.3.1 Changelog
Resource Management - Container Service 1.5.0 Changelog
Resource Management - Container Service Fleet 1.2.0-beta.4 Changelog
Resource Management - Content Delivery Network 1.6.0-beta.1 Changelog
Resource Management - Cosmos DB 1.4.1 Changelog
Resource Management - DNS 1.2.0-beta.4 Changelog
Resource Management - DNS Resolver 1.3.0-beta.2 Changelog
Resource Management - Data Box 1.1.2 Changelog
Resource Management - Data Box Edge 1.1.2 Changelog
Resource Management - Data Factory 1.11.1 Changelog
Resource Management - Data Migration 1.0.1 Changelog
Resource Management - Data Protection 1.8.0 Changelog
Resource Management - Datadog 1.1.0-beta.1 Changelog
Resource Management - Dell.Storage 1.0.1 Changelog
Resource Management - Device Provisioning Services 1.3.0-beta.2 Changelog
Resource Management - Dynatrace 1.2.1 Changelog
Resource Management - Edgeactions 1.0.0-beta.3 Changelog
Resource Management - Elastic 1.1.1 Changelog
Resource Management - ElasticSan 1.2.1 Changelog
Resource Management - Event Grid 1.2.0-beta.3 Changelog
Resource Management - Event Hubs 1.3.0-beta.2 Changelog
Resource Management - Fabric 1.1.0-beta.1 Changelog
Resource Management - Fileshares 1.0.0 Changelog
Resource Management - Front Door 1.4.2 Changelog
Resource Management - Horizondb 1.0.0-beta.1 Changelog
Resource Management - Managed Grafana 1.2.0-beta.4 Changelog
Resource Management - Managed Network Fabric 1.2.0 Changelog
Resource Management - Managed Service Identity 1.5.0-beta.1 Changelog
Resource Management - Monitor.Pipelinegroups 1.0.0-beta.1 Changelog
Resource Management - Monitor.Slis 1.0.0-beta.2 Changelog
Resource Management - Monitor.Slis 1.0.0-beta.1 Changelog
Resource Management - Monitor.Workspaces 1.0.0-beta.1 Changelog
Resource Management - NetApp Files 1.16.1 Changelog
Resource Management - Notification Hubs 1.2.0-beta.4 Changelog
Resource Management - Private DNS 1.2.3 Changelog
Resource Management - Redhatopenshift 1.0.0-beta.1 Changelog
Resource Management - Resiliencemanagement 1.0.0-beta.1 Changelog
Resource Management - Resource Mover 1.1.2-beta.4 Changelog
Resource Management - Self Help 1.1.0-beta.7 Changelog
Resource Management - Service Networking 1.2.0-beta.2 Changelog
Resource Management - Storage 1.7.0 Changelog
Resource Management - Traffic Manager 1.2.0-beta.2 Changelog
Storage - Blobs 12.29.0 Changelog
Bugs Fixed
- Added validation for length-prefixed fields when parsing Blob Query responses to prevent excessive memory allocation from malformed or untrusted payloads.
Features Added
- Includes all features from 12.29.0-beta.1
Storage - Blobs 12.28.0 Changelog
Bugs Fixed
- Fixed issue where the
TokenRequestContext.Scopescontained a double slash (e.g.https://storage.azure.com//.default) when usingTokenCredentialauthentication. (#58295)
Features Added
- Includes all features from 12.28.0-beta.1
Storage - Blobs Batch 12.26.0 Changelog
Features Added
- Includes all features from 12.26.0-beta.1
Storage - Blobs Batch 12.25.0 Changelog
Features Added
- Includes all features from 12.25.0-beta.1
Storage - Blobs ChangeFeed 12.0.0-preview.63 Changelog
Bugs Fixed
- Added validation for length-prefixed fields when parsing Avro responses to prevent excessive memory allocation from malformed or untrusted payloads.
Features Added
- This release contains bug fixes to improve quality.
Storage - Blobs ChangeFeed 12.0.0-preview.62 Changelog
Features Added
- This release contains bug fixes to improve quality.
Storage - Common 12.28.0 Changelog
Features Added
- This release contains bug fixes to improve quality.
Storage - Common 12.27.0 Changelog
Bugs Fixed
- Fixed issue where the
TokenRequestContext.Scopescontained a double slash (e.g.https://storage.azure.com//.default) when usingTokenCredentialauthentication. (#58295)
Storage - Files Data Lake 12.27.0 Changelog
Features Added
- Includes all features from 12.27.0-beta.1
Storage - Files Data Lake 12.26.0 Changelog
Bugs Fixed
- Fixed issue where the
TokenRequestContext.Scopescontained a double slash (e.g.https://storage.azure.com//.default) when usingTokenCredentialauthentication. (#58295)
Features Added
- Includes all features from 12.26.0-beta.1
Storage - Files Share 12.27.0 Changelog
Features Added
- Includes all features from 12.27.0-beta.1
Storage - Files Share 12.26.0 Changelog
Bugs Fixed
- Fixed issue where the
TokenRequestContext.Scopescontained a double slash (e.g.https://storage.azure.com//.default) when usingTokenCredentialauthentication. (#58295)
Features Added
- Includes all features from 12.26.0-beta.1
Storage - Queues 12.27.0 Changelog
Features Added
- Includes all features from 12.27.0-beta.1
Storage - Queues 12.26.0 Changelog
Bugs Fixed
- Fixed issue where the
TokenRequestContext.Scopescontained a double slash (e.g.https://storage.azure.com//.default) when usingTokenCredentialauthentication. (#58295)
Features Added
- Includes all features from 12.26.0-beta.1
System.ClientModel 1.14.0 Changelog
Features Added
- Added experimental
FileBinaryContenttype for representing a file part within an HTTP request payload, typically as part of amultipart/form-datarequest. - Added experimental
MultiPartFormContenttype for buildingmultipart/form-datarequest payloads. - Added a chain-aware
CredentialResolver.TryResolve(IConfigurationSection, Func<IConfigurationSection, AuthenticationTokenProvider?>, out AuthenticationTokenProvider?)virtual overload. The callback lets a chain-owning resolver resolve child sections back through the active engine — preserving caching, normalization, and ordering — without needing to know about credential sources owned by other packages. The default implementation forwards to the existing two-arg overload (experimentalSCME0002).
System.ClientModel 1.13.0 Changelog
Breaking Changes
IConfiguration.GetCredential(...)renamed toIConfiguration.GetCredentialSettings(...)and its return type changed fromAuthenticationTokenProvider?toCredentialSettings?(experimentalSCME0002).
Features Added
- Added
CredentialSettings.TokenProviderto hold the resolvedAuthenticationTokenProviderfor the credential.
System.ClientModel 1.12.0 Changelog
Features Added
- Added
CredentialSettings.this[string key]indexer for reading custom properties from the credential configuration section.
Text Translation 2.0.0 Changelog
Breaking Changes
- Removed
TranslationTarget.Gradeproperty. - Changed
TranslationTarget.Tonetype fromstringtoTranslationTone?. - Changed
TranslationTarget.Gendertype fromstringtoTranslationGender?.
Features Added
- GA release of the Azure AI Translator Text Translation SDK targeting the 2026-06-06 API version.
- Added
TextTranslationClientSettingsto support creating aTextTranslationClientfromIConfiguration, including configuration-based credential resolution and dependency injection registration. TranslationTarget.Toneproperty is now strongly typed asTranslationTone?instead ofstring.TranslationTarget.Genderproperty is now strongly typed asTranslationGender?instead ofstring.
Voice Live 1.1.0 Changelog
Breaking Changes
- Updated transcription completion APIs to include additional metadata (logprobs and phrases).
- Updated
OutputTokenDetailsconstructors to support reasoning tokens. - Updated
VoiceLiveSessionOptionsto include new properties such asIncludeandMetadata. - Renamed
MCPApprovalTypetoMcpApprovalKind. - Renamed
AvatarConfiguration.TypetoAvatarConfiguration.AvatarKind. - Renamed
CustomLexiconUrltoCustomLexiconUriandCustomTextNormalizationUrltoCustomTextNormalizationUrionAzureAvatarSyncVoice,AzurePersonalVoice,AzureCustomVoice, andAzureStandardVoice. The property type changed fromstringtoSystem.Uri. - Renamed
RequestImageContentPart.UrltoRequestImageContentPart.Uri(typed asSystem.Uri). - Renamed
PhotoAvatarBaseModestoPhotoAvatarBaseMode(singular).AvatarConfiguration.Modelwas renamed toAvatarConfiguration.BaseModeand now uses the new type. - Renamed
AvatarConfiguration.OutputAuditAudiotoAvatarConfiguration.AuditOutputAudio. - Renamed
ReasoningEffort.XhightoReasoningEffort.ExtraHigh.
Bugs Fixed
- Telemetry:
gen_ai.event.contenton.doneand related response events now correctly respects the content recording opt-in (OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENTorAZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED). Previously these events emitted message content (transcripts, function-call arguments, response bodies) unconditionally. To restore the previous behavior, set one of those environment variables totrue.
Features Added
- Added support for built-in tool calling scenarios, including file search and web search.
- Added lifecycle status tracking for tool calls, including
Searching,InProgress, andCompletedstates. - Added streaming server events for tool execution, transcript annotations, and video output updates.
- Added avatar voice synchronization support via
AzureAvatarSyncVoicewith configurable voice parameters. - Added phrase-level transcription support, including word-level timing, confidence, and phrase grouping.
- Added new personal voice models:
PersonalVoiceModels.MaiVoice1andPersonalVoiceModels.DragonHDOmniLatestNeural. - Added new turn-detection options, including semantic VAD variants (
AzureSemanticVadTurnDetection,AzureSemanticVadTurnDetectionEn, andAzureSemanticVadTurnDetectionMultilingual).
Voice Live 1.1.0-beta.4 Changelog
Breaking Changes
VoiceLiveMcpServerDefinition.RequireApprovalproperty type changed fromBinaryDatatoRequireApprovalOption.
Bugs Fixed
- Fixed
MCPApprovalTypeserialization so thatrequire_approvalcorrectly serializes to"never"on the wire. Previously, usingBinaryData.FromObjectAsJson(MCPApprovalType.Never)silently produced an empty object{}, causing the service to treat it as"always"and send unexpected approval requests.
Features Added
- Replaced
BinaryDatawith newRequireApprovalOptiontyped property onVoiceLiveMcpServerDefinition.RequireApproval. Customers can now set approval directly (server.RequireApproval = MCPApprovalType.Never) instead of usingBinaryData.FromObjectAsJson(). - Added OpenTelemetry distributed tracing support. The SDK now emits spans via
System.Diagnostics.ActivitySourcenamed"Azure.AI.VoiceLive"— no extra instrumentation package required. Spans include standard GenAI semantic convention attributes such as token usage, first-token latency, turn count, and interruption count. - Added OpenTelemetry metrics support. The SDK now emits
gen_ai.client.operation.durationandgen_ai.client.token.usagemetrics via aSystem.Diagnostics.Metrics.Meternamed"Azure.AI.VoiceLive"in compliance with GenAI semantic conventions.
Voice Live 1.2.0-beta.1 Changelog
Features Added
- Added
AzureRealtimeNativeVoiceandAzureRealtimeNativeVoiceNamewith 12 new voice options (Aarti, Andrew, Ava, Denise, Diya, Elsa, Florian, Francisca, Meera, Xiaoxiao, Ximena, Yunxi). - Added
SmartEndOfTurnDetection(end-of-utterance detection withThresholdLevelandTimeoutMs). - Added
ParallelToolCallsproperty onVoiceLiveSessionOptions. - Added
ChannelsandReferenceSource(EchoCancellationReferenceSource) properties onAudioEchoCancellation. - Added RTC call support:
ClientEventRtcCallSdpCreate,ServerEventRtcCallSdpCreated,ServerEventRtcCallError,RtcCallErrorDetails. - Added output audio buffer events:
ServerEventOutputAudioBufferStarted,ServerEventOutputAudioBufferStopped. - Added streaming text input events:
ClientEventInputTextDelta,ClientEventInputTextDone. - Added
ServerEventResponseInvocationDeltafor streaming invocation deltas.
WebJobs Extensions - Web PubSub 1.10.2 Changelog
Features Added
- Support singular
connectionproperty in Web PubSub trigger and context bindings for backward-compatibility.
unknown 2.1.0-beta.3 Changelog
Breaking Changes
CreateSkillFromPackageandCreateSkillFromPackageAsyncmethods ofProjectAgentSkillsclient were replaced byCreateSkillVersionFromFilesandCreateSkillVersionFromFilesAsyncrespectively.DownloadSkillandDownloadSkillAsyncmethods ofProjectAgentSkillsclient were replaced byGetSkillContentandGetSkillContentAsyncrespectively.UpdateSkillandUpdateSkillAsyncmethods ofProjectAgentSkillsnow can only set the default version ofAgentsSkill.OptimizationTaskResult.Tokenswas changed frominttolong.
Features Added
- Added client for Agent optimization Jobs.
unknown 2.1.0-beta.2 Changelog
Breaking Changes
AgentEndpointwas renamed toAgentEndpointConfiguration.TelemetryEndpointAuthwas renamed toTelemetryEndpointAuthentication.TelemetryEndpointpropertyAuthwas renamed toAuthentication.TelemetryEndpointpropertyDatawas renamed toExportedDataTypes.isolationKeywas removed fromCreateSessionandDeleteSessionoperations.
Features Added
- Added
FabricIQPreviewTool. - Added
ToolboxSearchPreviewToolfor discovering deferred tools viasearch_toolsqueries at runtime. - Added
WorkIQPreviewTool. - Added
NameandDescriptionproperties to tool classes (A2APreviewTool,AzureAISearchTool,BingCustomSearchPreviewTool,BingGroundingTool,BrowserAutomationPreviewTool,MemorySearchPreviewTool,MicrosoftFabricPreviewTool,SharepointPreviewTool).
unknown 2.1.0-beta.3 Changelog
Breaking Changes
- Breaking changes since version 2.0.0
MemorySearchToolCallResponseItemwas replaced byMemorySearchToolCall,MemoryCommandToolCallandMemoryCommandToolCallOutput. - Breaking changes since version 2.0.0
MemoryToolSearchItemwas removed, because it is not used anymore.
unknown 2.1.0-beta.2 Changelog
Breaking Changes
ComputerScreenshotImagepropertyImageUrlwas renamed toImageUri.ResponsesAutoCodeInterpreterToolParampropertyTypewas renamed toKind.ResponsesAzureAISearchToolpropertyAzureAiSearchwas renamed toAzureAISearch.ResponsesAzureFunctionBindingpropertyTypewas renamed toKind.ResponsesBingGroundingSearchConfigurationpropertySetLangwas renamed toLanguage.ResponsesCustomToolParampropertyDeferLoadingwas renamed toShouldDeferLoading.ResponsesFunctionToolParampropertyDeferLoadingwas renamed toShouldDeferLoading.ResponsesFunctionToolParampropertyStrictwas renamed toIsStrict.ResponsesFunctionCallOutputStatusEnumwas renamed toResponsesFunctionCallOutputStatus.ResponsesMCPToolFilterpropertyReadOnlywas renamed toIsReadOnly.ResponsesMemorySearchPreviewToolpropertyUpdateDelaywas renamed toUpdateDelayInSeconds.ResponsesOpenApiFunctionDefinitionpropertySpecwas renamed toSpecification.ResponsesOpenApiToolpropertyOpenapiwas renamed toOpenApi.ResponsesStructuredOutputDefinitionpropertyStrictwas renamed toIsStrict.ResponsesWebSearchApproximateLocationpropertyTypewas renamed toKind.
Features Added
- Added
ResponsesToolboxSearchPreviewToolfor discovering deferred tools viasearch_toolsqueries at runtime. - Added
NameandDescriptionproperties to Responses tool classes. - Added new method
GetProjectResponsesClientForAgentEndpointon theProjectOpenAIClient.
unknown 1.0.0-beta.5 Changelog
Bugs Fixed
- Enabled automatic gzip/deflate/brotli decompression on the Foundry storage HTTP pipeline.
Intermediary gateways or load-balancers that return compressed responses are now handled
transparently, preventing JSON parse failures on raw gzip bytes. The pipeline also
advertises
Accept-Encodingsupport so servers can compress responses proactively.
Features Added
- Replaced
invoke_agentSERVER span with baggage-only propagation. W3C trace context propagation is now handled automatically by ASP.NET Core, so handler spans are parented directly under the caller’s span. - Response ID, conversation ID, and streaming mode are propagated as Activity baggage for downstream correlation.
- Simplified
ResponsesActivitySourceto focus on baggage propagation rather than span creation. - All error responses (4xx/5xx) now include the
x-platform-error-sourceheader classifying error origin asuser(invalid request),platform(SDK/infrastructure failure), orupstream(developer handler failure) per container-image-spec §8. - Platform errors include the
x-platform-error-detailheader with full exception context (type, message, stack trace) for diagnostic telemetry.AggregateExceptionwrappers are unwrapped and the detail is truncated to 2048 characters. - Foundry storage pipeline exceptions are now tagged as platform errors at the source, enabling accurate classification of storage transport, authentication, and service failures regardless of exception type.
unknown 1.0.0-beta.4 Changelog
Features Added
- Replaced
invoke_agentSERVER span with baggage-only propagation. W3C trace context propagation is now handled automatically by ASP.NET Core, so handler spans are parented directly under the caller’s span. - Invocation and session IDs are propagated as Activity baggage for downstream correlation.
- Unhandled exceptions now include the
x-platform-error-sourceheader classifying error origin asuser(invalid request),platform(SDK/infrastructure failure), orupstream(developer handler failure) per container-image-spec §8. Platform errors includex-platform-error-detailwith diagnostic context. - WebSocket protocol support — new public abstract
InvocationWebSocketHandlerbase class (derived fromInvocationHandler) declares abstractHandleWebSocketAsync(WebSocket, InvocationContext, CancellationToken)and defaults the inheritedHandleAsyncto HTTP404 Not Found. A WebSocket-only agent therefore implements onlyHandleWebSocketAsync; multi-protocol agents override both methods. Handlers that derive from plainInvocationHandlercontinue to short-circuit/invocations_wsto HTTP404 Not Found. The SDK accepts the upgrade (AcceptWebSocketAsync), maps clean handler returns to RFC 6455 close code1000(NormalClosure) and uncaught handler exceptions to1011(InternalServerError), and preserves handler-initiated close codes unchanged. - WebSocket Ping/Pong keep-alive — disabled by default; enable via the
WS_KEEPALIVE_INTERVALenvironment variable (seeAzure.AI.AgentServer.Core1.0.0-beta.24), which is wired through to Kestrel’sWebSocketOptions.KeepAliveInterval. - WebSocket telemetry — structured close-event log line carrying
azure.ai.agentserver.invocations_ws.session_id,azure.ai.agentserver.invocations_ws.close_code, andazure.ai.agentserver.invocations_ws.duration_ms.
Latest Releases
View all the latest versions of .NET packages here.
Installation Instructions
To install any of our packages, please search for them via Manage NuGet Packages... in Visual Studio (with Include prerelease checked) or copy these commands into your terminal:
$> dotnet add package Azure.AI.AgentServer.Core --version 1.0.0-beta.25
$> dotnet add package Azure.AI.AgentServer.Core --version 1.0.0-beta.24
$> dotnet add package Azure.AI.AgentServer.Invocations --version 1.0.0-beta.4
$> dotnet add package Azure.AI.AgentServer.Responses --version 1.0.0-beta.5
$> dotnet add package Azure.AI.ContentUnderstanding --version 1.2.0-beta.2
$> dotnet add package Azure.AI.Extensions.OpenAI --version 2.1.0-beta.3
$> dotnet add package Azure.AI.Extensions.OpenAI --version 2.1.0-beta.2
$> dotnet add package Azure.AI.Projects --version 2.1.0-beta.3
$> dotnet add package Azure.AI.Projects --version 2.1.0-beta.2
$> dotnet add package Azure.AI.Projects.Agents --version 2.1.0-beta.3
$> dotnet add package Azure.AI.Projects.Agents --version 2.1.0-beta.2
$> dotnet add package Azure.AI.Speech.Transcription --version 1.0.0
$> dotnet add package Azure.AI.Translation.Text --version 2.0.0
$> dotnet add package Azure.AI.VoiceLive --version 1.1.0
$> dotnet add package Azure.AI.VoiceLive --version 1.1.0-beta.4
$> dotnet add package Azure.AI.VoiceLive --version 1.2.0-beta.1
$> dotnet add package Azure.Core --version 1.58.0
$> dotnet add package Azure.Core --version 1.57.0
$> dotnet add package Azure.Core --version 1.56.0
$> dotnet add package Azure.Core --version 1.59.0
$> dotnet add package Azure.Extensions.AspNetCore.DataProtection.Blobs --version 1.5.3
$> dotnet add package Azure.Extensions.AspNetCore.DataProtection.Keys --version 1.6.3
$> dotnet add package Azure.Identity.Broker --version 1.7.0
$> dotnet add package Azure.Identity.Broker --version 1.8.0-beta.1
$> dotnet add package Azure.Monitor.OpenTelemetry.Exporter --version 1.8.1
$> dotnet add package Azure.ResourceManager.AppContainers --version 1.6.0-beta.1
$> dotnet add package Azure.ResourceManager.AppService --version 1.5.0
$> dotnet add package Azure.ResourceManager.ApplicationInsights --version 1.1.0
$> dotnet add package Azure.ResourceManager.ArtifactSigning --version 1.0.1
$> dotnet add package Azure.ResourceManager.Authorization --version 1.1.7
$> dotnet add package Azure.ResourceManager.Avs --version 1.6.1
$> dotnet add package Azure.ResourceManager.Batch --version 1.7.0
$> dotnet add package Azure.ResourceManager.Cdn --version 1.6.0-beta.1
$> dotnet add package Azure.ResourceManager.CertificateRegistration --version 1.0.0
$> dotnet add package Azure.ResourceManager.Chaos --version 1.2.0-beta.1
$> dotnet add package Azure.ResourceManager.Chaos --version 1.2.0-beta.2
$> dotnet add package Azure.ResourceManager.CloudHealth --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.Compute.Recommender --version 1.0.0
$> dotnet add package Azure.ResourceManager.ComputeBulkActions --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.ComputeLimit --version 1.1.0
$> dotnet add package Azure.ResourceManager.ComputeSchedule --version 1.2.0-beta.4
$> dotnet add package Azure.ResourceManager.ConnectedCache --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.ContainerInstance --version 1.3.1
$> dotnet add package Azure.ResourceManager.ContainerService --version 1.5.0
$> dotnet add package Azure.ResourceManager.ContainerServiceFleet --version 1.2.0-beta.4
$> dotnet add package Azure.ResourceManager.CosmosDB --version 1.4.1
$> dotnet add package Azure.ResourceManager.DataBox --version 1.1.2
$> dotnet add package Azure.ResourceManager.DataBoxEdge --version 1.1.2
$> dotnet add package Azure.ResourceManager.DataFactory --version 1.11.1
$> dotnet add package Azure.ResourceManager.DataMigration --version 1.0.1
$> dotnet add package Azure.ResourceManager.DataProtectionBackup --version 1.8.0
$> dotnet add package Azure.ResourceManager.Datadog --version 1.1.0-beta.1
$> dotnet add package Azure.ResourceManager.Dell.Storage --version 1.0.1
$> dotnet add package Azure.ResourceManager.DeviceProvisioningServices --version 1.3.0-beta.2
$> dotnet add package Azure.ResourceManager.Dns --version 1.2.0-beta.4
$> dotnet add package Azure.ResourceManager.DnsResolver --version 1.3.0-beta.2
$> dotnet add package Azure.ResourceManager.Dynatrace --version 1.2.1
$> dotnet add package Azure.ResourceManager.EdgeActions --version 1.0.0-beta.3
$> dotnet add package Azure.ResourceManager.Elastic --version 1.1.1
$> dotnet add package Azure.ResourceManager.ElasticSan --version 1.2.1
$> dotnet add package Azure.ResourceManager.EventGrid --version 1.2.0-beta.3
$> dotnet add package Azure.ResourceManager.EventHubs --version 1.3.0-beta.2
$> dotnet add package Azure.ResourceManager.Fabric --version 1.1.0-beta.1
$> dotnet add package Azure.ResourceManager.FileShares --version 1.0.0
$> dotnet add package Azure.ResourceManager.FrontDoor --version 1.4.2
$> dotnet add package Azure.ResourceManager.Grafana --version 1.2.0-beta.4
$> dotnet add package Azure.ResourceManager.Hci --version 1.3.0-beta.2
$> dotnet add package Azure.ResourceManager.HorizonDB --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.ManagedNetworkFabric --version 1.2.0
$> dotnet add package Azure.ResourceManager.ManagedServiceIdentities --version 1.5.0-beta.1
$> dotnet add package Azure.ResourceManager.Monitor.PipelineGroups --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.Monitor.Slis --version 1.0.0-beta.2
$> dotnet add package Azure.ResourceManager.Monitor.Slis --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.Monitor.Workspaces --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.NetApp --version 1.16.1
$> dotnet add package Azure.ResourceManager.NotificationHubs --version 1.2.0-beta.4
$> dotnet add package Azure.ResourceManager.PrivateDns --version 1.2.3
$> dotnet add package Azure.ResourceManager.RedHatOpenShift --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.ResilienceManagement --version 1.0.0-beta.1
$> dotnet add package Azure.ResourceManager.ResourceMover --version 1.1.2-beta.4
$> dotnet add package Azure.ResourceManager.SelfHelp --version 1.1.0-beta.7
$> dotnet add package Azure.ResourceManager.ServiceNetworking --version 1.2.0-beta.2
$> dotnet add package Azure.ResourceManager.Storage --version 1.7.0
$> dotnet add package Azure.ResourceManager.TrafficManager --version 1.2.0-beta.2
$> dotnet add package Azure.Search.Documents --version 12.1.0-beta.1
$> dotnet add package Azure.Security.ConfidentialLedger --version 1.4.1-beta.5
$> dotnet add package Azure.Security.KeyVault.Administration --version 4.9.0-beta.1
$> dotnet add package Azure.Security.KeyVault.Administration --version 4.9.0-beta.2
$> dotnet add package Azure.Security.KeyVault.Certificates --version 4.10.0-beta.1
$> dotnet add package Azure.Security.KeyVault.Certificates --version 4.9.0
$> dotnet add package Azure.Security.KeyVault.Certificates --version 4.10.0-beta.2
$> dotnet add package Azure.Security.KeyVault.Keys --version 4.11.0-beta.1
$> dotnet add package Azure.Security.KeyVault.Keys --version 4.11.0-beta.2
$> dotnet add package Azure.Security.KeyVault.Secrets --version 4.12.0-beta.1
$> dotnet add package Azure.Storage.Blobs --version 12.29.0
$> dotnet add package Azure.Storage.Blobs --version 12.28.0
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.26.0
$> dotnet add package Azure.Storage.Blobs.Batch --version 12.25.0
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.63
$> dotnet add package Azure.Storage.Blobs.ChangeFeed --version 12.0.0-preview.62
$> dotnet add package Azure.Storage.Common --version 12.28.0
$> dotnet add package Azure.Storage.Common --version 12.27.0
$> dotnet add package Azure.Storage.Files.DataLake --version 12.27.0
$> dotnet add package Azure.Storage.Files.DataLake --version 12.26.0
$> dotnet add package Azure.Storage.Files.Shares --version 12.27.0
$> dotnet add package Azure.Storage.Files.Shares --version 12.26.0
$> dotnet add package Azure.Storage.Queues --version 12.27.0
$> dotnet add package Azure.Storage.Queues --version 12.26.0
$> dotnet add package Microsoft.Azure.WebJobs.Extensions.WebPubSub --version 1.10.2
$> dotnet add package System.ClientModel --version 1.14.0
$> dotnet add package System.ClientModel --version 1.13.0
$> dotnet add package System.ClientModel --version 1.12.0
Feedback
If you have a bug or feature request for one of the libraries, please file an issue in our repo.