NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1777 most downloaded on PyPI
Microsoft Corporation Azure AI Agents Client Library for Python
Last release 11 months ago
24 Oct 2025
Ships on a steady schedule
a new release about every 3 weeks
Nearly every release is documented
notes for 4 of 4 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
17 releases · first in 2025
One column per month.
Fix missing await in calls to asynchronous Agent methods, when AIAgentsInstrumentor().instrument() is called but no tracer is configured
await in calls to asynchronous Agent methods, when AIAgentsInstrumentor().instrument()
is called but no tracer is configuredAdded run_handler parameter to runs.create_and_process allowing to make function tool calls manually or approve mcp tool calls.
run_handler parameter to runs.create_and_process allowing to make function tool calls manually or approve mcp tool calls.RunStepDeltaComputerUseDetails and RunStepDeltaComputerUseToolCall classes for streaming computer use scenarios.RunStepDeltaChunk to StreamEventData model (GitHub issues 43022)sample_agents_mcp_in_create_and_process.py abd sample_agents_mcp_in_create_and_process_async.py demonstrating MCP tool call approvals in runs.create_and_process.sample_agents_functions_in_create_and_process.py and sample_agents_functions_in_create_and_process_async.py demonstrating manual function tool calls in runs.create_and_process.Added Computer Use Preview tool for use with the computer-use-preview model
get_tool_resources and get_tool_definitions in azure.ai.agents.models to simplify extracting tool resources and definitions from collections of tools, making it easier to configure agents with multiple tool instances.RunStepOpenAPIToolCall (GitHub issues 42645 and 42864)..threads.create(messages=[ThreadMessageOptions(...]) is called on the AgentsClient, when tracing is enabled (GitHub issue 42805)sample_agents_mcp_stream_eventhandler.py demonstrating how to use MCP tools with streaming and event handlers for real-time processing.sample_agents_mcp_stream_iteration.py showing MCP tool usage with streaming iteration for step-by-step response handling.sample_agents_multiple_mcp.py illustrating how to configure and use multiple MCP tool.Added delete operation for ThreadMessages.
ThreadMessages.RunStepDetailsActivity, describing MCP function parameters.RunStepDeltaCustomBingGroundingToolCall, describing BingCustomSearchTool updates in streaming scenario.RunStepDeltaMicrosoftFabricToolCall, describing FabricTool updates in streaming scenario.RunStepDeltaSharepointToolCall, describing SharepointTool updates in streaming scenario.VectorStoreDataSource as an input for enterprise file search.create_and_process call hangs if MCP tool approval is required.Add support for Browser Automation tool.
OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT as defined by
OpenTelemetry, to control tracing of user and Agent messages.RunStepConnectedAgentToolCall and RunStepDeltaConnectedAgentToolCall for deserializing Connected
Agent tool updates in non-streaming and streaming scenarios.sample_agents_browser_automation.py
and sample_agents_browser_automation_async.py.Beta Features Restored: This release reintroduces all experimental features that were available in the 1.1.0b series but removed in the 1.1.0 stable r
Beta Features Restored: This release reintroduces all experimental features that were available in the 1.1.0b series but removed in the 1.1.0 stable release.
tool_resources for run async operations.runs.create_and_process API call did not correctly handle the AzureAISearchTool, FileSearchTool, and CodeInterpreterTool when specified in the toolset parameter.RunStepDeltaAzureAISearchToolCall, RunStepDeltaOpenAPIToolCall and RunStepDeltaDeepResearchToolCall, required to get the real time updates when Azure AI Search, OpenAPI or Deep Research tools are being used during streaming scenarios.sample_agents_deep_research.py and sample_agents_deep_research_async.py for citations.Code | Docs
Communication Phone Numbers
azure-communication-phonenumbers
Beta Features Removed: All experimental features from 1.1.0b1-1.1.0b4 have been removed to provide a stable release.
Beta Features Removed: All experimental features from 1.1.0b1-1.1.0b4 have been removed to provide a stable release.
tool_resources parameter added to runs.create and run.stream method. This parameter represents overridden enabled tool resources that the agent should use to run the thread. Default value is None.AgentsResponseFormatOption, MessageInputContent, MessageAttachmentToolDefinition, AgentsToolChoiceOption are now public.update_agents to execute with body as a keyword parameter.1.0.2 and does not include the experimental features that were introduced in the beta versions 1.1.0b1 through 1.1.0b5. This means that any beta-specific functionality you may have been using is not available in this stable release.1.2.0b1 which continues the beta feature development line.AgentsResponseFormatOption, MessageInputContent, MessageAttachmentToolDefinition, AgentsToolChoiceOption are now public.update_agents to execute with body as a keyword parameter.tool_resources parameter added to runs.create and run.stream method. This parameter represents overridden enabled tool resources that the agent should use to run the thread. Default value is None.sample_agents_auto_function_call.pysample_agents_auto_function_call_async.py._AgentsClientOperationsMixin is now private.Beta Features Continued: This release continues the experimental features from previous beta versions and adds new MCP tool support.
Beta Features Continued: This release continues the experimental features from previous beta versions and adds new MCP tool support.
_AgentsClientOperationsMixin is now private.sample_agents_mcp.py.sample_agents_auto_function_call.pysample_agents_auto_function_call_async.py.Added support for Deep Research tool. For more information, see https://aka.ms/agents-deep-research.
API version is changed to 2025-05-15-preview.
AIProjectClient which is recommended to specify endpoint and credential.sample_agents_stream_iteration_with_functions.pyBeta Features Introduced: This release introduces experimental features that may change in future versions.
Beta Features Introduced: This release introduces experimental features that may change in future versions.
Beta Features Not Included: This stable release does not include the experimental features from 1.1.0b1-1.1.0b3 (FabricTool, SharepointTool, BingCusto
Beta Features Not Included: This stable release does not include the experimental features from 1.1.0b1-1.1.0b3 (FabricTool, SharepointTool, BingCustomSearchTool, and DeepResearchTool) and corresponded samples.
Beta Features Not Included: This stable release does not include the experimental features introduced in 1.1.0b1.
Beta Features Not Included: This stable release does not include the experimental features introduced in 1.1.0b1.
asyncio.gather is used to make function tool calls in parallel for async scenario.First stable release of Azure AI Agents client library.
Internal updates based on TypeSpec finalization.
Rename get_last_text_message_by_role to get_last_message_text_by_role.
get_last_text_message_by_role to get_last_message_text_by_role.enable_auto_function_calls supports positional arguments instead of keyword arguments.
azure-ai-projects with azure-ai-agents package.Your coding agent can read these notes before it upgrades. Set up the MCP server →