Azure SDK for Python (January 2025)
The Azure SDK team is pleased to announce our January 2025 client library releases.
19 packages released this month.
Stable Packages (9)
-
App Configuration Provider
-
Document Intelligence
-
Machine Learning
-
Resource Management - Cognitive Services
-
Resource Management - Compute
-
Resource Management - Data Factory
-
Resource Management - Iotoperations
-
Resource Management - Network
-
Resource Management - Playwright Testing
Patch Updates (2)
-
Machine Learning
-
Monitor Query
Beta Packages (8)
-
AI Model Inference
-
AI Projects
-
Azure AI Search
-
OpenTelemetry Exporter
-
Resource Management - Cosmos DB
-
Resource Management - Device Registry
-
Resource Management - Postgresqlflexibleservers
-
Resource Management - Service Fabric Managed Clusters
Release highlights
AI Model Inference 1.0.0b7 Changelog
Features Added
- Added a client for Image Embeddings, named
ImageEmbeddingsClient
. See package README.md and new samples. - Added support for Chat Completions response message in JSON format that adheres to a given JSON schema. Also known
as “structured output”. See new samples
sample_chat_completions_with_structured_output.py
andsample_chat_completions_with_structured_output_pydantic.py
. - Made input argument
content
a positional argument (in addition to keyword argument), in the constructors ofUserMessage
,SystemMessage
,AssistantMessage
andToolMessage
. For example, you no longer need to writeUserMessage(content="my message")
. Simply writeUserMessage("my message")
. All samples were updated accordingly.
Breaking Changes
- If you previously configured your
ChatCompletionClient.complete()
call to output JSON format without a scheme, you have this in your code:response_format=ChatCompletionsResponseFormatJSON()
. To maintain the same functionality, replace this withresponse_format="json-object"
. We however recommend that you now switch to output JSON format with a provided schema if your AI model supports it:response_format=JsonSchemaFormat(...)
.
Bugs Fixed
- Fix a bug that would cause an error when tracing was enabled and azure-core-tracing-opentelemetry was not installed and asynchronous chat completion was used.
- Enforce distinct timestamps on prompt and completion tracing events to preserve the order for chat history.
AI Projects 1.0.0b4 Changelog
Bugs Fixed
- Fix for Agent streaming issue (see GitHub issue 38918)
- Fix for Agent async function
send_email_async
is not called (see GitHub issue 38898) - Fix for Agent streaming with event handler fails with “AttributeError: ‘MyEventHandler’ object has no attribute ‘buffer’” (see GitHub issue 38897)
Features Added
- Add optional input argument
connection_name
to methods.inference.get_chat_completions_client
,.inference.get_embeddings_client
and.inference.get_azure_openai_client
.
App Configuration Provider 2.0.0 Changelog
Features Added
- Added support for load balancing between replicas.
- Added support for adding telemetry information to feature flags.
Azure AI Search 11.6.0b9 Changelog
Bugs Fixed
- Exposed
@search.document_debug_info
in the search results.
Document Intelligence 1.0.0 Changelog
Breaking Changes
- Renamed request body parameters on all methods to
body
. - Renamed operation
get_resource_info()
toget_resource_details()
. - Renamed model
ContentFormat
toDocumentContentFormat
. - Renamed model
AnalyzeBatchResultOperation
toAnalyzeBatchOperation
. - Renamed model
CopyAuthorization
toModelCopyAuthorization
. - Renamed model
Document
toAnalyzedDocument
. - Renamed model
Error
toDocumentIntelligenceError
. - Renamed model
ErrorResponse
toDocumentIntelligenceErrorResponse
. - Renamed model
InnerError
toDocumentIntelligenceInnerError
. - Renamed model
OperationDetails
toDocumentIntelligenceOperationDetails
. - Renamed model
OperationStatus
toDocumentIntelligenceOperationStatus
. - Renamed model
ResourceDetails
toDocumentIntelligenceResourceDetails
. - Renamed model
Warning
toDocumentIntelligenceWarning
. - Renamed property
items_property
in modelDocumentFieldSchema
toitems_schema
. - Renamed enum
FontStyle
toDocumentFontStyle
. - Renamed enum
FontWeight
toDocumentFontWeight
. - Removed model
AnalyzeResultOperation
. - Removed
GENERATIVE
in enumDocumentBuildMode
.
Features Added
- Added support for the Analyze Batch Documents API:
- Added operations
delete_analyze_batch_result()
,get_analyze_batch_result()
andlist_analyze_batch_results()
toDocumentIntelligenceClient
. - Added support for the Analyze Documents API:
- Added operations
delete_analyze_result()
toDocumentIntelligenceClient
.
Machine Learning 1.23.0 Changelog
Features Added
- Added support for IP-based access control to default and hub workspaces.
- Add support for additional include in spark component.
- Adding enterprise agent feature for AI Hub and AI Project. Adding Create, Delete and Get operations.
- Removing preview tag for following connections type
- Azure AI Search
- Azure AI Content Safety
- Azure AI Speech
- Azure Blob Storage
- Microsoft OneLake
Machine Learning 1.23.1 Changelog
Bugs Fixed
- Removed marshmallow _T reference.
Monitor Query 1.4.1 Changelog
Other Changes
- Internal updates for linting and typing improvements.
OpenTelemetry Exporter 1.0.0b33 Changelog
Features Added
- Implement live metrics filtering for metrics (#37998)
- Add applying filter/validating filter logic to live metrics filtering (#38451)
- Implement live metrics filtering for docs (#38925)
- Implement live metrics + filtering for span event exceptions (#39168)
Bugs Fixed
- Detect live metrics usage during runtime in addition to on startup (#37694)
- Remove status code
206
from retry code + only count batch level for statsbeat (#38647)
Resource Management - Cognitive Services 13.6.0 Changelog
Resource Management - Compute 33.1.0 Changelog
Resource Management - Cosmos DB 10.0.0b5 Changelog
Resource Management - Data Factory 9.1.0 Changelog
Resource Management - Device Registry 1.0.0b2 Changelog
Resource Management - Iotoperations 1.0.0 Changelog
Resource Management - Network 28.1.0 Changelog
Resource Management - Playwright Testing 1.0.0 Changelog
Resource Management - Postgresqlflexibleservers 1.1.0b2 Changelog
Resource Management - Service Fabric Managed Clusters 2.1.0b2 Changelog
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-documentintelligence==1.0.0
$> pip install azure-ai-inference==1.0.0b7
$> pip install azure-ai-ml==1.23.0
$> pip install azure-ai-ml==1.23.1
$> pip install azure-ai-projects==1.0.0b4
$> pip install azure-appconfiguration-provider==2.0.0
$> pip install azure-mgmt-cognitiveservices==13.6.0
$> pip install azure-mgmt-compute==33.1.0
$> pip install azure-mgmt-cosmosdb==10.0.0b5
$> pip install azure-mgmt-datafactory==9.1.0
$> pip install azure-mgmt-deviceregistry==1.0.0b2
$> pip install azure-mgmt-iotoperations==1.0.0
$> pip install azure-mgmt-network==28.1.0
$> pip install azure-mgmt-playwrighttesting==1.0.0
$> pip install azure-mgmt-postgresqlflexibleservers==1.1.0b2
$> pip install azure-mgmt-servicefabricmanagedclusters==2.1.0b2
$> pip install azure-monitor-opentelemetry-exporter==1.0.0b33
$> pip install azure-monitor-query==1.4.1
$> pip install azure-search-documents==11.6.0b9
Feedback
If you have a bug or feature request for one of the libraries, please post an issue to GitHub.