github Azure/azure-sdk-for-python azure-ai-projects_2.0.0b3

2.0.0b3 (2026-01-06)

Features Added

  • The package now takes dependency on openai and azure-identity packages. No need to install them separately.
  • Tracing: support for tracing the schema when an Agent is created with structured output definition.

Breaking changes

  • Rename class AgentObject to AgentDetails
  • Rename class AgentVersionObject to AgentVersionDetails
  • Rename class MemoryStoreObject to MemoryStoreDetails
  • Tracing: removed outer "content" from event content format wrapper and unified type-specific keys (e.g., "text", "image_url") to generic "content" key.
  • Tracing: replaced "gen_ai.request.assistant_name" attribute with gen_ai.agent.name.
  • Tracing: removed "gen_ai.system" - the "gen_ai.provider.name" provides same information.
  • Tracing: changed "gen_ai.user.message" and "gen_ai.tool.message" to "gen_ai.input.messages". Changed "gen_ai.assistant.message" to "gen_ai.output.messages".
  • Tracing: changed "gen_ai.system.instruction" to "gen_ai.system.instructions".
  • Tracing: added the "parts" array to "gen_ai.input.messages" and "gen_ai.output.messages".
  • Tracing: removed "role" as a separate attribute and added "role" to "gen_ai.input.messages" and "gen_ai.output.messages" content.
  • Tracing: added "finish_reason" as part of "gen_ai.output.messages" content.
  • Tracing: changed the tool calls to use the api definitions as the types in traces. For example "function_call" instead of "function" and "function_call_output" instead of "function"

Bugs Fixed

  • Tracing: fixed a bug with computer use tool call output including screenshot binary data even when binary data tracing is off.

Sample updates

  • Added OpenAPI tool sample. See sample_agent_openapi.py.
  • Added OpenAPI with Project Connection sample. See sample_agent_openapi_with_project_connection.py.
  • Added SharePoint grounding tool sample. See sample_agent_sharepoint.py.
  • Improved MCP client sample showing direct MCP tool invocation. See samples/mcp_client/sample_mcp_tool_async.py.
  • Samples that download generated files (code interpreter and image generation) now save files to the system temp directory instead of the current working directory. See sample_agent_code_interpreter.py, sample_agent_code_interpreter_async.py, sample_agent_image_generation.py, and sample_agent_image_generation_async.py.
  • The Agent to Agent sample was updated to allow "Custom keys" connection type.
  • Update Fine-Tuning supervised job samples to show waiting for model result instead of polling
  • Add evaluations sample samples/evaluations/sample_evaluations_score_model_grader_with_image.py.
  • Add basic steam event samples samples/agents/sample_agent_stream_events.py and samples/responses/sample_responses_stream_events.py

Don't miss a new azure-sdk-for-python release

NewReleases is sending notifications on new releases.