Azure SDK for Python (September 2025)
The Azure SDK team is pleased to announce our September 2025 client library releases.
46 packages released this month.
Stable Packages (12)
-
AI Evaluation
-
Azure Monitor OpenTelemetry
-
Communication Call Automation
-
Communication Phone Numbers
-
Identity
-
Machine Learning
-
Resource Management - App Service
-
Resource Management - Compute
-
Resource Management - Container Service
-
Resource Management - IoT Firmware Defense
-
Resource Management - NetApp Files
-
Resource Management - Playwright
Patch Updates (3)
-
Azure Monitor OpenTelemetry
-
Core - Client - Core
-
Resource Management - Playwright Testing
Beta Packages (23)
-
AI Agents
-
AI Projects
-
Azure AI Search
-
Communication Call Automation
-
Conversational Language Understanding
-
Cosmos DB
-
Health Deidentification
-
OpenTelemetry Exporter
-
Resource Management - Azurestackhcivm
-
Resource Management - Compute Fleet
-
Resource Management - Computerecommender
-
Resource Management - Container Apps
-
Resource Management - Container Registry
-
Resource Management - Container Service Fleet
-
Resource Management - IoT Hub
-
Resource Management - Managed Service Identity
-
Resource Management - SQL
-
Resource Management - Security
-
Resource Management - Storagediscovery
-
Resource Management - Workloadorchestration
-
Synapse - Artifacts
-
Text Analytics
-
unknown
Release highlights
AI Agents 1.2.0b2 Changelog
Features Added
- Add support for Browser Automation tool.
- Add support for environment variable
OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT
as defined by OpenTelemetry, to control tracing of user and Agent messages.
Bugs Fixed
- Added
RunStepConnectedAgentToolCall
andRunStepDeltaConnectedAgentToolCall
for deserializing Connected Agent tool updates in non-streaming and streaming scenarios.
AI Agents 1.2.0b3 Changelog
Bugs Fixed
- Fixed the issue when the
create_and_process
call hangs if MCP tool approval is required.
Features Added
- Added delete operation for
ThreadMessages
. - Add
RunStepDetailsActivity
, describing MCP function parameters. - Add
RunStepDeltaCustomBingGroundingToolCall
, describingBingCustomSearchTool
updates in streaming scenario. - Add
RunStepDeltaMicrosoftFabricToolCall
, describingFabricTool
updates in streaming scenario. - Add
RunStepDeltaSharepointToolCall
, describingSharepointTool
updates in streaming scenario. - Improve code interpreter tool to take the list of
VectorStoreDataSource
as an input for enterprise file search.
AI Agents 1.2.0b4 Changelog
Features Added
- Added Computer Use Preview tool for use with the computer-use-preview model
- ToolSet now supports adding multiple McpTool instances and OpenApiTool instances.
- Added static functions
get_tool_resources
andget_tool_definitions
inazure.ai.agents.models
to simplify extracting tool resources and definitions from collections of tools, making it easier to configure agents with multiple tool instances.
Bugs Fixed
- Fix issue with tracing an Agent message, when the message has “in progress” status (related to GitHub Issue 42645).
- Fix issue with tracing
RunStepOpenAPIToolCall
(GitHub issues 42645 and 42864). - Fix issue when
.threads.create(messages=[ThreadMessageOptions(...])
is called on theAgentsClient
, when tracing is enabled (GitHub issue 42805) - Fix an issue in the code where, when tracing is enabled and the function AgentsClient.runs.create_and_process is used, the span “start_thread_run” appears twice in trace, once as a parent and once as a child span. The parent span name has been changed to “process_thread_run”. Note that the semantic conventions used in the traces (including spans and attributes) are still subject to change.
AI Evaluation 1.11.0 Changelog
Bugs Fixed
- Fixed issue where evaluation results were not properly aligned with input data, leading to incorrect metrics being reported.
Features Added
- Added support for user-supplied tags in the
evaluate
function. Tags are key-value pairs that can be used for experiment tracking, A/B testing, filtering, and organizing evaluation runs. The function accepts atags
parameter. - Added support for user-supplied TokenCredentials with LLM based evaluators.
- Enhanced
GroundednessEvaluator
to support AI agent evaluation with tool calls. The evaluator now accepts agent response data containing tool calls and can extract context fromfile_search
tool results for groundedness assessment. This enables evaluation of AI agents that use tools to retrieve information and generate responses. Note: Agent groundedness evaluation is currently supported only when thefile_search
tool is used. - Added
language
parameter toRedTeam
class for multilingual red team scanning support. The parameter accepts values fromSupportedLanguages
enum including English, Spanish, French, German, Italian, Portuguese, Japanese, Korean, and Simplified Chinese, enabling red team attacks to be generated and conducted in multiple languages. - Added support for IndirectAttack and UngroundedAttributes risk categories in
RedTeam
scanning. These new risk categories expand red team capabilities to detect cross-platform indirect attacks and evaluate ungrounded inferences about human attributes including emotional state and protected class information.
AI Projects 1.1.0b3 Changelog
Features added
- File
setup.py
was updated to indicate the dependencyazure-ai-agents>=1.2.0b3
instead ofazure-ai-agents>=1.0.0
. This means that in a clean environment, installing viapip install --pre azure-ai-projects
will install latest beta version ofazure-ai-agents
(which has features in preview) instead of latest stable version (which does not include preview features).
AI Projects 1.1.0b4 Changelog
Bugs Fixed
- Fix getting secret keys for connections of type “Custom Keys” (GitHub issue 52355)
Azure AI Search 11.7.0b1 Changelog
Features Added
- Added
azure.search.documents.models.DebugInfo
. - Added
azure.search.documents.indexes.models.AzureBlobKnowledgeSource
. - Added
azure.search.documents.indexes.models.AzureBlobKnowledgeSourceParameters
. - Added
azure.search.documents.indexes.models.IndexerResyncBody
. - Added
azure.search.documents.indexes.models.KnowledgeAgentOutputConfiguration
. - Added
azure.search.documents.indexes.models.KnowledgeAgentOutputConfigurationModality
. - Added
azure.search.documents.indexes.models.KnowledgeSource
. - Added
azure.search.documents.indexes.models.KnowledgeSourceKind
. - Added
azure.search.documents.indexes.models.KnowledgeSourceReference
. - Added
azure.search.documents.indexes.models.SearchIndexKnowledgeSource
. - Added
azure.search.documents.indexes.models.SearchIndexKnowledgeSourceParameters
. - Removed
azure.search.documents.indexes.models.KnowledgeAgentTargetIndex
. - Added
azure.search.documents.indexes.models.SearchIndex.description
. - Added
azure.search.documents.agent.models.KnowledgeAgentAzureBlobActivityArguments
. - Added
azure.search.documents.agent.models.KnowledgeAgentAzureBlobActivityRecord
. - Added
azure.search.documents.agent.models.KnowledgeAgentAzureBlobReference
. - Added
azure.search.documents.agent.models.KnowledgeAgentModelAnswerSynthesisActivityRecord
. - Added
azure.search.documents.agent.models.KnowledgeAgentRetrievalActivityRecord
. - Added
azure.search.documents.agent.models.KnowledgeAgentSearchIndexActivityArguments
. - Added
azure.search.documents.agent.models.KnowledgeAgentSearchIndexActivityRecord
. - Added
azure.search.documents.agent.models.KnowledgeAgentSearchIndexReference
. - Added
azure.search.documents.agent.models.KnowledgeAgentSemanticRerankerActivityRecord
. - Added
azure.search.documents.agent.models.KnowledgeSourceParams
. - Added
azure.search.documents.agent.models.SearchIndexKnowledgeSourceParams
. - Removed
azure.search.documents.agent.models.KnowledgeAgentAzureSearchDocReference
. - Removed
azure.search.documents.agent.models.KnowledgeAgentIndexParams
. - Removed
azure.search.documents.agent.models.KnowledgeAgentSearchActivityRecord
. - Removed
azure.search.documents.agent.models.KnowledgeAgentSearchActivityRecordQuery
. - Removed
azure.search.documents.agent.models.KnowledgeAgentSemanticRankerActivityRecord
. - Added KnowledgeSource operations in
SearchIndexClient
.
Azure Monitor OpenTelemetry 1.7.0 Changelog
Features Added
- Updated README to specify the python version supported by the distro. (#42464)
Bugs Fixed
- Fixed issue #42337, removes warning messages for instrumentations that target multiple packages. The logic for dependency conflict detection has been enhanced by adding “instruments-any” feature. This feature is used when an instrumentation requires any of a set of dependencies rather than all. Follows upstream dependency conflict detection logic - https://github.com/open-telemetry/opentelemetry-python-contrib/blob/main/opentelemetry-instrumentation/src/opentelemetry/instrumentation/dependencies.py (#42342)
- Add error handling for diagnostic logging setup (#42505)
Azure Monitor OpenTelemetry 1.8.0 Changelog
Features Added
- Added configuration changes for RateLimited Sampler (#41976)
Azure Monitor OpenTelemetry 1.8.1 Changelog
Bugs Fixed
- Fixed version pinned for opentelemetry-sdk to resolve dependency conflicts. (#43012)
- Modified ordering of dependencies in setup.py to avoid dependency conflicts in future. (#43023)
Communication Call Automation 1.5.0 Changelog
Features Added
- Added support for Teams multipersona users in create call, add participant, transfer, and redirect scenarios in OPS calls
- Added TeamsAppSource for use when creating outbound OPS calls
- Recording with the call connection ID is now supported. OPS calls can be recorded using the call connection ID.
- Adds support for SIP headers prefixed with ‘X-‘ and ‘X-MS-Custom-‘ within the CustomCallingContext.
Bugs fixed
- Fixed range specification for download_recording.
- Fixed serialization of participant ordering for start_recording.
Breaking Changes
- The properties
media_streaming_subscription
andtranscription_subscription
ofCallConnectionProperties
are no longer subclasses of the internalModel
baseclass, and no longer have the inherited methods. - The following attributes have now been typed as
Optional
to reflect the actual behaviour:CallParticipant.is_muted
,CallParticipant.is_on_hold
,AddParticipantResult.invitation_id
,CancelAddParticipantOperationResult.invitation_id
. - The models
FileSource
andChannelAffinity
will no longer accept arbitrary keyword args in the constructor.
Communication Call Automation 1.6.0b1 Changelog
Features Added
- Added support for moving a participant from one call to another, enabling seamless participant transfer between active calls.
- Added support for retrieving Teams phone call details, including the ability to specify a custom calling context for enhanced integration scenarios.
- Added support for Personally Identifiable Information (PII) redaction and summarization in transcription, improving privacy and providing concise summaries of transcribed content.
- Added support for sentiment analysis in both speech and choice recognition, allowing detection of participant sentiment during call interactions.
Communication Phone Numbers 1.4.0 Changelog
Features Added
- GA release of support for mobile number types
Conversational Language Understanding 2.0.0b1 Changelog
Features Added
-
Added support for service version 2024-05-01, 2024-11-01, 2024-11-15-preview,2025-05-15-preview.
-
Added custom poller AnalyzeConversationLROPoller and AnalyzeConversationAsyncLROPoller, and make begin_analyze_conversation_job return AnalyzeConversationLROPoller[ItemPaged[ConversationActions]] or AnalyzeConversationAsyncLROPoller[ItemPaged[ConversationActions]].
-
Added three different type of Redaction Policy
CharacterMaskPolicyType
,EntityMaskTypePolicyType
andNoMaskPolicyType
. -
Added AI Conversation Analyze (Multi-turn conversation prediction) feature.
-
Added tests and samples for new features.
Breaking Changes
- Removed support for Conversations Authoring.
Core - Client - Core 1.35.1 Changelog
Bugs Fixed
- Fixed an issue where the
retry_backoff_max
parameter inRetryPolicy
andAsyncRetryPolicy
constructors was being ignored, causing retry operations to use default maximum backoff values instead of the user-specified limits. #42444
Cosmos DB 4.14.0b2 Changelog
Bugs Fixed
- Fixed session container session token logic. The SDK will now only send the relevant partition-local session tokens for read document requests and write requests when multi-region writes are enabled, as opposed to the entire compound session token for the container for every document request. See PR 41678.
- Write requests for single-write region accounts will no longer send session tokens when using session consistency. See PR 41678.
- Fixed bug where container cache was not being properly updated resulting in unnecessary extra requests. See PR 42143.
- Fixed bug where the Filters on Parent loggers or handlers of Cosmos Diagnostics loggers were not being applied. See PR 41012
Features Added
- Added feed range support in
query_items
. See PR 41722.
Cosmos DB 4.14.0b3 Changelog
Bugs Fixed
- Improved the resilience of Database Account Read metadata operation against short-lived network issues by increasing number of retries. See PR 42525.
- Fixed bug where during health checks read regions were marked as unavailable for write operations. See PR 42525.
- Fixed bug where containers named with spaces or special characters using session consistency would fall back to eventual consistency. See PR 42608
- Fixed bug where
excluded_locations
was not being honored for some metadata calls. See PR 42266. - Fixed bug where Hybrid Search queries using parameters were not working. See PR 42787
- Fixed partition scoping for per partition circuit breaker. See PR 42751
- Fixed bug where
partition_key
set to None was not properly handled for some operations. See PR 42747
Features Added
- Added read_items API to provide an efficient method for retrieving multiple items in a single request. See PR 42167.
- Added ability to replace a container’s indexing policy if a vector embedding policy was present. See PR 42810.
Cosmos DB 4.14.0b4 Changelog
Bugs Fixed
- Fixed bug where client provided session token was not respected when client-side session management was disabled. See PR 42965
Health Deidentification 1.1.0b1 Changelog
Features Added
- Added
SURROGATE_ONLY
operation type inDeidentificationOperationType
, which returns output text where user-defined PHI entities are replaced with realistic replacement values. - Added
input_locale
parameter toDeidentificationCustomizationOptions
to allow for specifying the locale of the input text forTAG
andREDACT
operations.
Identity 1.25.0 Changelog
Bugs Fixed
- Fixed an issue where
AzureDeveloperCliCredential
would time out during token requests whenazd
prompts for user interaction. This issue commonly occurred in environments where theAZD_DEBUG
environment variable was set, causing the Azure Developer CLI to display additional prompts that interfered with automated token acquisition. (#42535) - Fixed an issue where credentials configured with a default tenant ID of “organizations” (such as
InteractiveBrowserCredential
andDeviceCodeCredential
) would fail authentication when a specific tenant ID was provided inget_token
orget_token_info
method calls. (#42721)
Features Added
AzureDeveloperCliCredential
now supportsclaims
inget_token
andget_token_info
. (#42568)- Added new keyword argument
require_envvar
toDefaultAzureCredential
to enforce the presence of theAZURE_TOKEN_CREDENTIALS
environment variable. (#42660)
Machine Learning 1.29.0 Changelog
Bugs Fixed
- Fix for registry resource group passed to OnlineEndpointOperations when model is in registry in different resource group compared to workspace.
- Set defaults for min_instances, max_instances, idle_time_before_scale_down in AmlCompute
Features Added
- Removed the dependencies - msrest and six
OpenTelemetry Exporter 1.0.0b42 Changelog
Features Added
- Customer Facing Statsbeat: Added remaining drop codes to base (#42382)
- Refactored the put methods in storage.py for LocalFileBlob and LocalFileStorage (#42502)
- Customer Facing Statsbeat: Refactored logic for tracking dropped items from storage (#42542)
- Customer Facing SDKStats: Added the export interval env var for customer sdkstats (#42551)
- Rename Customer Statsbeat to Customer SDKStats as per [Spec] - https://github.com/aep-health-and-standards/Telemetry-Collection-Spec/pull/581 (#42573)
- Customer Facing SDKStats: Exception categorization as per [Spec] - https://github.com/aep-health-and-standards/Telemetry-Collection-Spec/blob/main/ApplicationInsights/sdkstats/customer_facing_sdk_stats.md (#42695)
- Customer Facing SDKStats: Added logic for race conditions and updated the implementation to use a global instance for customer SDKStats metrics (#42655)
- Customer Facing SDKStats: Added telemetry_success field to dropped items as per [Spec] - https://github.com/aep-health-and-standards/Telemetry-Collection-Spec/pull/606 (#42846)
- Customer Facing SDKStats: Refactor to use
Manager
andSingleton
pattern (#42969)
Resource Management - App Service 10.0.0 Changelog
Resource Management - Azurestackhcivm 1.0.0b1 Changelog
Resource Management - Compute 36.0.0 Changelog
Resource Management - Compute Fleet 2.0.0b1 Changelog
Resource Management - Computerecommender 1.0.0b1 Changelog
Resource Management - Container Apps 4.0.0b1 Changelog
Resource Management - Container Registry 14.1.0b2 Changelog
Resource Management - Container Service 39.1.0 Changelog
Resource Management - Container Service Fleet 4.0.0b1 Changelog
Resource Management - IoT Firmware Defense 2.0.0 Changelog
Resource Management - IoT Hub 5.0.0b1 Changelog
Resource Management - Managed Service Identity 8.0.0b1 Changelog
Resource Management - NetApp Files 13.7.0 Changelog
Resource Management - Playwright 1.0.0 Changelog
Resource Management - Playwright Testing 1.0.1 Changelog
Resource Management - SQL 4.0.0b23 Changelog
Resource Management - Security 8.0.0b1 Changelog
Resource Management - Storagediscovery 1.0.0b2 Changelog
Resource Management - Workloadorchestration 1.0.0b1 Changelog
Synapse - Artifacts 0.21.0 Changelog
Breaking Changes
- Model LinkedService parameter OracleLinkedService parameter connection_string now is not required
- Model GreenplumLinkedService remove parameter password
- Model ExpressionV2 parameter value change its type from string to object
Features Added
- Add a new Model ServiceNowV2LinkedService
- Model ServiceNowV2ObjectDataset has a new parameter table_name
- Model ServiceNowV2ObjectDataset has a new parameter value_type
- linked service add support Presto server linked service
- Model DynamicsSink has a new parameter bypass_business_logic_execution
- Model DynamicsSink has a new parameter bypass_power_automate_flows
- Model AzurePostgreSqlSink has a new parameter write_method
- Model AzurePostgreSqlSink has a new parameter upsert_settings
- Model SnowflakeV2LinkedService has a new parameter role
- Model SnowflakeV2LinkedService has a new parameter schema
- Model AzurePostgreSqlLinkedService has a new parameter service_principal_embedded_cert
- Model AzurePostgreSqlLinkedService has a new parameter service_principal_embedded_cert_password
- Model ODataLinkedService has a new parameter service_principal_embedded_cert
- Model ODataLinkedService has a new parameter service_principal_embedded_cert_password
- Model Office365LinkedService has a new parameter service_principal_embedded_cert
- Model Office365LinkedService has a new parameter service_principal_embedded_cert_password
- Model RestServiceLinkedService has a new parameter service_principal_embedded_cert
- Model RestServiceLinkedService has a new parameter service_principal_embedded_cert_password
- Model SharePointOnlineListLinkedService has a new parameter service_principal_embedded_cert
- Model SharePointOnlineListLinkedService has a new parameter service_principal_embedded_cert_password
- Model AzureDatabricksLinkedService has a new parameter data_security_mode
- Model AmazonRdsForOracleLinkedService has a new parameter server
- Model AmazonRdsForOracleLinkedService has a new parameter authentication_type
- Model AmazonRdsForOracleLinkedService has a new parameter username
- Model AmazonRdsForOracleLinkedService has a new parameter encryption_client
- Model AmazonRdsForOracleLinkedService has a new parameter encryption_types_client
- Model AmazonRdsForOracleLinkedService has a new parameter crypto_checksum_client
- Model AmazonRdsForOracleLinkedService has a new parameter crypto_checksum_types_client
- Model AmazonRdsForOracleLinkedService has a new parameter initial_lob_fetch_size
- Model AmazonRdsForOracleLinkedService has a new parameter fetch_size
- Model AmazonRdsForOracleLinkedService has a new parameter statement_cache_size
- Model AmazonRdsForOracleLinkedService has a new parameter initialization_string
- Model AmazonRdsForOracleLinkedService has a new parameter enable_bulk_load
- Model AmazonRdsForOracleLinkedService has a new parameter fetch_tswtz_as_timestamp
- Model AmazonRdsForOracleLinkedService has a new parameter support_v1_data_types
- Model FtpServerLinkedService has a new parameter enable_server_certificate_validation
- Model HiveLinkedService has a new parameter enable_server_certificate_validation
- Model HttpLinkedService has a new parameter enable_server_certificate_validation
- Model ImpalaLinkedService has a new parameter enable_server_certificate_validation
- Model RestServiceLinkedService has a new parameter enable_server_certificate_validation
- Model SparkLinkedService has a new parameter enable_server_certificate_validation
- Model QuickBooksLinkedService has a new parameter refresh_token
- Model AmazonRdsForOracleSource has a new parameter number_precision
- Model AmazonRdsForOracleSource has a new parameter number_scale
- Model OracleSource has a new parameter number_precision
- Model OracleSource has a new parameter number_scale
- Model LakeHouseLinkedService has a new parameter authentication_type
- Model LakeHouseLinkedService has a new parameter credential
- Model WarehouseLinkedService has a new parameter authentication_type
- Model WarehouseLinkedService has a new parameter credential
- Model HDInsightLinkedService has a new parameter cluster_auth_type
- Model HDInsightLinkedService has a new parameter credential
Text Analytics 6.0.0b1 Changelog
unknown 1.0.0b1 Changelog
Features Added
- Added WebSocket connection support through
connect()
. - Added
VoiceLiveConnection
for managing WebSocket connections. - Added models of Voice Live preview.
- Added WebSocket-based examples in the samples directory.
unknown 1.0.0b1 Changelog
Features Added
- Initial release
unknown 1.0.0b2 Changelog
Features Added
- Async function call
Bugs Fixed
- Fixed function calling: ensure
FunctionCallOutputItem.output
is properly serialized as a JSON string before sending to the service.
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.2.0b2
$> pip install azure-ai-agents==1.2.0b3
$> pip install azure-ai-agents==1.2.0b4
$> pip install azure-ai-evaluation==1.11.0
$> pip install azure-ai-language-conversations==2.0.0b1
$> pip install azure-ai-language-conversations-authoring==1.0.0b1
$> pip install azure-ai-ml==1.29.0
$> pip install azure-ai-projects==1.1.0b3
$> pip install azure-ai-projects==1.1.0b4
$> pip install azure-ai-textanalytics==6.0.0b1
$> pip install azure-ai-voicelive==1.0.0b1
$> pip install azure-ai-voicelive==1.0.0b2
$> pip install azure-communication-callautomation==1.5.0
$> pip install azure-communication-callautomation==1.6.0b1
$> pip install azure-communication-phonenumbers==1.4.0
$> pip install azure-core==1.35.1
$> pip install azure-cosmos==4.14.0b2
$> pip install azure-cosmos==4.14.0b3
$> pip install azure-cosmos==4.14.0b4
$> pip install azure-health-deidentification==1.1.0b1
$> pip install azure-identity==1.25.0
$> pip install azure-mgmt-appcontainers==4.0.0b1
$> pip install azure-mgmt-azurestackhcivm==1.0.0b1
$> pip install azure-mgmt-compute==36.0.0
$> pip install azure-mgmt-computefleet==2.0.0b1
$> pip install azure-mgmt-computerecommender==1.0.0b1
$> pip install azure-mgmt-containerregistry==14.1.0b2
$> pip install azure-mgmt-containerservice==39.1.0
$> pip install azure-mgmt-containerservicefleet==4.0.0b1
$> pip install azure-mgmt-iotfirmwaredefense==2.0.0
$> pip install azure-mgmt-iothub==5.0.0b1
$> pip install azure-mgmt-msi==8.0.0b1
$> pip install azure-mgmt-netapp==13.7.0
$> pip install azure-mgmt-playwright==1.0.0
$> pip install azure-mgmt-playwrighttesting==1.0.1
$> pip install azure-mgmt-security==8.0.0b1
$> pip install azure-mgmt-sql==4.0.0b23
$> pip install azure-mgmt-storagediscovery==1.0.0b2
$> pip install azure-mgmt-web==10.0.0
$> pip install azure-mgmt-workloadorchestration==1.0.0b1
$> pip install azure-monitor-opentelemetry==1.7.0
$> pip install azure-monitor-opentelemetry==1.8.0
$> pip install azure-monitor-opentelemetry==1.8.1
$> pip install azure-monitor-opentelemetry-exporter==1.0.0b42
$> pip install azure-search-documents==11.7.0b1
$> pip install azure-synapse-artifacts==0.21.0
Feedback
If you have a bug or feature request for one of the libraries, please post an issue to GitHub.