Azure SDK for Python (June 2025)
The Azure SDK team is pleased to announce our June 2025 client library releases.
54 packages released this month.
Stable Packages (13)
-
AI Agents
-
AI Evaluation
-
Communication Call Automation
-
Event Grid
-
Health Deidentification
-
Health Insights Radiology Insights
-
Identity
-
Resource Management - Chaos
-
Resource Management - Container Service
-
Resource Management - Network
-
Resource Management - Recovery Services
-
Resource Management - Resources
-
Resource Management - Storage
Patch Updates (5)
-
AI Agents
-
Azure Monitor OpenTelemetry
-
Machine Learning
-
Resource Management - App Platform
-
Resource Management - Media Services
Beta Packages (29)
-
AI Agents
-
AI Projects
-
Azure AI Search
-
Communication Phone Numbers
-
Cosmos DB
-
OpenTelemetry Exporter
-
Resource Management - Cognitive Services
-
Resource Management - Confidential Ledger
-
Resource Management - Container Registry
-
Resource Management - Kubernetesconfiguration-Extensions
-
Resource Management - Kubernetesconfiguration-Extensiontypes
-
Resource Management - Kubernetesconfiguration-Fluxconfigurations
-
Resource Management - Mongodbatlas
-
Resource Management - NetApp Files
-
Resource Management - Onlineexperimentation
-
Resource Management - Planetarycomputer
-
Resource Management - PostgreSQL Flexible Servers
-
Resource Management - Purestorageblock
-
Resource Management - Resource-Deploymentscripts
-
Resource Management - Resource-Deploymentstacks
-
Resource Management - Resource-Templatespecs
-
Resource Management - Secretsstoreextension
-
Resource Management - Service Networking
-
Resource Management - Sitemanager
-
Storage - Blobs
-
Storage - Files Data Lake
-
Storage - Files Share
-
Storage - Queues
-
unknown
Release highlights
AI Agents 1.0.0b2 Changelog
Breaking Changes
- Rename
get_last_text_message_by_role
toget_last_message_text_by_role
.
AI Agents 1.0.0b3 Changelog
Features Added
- Internal updates based on TypeSpec finalization.
AI Agents 1.0.0 Changelog
Features Added
- First stable release of Azure AI Agents client library.
AI Agents 1.1.0b1 Changelog
Features Added
- API version is changed to 2025-05-15-preview.
- Add FabricTool, SharepointTool, and BingCustomSearchTool classes along with samples.
Bugs Fixed
- Adding instrumentation for create_thread_and_run
AI Agents 1.1.0b2 Changelog
Bugs Fixed
asyncio.gather
is used to make function tool calls in parallel forasync
scenario.- Adding instrumentation for create_thread_and_run.
- Fixed a tracing related bug that caused process_thread_run span to not appear when streaming is used without event handler.
AI Agents 1.0.1 Changelog
Bugs Fixed
asyncio.gather
is used to make function tool calls in parallel forasync
scenario.- Adding instrumentation for create_thread_and_run.
- Fixed a tracing related bug that caused process_thread_run span to not appear when streaming is used without event handler.
AI Evaluation 1.7.0 Changelog
Bugs Fixed
- azure-ai-evaluation failed with module not found #40992
AI Evaluation 1.8.0 Changelog
Bugs Fixed
- AdversarialSimulator in
ADVERSARIAL_CONVERSATION
mode was broken. It is now fixed.
Features Added
- Introduces
AttackStrategy.MultiTurn
andAttackStrategy.Crescendo
toRedTeam
. These strategies attack the target of aRedTeam
scan over the course of multi-turn conversations.
AI Projects 1.0.0b11 Changelog
Features added
.deployments
methods to enumerate AI models deployed to your AI Foundry Project..datasets
methods to upload documents and reference them. To be used with Evaluations..indexes
methods to handle your Search Indexes.
Breaking changes
- Azure AI Foundry Project endpoint is now required to construct the
AIProjectClient
. It has the formhttps://<your-ai-services-account-name>.services.ai.azure.com/api/projects/<your-project-name>
. Find it in your AI Foundry Project Overview page. The factory methodfrom_connection_string
was removed. - Agents are now implemented in a separate package
azure-ai-agents
. Continue using the “.agents” operations on theAIProjectsClient
to create, run and delete agents, as before. However there have been some breaking changes in these operations. See Agents package document and samples for more details. - Several changes to the
.connections
methods, including the response object (now simply calledConnection
) - The method
.inference.get_azure_openai_client()
now supports returning an authenticatedAzureOpenAI
client to be used with AI models deployed to the Project’s AI Services. This is in addition to the existing option to get anAzureOpenAI
client for one of the connected Azure OpenAI services. - Import
PromptTemplate
fromazure.ai.projects
instead ofazure.ai.projects.prompts
. - The class ConnectionProperties was renamed to Connection, and its properties have changed.
- The method
.to_evaluator_model_config
onConnectionProperties
is no longer required and does not have an equivalent method onConnection
. When constructing the EvaluatorConfiguration class, theinit_params
element now requiresdeployment_name
instead ofmodel_config
. - The method
upload_file
onAIProjectClient
had been removed, usedatasets.upload_file
instead. - Evaluator Ids are available using the Enum
EvaluatorIds
and no longer requireazure-ai-evaluation
package to be installed. - Property
scope
onAIProjectClient
is removed, use AI Foundry Project endpoint instead. - Property
id
on Evaluation is replaced withname
.
Azure AI Search 11.6.0b12 Changelog
Bugs Fixed
- Fixed the issue batching in upload_documents() did not work. #40157
Features Added
- Added
azure.search.documents.agent.KnowledgeAgentRetrievalClient
. - Added knowledge agents operations in
SearchIndexClient
. - Added
resync
method inSearchIndexerClient
. - Exposed
@search.reranker_boosted_score
in the search results. - Added
x_ms_query_source_authorization
as a keyword argument toSearchClient.search
. - Added property
azure.search.documents.indexes.models.SearchField.permission_filter
. - Added property
azure.search.documents.indexes.models.SearchIndex.permission_filter_option
. -
Added property
azure.search.documents.indexes.models.SearchIndexerDataSourceConnection.indexer_permission_options
. - Added new models:
azure.search.documents.models.QueryResultDocumentInnerHit
azure.search.documents.indexes.models.ChatCompletionExtraParametersBehavior
azure.search.documents.indexes.models.ChatCompletionResponseFormat
azure.search.documents.indexes.models.ChatCompletionResponseFormatType
azure.search.documents.indexes.models.ChatCompletionResponseFormatJsonSchemaProperties
azure.search.documents.indexes.models.ChatCompletionSchema
azure.search.documents.indexes.models.ChatCompletionSkill
azure.search.documents.indexes.models.CommonModelParameters
azure.search.documents.indexes.models.DocumentIntelligenceLayoutSkillChunkingProperties
azure.search.documents.indexes.models.DocumentIntelligenceLayoutSkillChunkingUnit
azure.search.documents.indexes.models.DocumentIntelligenceLayoutSkillExtractionOptions
azure.search.documents.indexes.models.DocumentIntelligenceLayoutSkillOutputFormat
azure.search.documents.indexes.models.IndexerPermissionOption
azure.search.documents.indexes.models.IndexerResyncOption
azure.search.documents.indexes.models.KnowledgeAgent
azure.search.documents.indexes.models.KnowledgeAgentAzureOpenAIModel
azure.search.documents.indexes.models.KnowledgeAgentModel
azure.search.documents.indexes.models.KnowledgeAgentModelKind
azure.search.documents.indexes.models.KnowledgeAgentRequestLimits
azure.search.documents.indexes.models.KnowledgeAgentTargetIndex
azure.search.documents.indexes.models.PermissionFilter
azure.search.documents.indexes.models.RankingOrder
azure.search.documents.indexes.models.SearchIndexPermissionFilterOption
Azure Monitor OpenTelemetry 1.6.9 Changelog
Features Added
- Enable Azure AI Agents instrumentation for azure-ai-agents (#40866)
Azure Monitor OpenTelemetry 1.6.10 Changelog
Features Added
- Enabled diagnostics for AKS Attach (#40988)
Communication Call Automation 1.4.0 Changelog
Features Added
- Real-time transcription support
- Audio and DTMF streaming capabilities
- Integration of ConnectAPI for seamless streaming and transcription
- Improved media streaming with bidirectional functionality, allowing audio formats in both directions, currently supporting sample rates of 24kHz and 16kHz
- Support for custom speech models has been integrated into transcription
- A confidence level for recognized speech has been introduced, ranging from 0.0 to 1.0 when available
Communication Phone Numbers 1.3.0b1 Changelog
Features Added
- Adds support for the Browse Available Phone Numbers and Reservations APIs.
- This adds an alternate way to search and purchase phone numbers that allows customers to select which phone numbers they want to reserve and purchase.
- Adds support for automated purchases of phone numbers from countries requiring a Do Not Resell agreement.
- For more information, refer to: https://learn.microsoft.com/azure/communication-services/concepts/numbers/sub-eligibility-number-capability
- API version
2025-04-01
is the default.
Cosmos DB 4.12.0b1 Changelog
Features Added
- Added ability to use weighted RRF (Reciprocal Rank Fusion) for Hybrid full text search queries. See PR 40899.
Bugs Fixed
- Fixed Diagnostics Error Log Formatting to handle error messages from non-CosmosHttpResponseExceptions. See PR 40889
- Fixed bug where
multiple_write_locations
option in client was not being honored. See PR 40999.
Cosmos DB 4.13.0b1 Changelog
Features Added
- Added ability to set a user agent suffix at the client level. See PR 40904
- Added ability to use request level
excluded_locations
on metadata calls, such as getting container properties. See PR 40905 - Per partition circuit breaker support. It can be enabled through the environment variable
AZURE_COSMOS_ENABLE_CIRCUIT_BREAKER
. See PR 40302.
Bugs Fixed
- Fixed how resource tokens are parsed for metadata calls in the lifecycle of a document operation. See PR 40302.
- Fixed issue where Query Change Feed did not return items if the container uses legacy Hash V1 Partition Keys. This also fixes issues with not being able to change feed query for Specific Partition Key Values for HPK. See PR 41270
Event Grid 4.22.0 Changelog
Features Added
- Added new enum values to
SystemEventNames
related to Azure Communication Services and Azure Edge.
Health Deidentification 1.0.0 Changelog
Breaking Changes
- Changed method names in
DeidentificationClient
to match functionality: - Changed the
deidentify
method name todeidentify_text
. - Changed the
begin_create_job
method name tobegin_deidentify_documents
. - Renamed the property
DeidentificationContent.operation
tooperation_type
. - Deprecated
DocumentDataType
. - Changed the model
DeidentificationDocumentDetails
: - Renamed
input
toinput_location
. - Renamed
output
tooutput_location
. - Changed the model
DeidentificationJob
- Renamed
name
tojob_name
. - Renamed
operation
tooperation_type
. - Renamed the model
OperationState
toOperationStatus
. - Changed
path
field tolocation
inSourceStorageLocation
andTargetStorageLocation
. - Changed
outputPrefix
behavior to no longer includejob_name
by default. - Deprecated
path
andlocation
fromTaggerResult
model.
Features Added
- Introduced
DeidentificationCustomizationOptions
andDeidentificationJobCustomizationOptions
models. - Added
surrogate_locale
field in these models. - Moved
redaction_format
field into these models. - Introduced
overwrite
property inTargetStorageLocation
model, which allows a job to overwrite existing documents in the storage location.
Health Insights Radiology Insights 1.1.0 Changelog
Features Added
- 3 new inferences added:
- ScoringAndAssessmentInference
- AssessmentValueRange
- ScoringAndAssessmentCategoryType
- GuidanceInference
- GuidanceOptions
- PresentGuidanceInformation
- GuidanceRankingType
- QualityMeasureInference
- QualityMeasureOptions
- QualityMeasureType
- QualityMeasureComplianceType
- Added samples for scoring and assessment, Quality Measure and Guidance
Identity 1.23.0 Changelog
Features Added
- Added
AZURE_TOKEN_CREDENTIALS
environment variable toDefaultAzureCredential
to allow for choosing groups of credentials. prod
forEnvironmentCredential
,WorkloadIdentityCredential
, andManagedIdentityCredential
.dev
forSharedTokenCacheCredential
,AzureCliCredential
,AzurePowershellCredential
, andAzureDeveloperCliCredential
.
Machine Learning 1.27.1 Changelog
Bugs Fixed
- Handled key error for missing props in PAT url case.
OpenTelemetry Exporter 1.0.0b37 Changelog
Features Added
- Implement spec for k8s attribute logic. (#41130)
Bugs Fixed
- Do not count Functions as App Service (#41327)
Resource Management - App Platform 10.0.1 Changelog
Resource Management - Chaos 2.0.0 Changelog
Resource Management - Cognitive Services 13.7.0b1 Changelog
Resource Management - Confidential Ledger 2.0.0b5 Changelog
Resource Management - Container Registry 14.1.0b1 Changelog
Resource Management - Container Service 36.0.0 Changelog
Resource Management - Container Service 37.0.0 Changelog
Resource Management - Kubernetesconfiguration-Extensions 1.0.0b1 Changelog
Resource Management - Kubernetesconfiguration-Extensiontypes 1.0.0b1 Changelog
Resource Management - Kubernetesconfiguration-Fluxconfigurations 1.0.0b1 Changelog
Resource Management - Media Services 10.2.1 Changelog
Resource Management - Mongodbatlas 1.0.0b1 Changelog
Resource Management - NetApp Files 14.0.0b1 Changelog
Resource Management - Network 29.0.0 Changelog
Resource Management - Onlineexperimentation 1.0.0b1 Changelog
Resource Management - Planetarycomputer 1.0.0b1 Changelog
Resource Management - PostgreSQL Flexible Servers 1.2.0b1 Changelog
Resource Management - Purestorageblock 1.0.0b1 Changelog
Resource Management - Recovery Services 3.1.0 Changelog
Resource Management - Resource-Deploymentscripts 1.0.0b1 Changelog
Resource Management - Resource-Deploymentstacks 1.0.0b1 Changelog
Resource Management - Resource-Templatespecs 1.0.0b1 Changelog
Resource Management - Resources 23.4.0 Changelog
Resource Management - Secretsstoreextension 1.0.0b1 Changelog
Resource Management - Service Networking 2.1.0b1 Changelog
Resource Management - Sitemanager 1.0.0b1 Changelog
Resource Management - Storage 23.0.0 Changelog
Storage - Blobs 12.27.0b1 Changelog
Features Added
- Added support for service version 2025-11-05.
- Added support for better error handling for copy operations.
Storage - Files Data Lake 12.22.0b1 Changelog
Features Added
- Added support for service version 2025-11-05.
Storage - Files Share 12.23.0b1 Changelog
Features Added
- Added support for service version 2025-11-05.
- Added support for better error handling for copy operations.
Storage - Queues 12.14.0b1 Changelog
Features Added
- Added support for service version 2025-11-05.
unknown 1.0.0b1 Changelog
Features Added
- Initial version of
OnlineExperimentationClient
library.
Latest Releases
View all the latest versions of Python packages here.
Installation Instructions
To install the latest beta version of the packages, copy and paste the following commands into a terminal:
$> pip install azure-ai-agents==1.0.0b2
$> pip install azure-ai-agents==1.0.0b3
$> pip install azure-ai-agents==1.0.0
$> pip install azure-ai-agents==1.1.0b1
$> pip install azure-ai-agents==1.1.0b2
$> pip install azure-ai-agents==1.0.1
$> pip install azure-ai-evaluation==1.7.0
$> pip install azure-ai-evaluation==1.8.0
$> pip install azure-ai-ml==1.27.1
$> pip install azure-ai-projects==1.0.0b11
$> pip install azure-communication-callautomation==1.4.0
$> pip install azure-communication-phonenumbers==1.3.0b1
$> pip install azure-cosmos==4.12.0b1
$> pip install azure-cosmos==4.13.0b1
$> pip install azure-eventgrid==4.22.0
$> pip install azure-health-deidentification==1.0.0
$> pip install azure-healthinsights-radiologyinsights==1.1.0
$> pip install azure-identity==1.23.0
$> pip install azure-mgmt-appplatform==10.0.1
$> pip install azure-mgmt-chaos==2.0.0
$> pip install azure-mgmt-cognitiveservices==13.7.0b1
$> pip install azure-mgmt-confidentialledger==2.0.0b5
$> pip install azure-mgmt-containerregistry==14.1.0b1
$> pip install azure-mgmt-containerservice==36.0.0
$> pip install azure-mgmt-containerservice==37.0.0
$> pip install azure-mgmt-kubernetesconfiguration-extensions==1.0.0b1
$> pip install azure-mgmt-kubernetesconfiguration-extensiontypes==1.0.0b1
$> pip install azure-mgmt-kubernetesconfiguration-fluxconfigurations==1.0.0b1
$> pip install azure-mgmt-media==10.2.1
$> pip install azure-mgmt-mongodbatlas==1.0.0b1
$> pip install azure-mgmt-netapp==14.0.0b1
$> pip install azure-mgmt-network==29.0.0
$> pip install azure-mgmt-onlineexperimentation==1.0.0b1
$> pip install azure-mgmt-planetarycomputer==1.0.0b1
$> pip install azure-mgmt-postgresqlflexibleservers==1.2.0b1
$> pip install azure-mgmt-purestorageblock==1.0.0b1
$> pip install azure-mgmt-recoveryservices==3.1.0
$> pip install azure-mgmt-resource==23.4.0
$> pip install azure-mgmt-resource-deploymentscripts==1.0.0b1
$> pip install azure-mgmt-resource-deploymentstacks==1.0.0b1
$> pip install azure-mgmt-resource-templatespecs==1.0.0b1
$> pip install azure-mgmt-secretsstoreextension==1.0.0b1
$> pip install azure-mgmt-servicenetworking==2.1.0b1
$> pip install azure-mgmt-sitemanager==1.0.0b1
$> pip install azure-mgmt-storage==23.0.0
$> pip install azure-monitor-opentelemetry==1.6.9
$> pip install azure-monitor-opentelemetry==1.6.10
$> pip install azure-monitor-opentelemetry-exporter==1.0.0b37
$> pip install azure-onlineexperimentation==1.0.0b1
$> pip install azure-search-documents==11.6.0b12
$> pip install azure-storage-blob==12.27.0b1
$> pip install azure-storage-file-datalake==12.22.0b1
$> pip install azure-storage-file-share==12.23.0b1
$> pip install azure-storage-queue==12.14.0b1
Feedback
If you have a bug or feature request for one of the libraries, please post an issue to GitHub.