Skip to content

Releases: microsoft/agent-framework

python-1.0.0rc3

04 Mar 22:01
fd981da

Choose a tag to compare

[1.0.0rc3] - 2026-03-04

Added

  • agent-framework-core: Add Shell tool (#4339)
  • agent-framework-core: Add file_ids and data_sources support to get_code_interpreter_tool() (#4201)
  • agent-framework-core: Map file citation annotations from TextDeltaBlock in Assistants API streaming (#4316, #4320)
  • agent-framework-claude: Add OpenTelemetry instrumentation to ClaudeAgent (#4278, #4326)
  • agent-framework-azure-cosmos: Add Azure Cosmos history provider package (#4271)
  • samples: Add auto_retry.py sample for rate limit handling (#4223)
  • tests: Add regression tests for Entry JoinExecutor workflow input initialization (#4335)

Changed

  • samples: Restructure and improve Python samples (#4092)
  • agent-framework-orchestrations: [BREAKING] Tighten HandoffBuilder to require Agent instead of SupportsAgentRun (#4301, #4302)
  • samples: Update workflow orchestration samples to use AzureOpenAIResponsesClient (#4285)

Fixed

  • agent-framework-bedrock: Fix embedding test stub missing meta attribute (#4287)
  • agent-framework-ag-ui: Fix approval payloads being re-processed on subsequent conversation turns (#4232)
  • agent-framework-core: Fix response_format resolution in streaming finalizer (#4291)
  • agent-framework-core: Strip reserved kwargs in AgentExecutor to prevent duplicate-argument TypeError (#4298)
  • agent-framework-core: Preserve workflow run kwargs when continuing with run(responses=...) (#4296)
  • agent-framework-core: Fix WorkflowAgent not persisting response messages to session history (#4319)
  • agent-framework-core: Fix single-tool input handling in OpenAIResponsesClient._prepare_tools_for_openai (#4312)
  • agent-framework-core: Fix agent option merge to support dict-defined tools (#4314)
  • agent-framework-core: Fix executor handler type resolution when using from __future__ import annotations (#4317)
  • agent-framework-core: Fix walrus operator precedence for model_id kwarg in AzureOpenAIResponsesClient (#4310)
  • agent-framework-core: Handle thread.message.completed event in Assistants API streaming (#4333)
  • agent-framework-core: Fix MCP tools duplicated on second turn when runtime tools are present (#4432)
  • agent-framework-core: Fix PowerFx eval crash on non-English system locales by setting CurrentUICulture to en-US (#4408)
  • agent-framework-orchestrations: Fix StandardMagenticManager to propagate session to manager agent (#4409)
  • agent-framework-orchestrations: Fix IndexError when reasoning models produce reasoning-only messages in Magentic-One workflow (#4413)
  • agent-framework-azure-ai: Fix parsing oauth_consent_request events in Azure AI client (#4197)
  • agent-framework-anthropic: Set role="assistant" on message_start streaming update (#4329)
  • samples: Fix samples discovered by auto validation pipeline (#4355)
  • samples: Use AgentResponse.value instead of model_validate_json in HITL sample (#4405)
  • agent-framework-devui: Fix .NET conversation memory handling in DevUI integration (#3484, #4294)

dotnet-1.0.0-rc3

04 Mar 22:00
fd981da

Choose a tag to compare

What's Changed

  • .NET: Support hosted code interpreter for skill script execution by @SergeyMenshykh in #4192
  • .NET: AgentThread serialization alternatives ADR by @westey-m in #3062
  • .NET: Add helpers to more easily access in-memory ChatHistory and make ChatHistoryProvider management more configurable. by @westey-m in #4224
  • .Net: Add additional Hosted Agent Samples by @rogerbarreto in #4325
  • .NET: Revert ".NET: Support hosted code interpreter for skill script execution" by @SergeyMenshykh in #4385
  • .NET: Fixing issue with invalid node Ids when visualizing dotnet workflows. by @alliscode in #4269
  • .NET: Fix FileAgentSkillsProvider custom SkillsInstructionPrompt silently dropping skills by @SergeyMenshykh in #4388
  • .NET: AuthN & AuthZ sample with asp.net service and web client by @westey-m in #4354
  • .NET: Update GroupChat workflow builder to support name and description by @peibekwe in #4334
  • .NET: Skip OffThread observability test by @rogerbarreto in #4399
  • .NET: AzureAI Package - Skip tool validation when UseProvidedChatClientAsIs is true by @rogerbarreto in #4389
  • [BREAKING] Add response filter for store input in *Providers by @westey-m in #4327
  • .NET: [BREAKING] Change *Provider StateKey to list of StateKeys by @westey-m in #4395
  • .NET: Updated Copilot SDK to the latest version by @dmytrostruk in #4406
  • .NET: Disable OpenAIAssistant structured output integration tests by @SergeyMenshykh in #4451
  • .NET: Update Azure.AI.Projects 2.0.0-beta.1 by @rogerbarreto in #4270
  • .NET: Skip flacky UT + (Attempt) Merge Gatekeeper fix by @rogerbarreto in #4456
  • .NET: Discover skill resources from directory instead of markdown links by @SergeyMenshykh in #4401
  • .NET: Update package versions by @dmytrostruk in #4468
  • .NET: Fixed CA1873 warning by @dmytrostruk in #4479

Full Changelog: dotnet-1.0.0-rc2...dotnet-1.0.0-rc3

python-1.0.0rc2

26 Feb 01:19
425f27f

Choose a tag to compare

[1.0.0rc2] - 2026-02-25

Added

  • agent-framework-core: Support Agent Skills (#4210)
  • agent-framework-core: Add embedding abstractions and OpenAI implementation (Phase 1) (#4153)
  • agent-framework-core: Add Foundry Memory Context Provider (#3943)
  • agent-framework-core: Add max_function_calls to FunctionInvocationConfiguration (#4175)
  • agent-framework-core: Add CreateConversationExecutor, fix input routing, remove unused handler layer (#4159)
  • agent-framework-azure-ai-search: Azure AI Search provider improvements - EmbeddingGenerator, async context manager, KB message handling (#4212)
  • agent-framework-azure-ai-search: Enhance Azure AI Search Citations with Document URLs in Foundry V2 (#4028)
  • agent-framework-ag-ui: Add Workflow Support, Harden Streaming Semantics, and add Dynamic Handoff Demo (#3911)

Changed

  • agent-framework-declarative: [BREAKING] Add InvokeFunctionTool action for declarative workflows (#3716)

Fixed

  • agent-framework-core: Fix thread corruption when max_iterations is reached (#4234)
  • agent-framework-core: Fix workflow runner concurrent processing (#4143)
  • agent-framework-core: Fix doubled tool_call arguments in MESSAGES_SNAPSHOT when streaming (#4200)
  • agent-framework-core: Fix OpenAI chat client compatibility with third-party endpoints and OTel 0.4.14 (#4161)
  • agent-framework-claude: Fix structured_output propagation in ClaudeAgent (#4137)

dotnet-1.0.0-rc2

25 Feb 23:08
425f27f

Choose a tag to compare

What's Changed

  • .NET: Add Foundry Memory Context Provider by @rogerbarreto in #3522
  • .NET: Replace inline string literals with constants in ChatHistoryMemoryProvider by @westey-m in #4096
  • .NET: Fix failing vision integration tests by using local test files by @Copilot in #4128
  • .NET: Support Agent Skills by @SergeyMenshykh in #4122
  • Added new GitHub action for manual integration test run based on PR by @dmytrostruk in #4135
  • .NET: Simplify store=false scenario for responses by @westey-m in #4124
  • .NET: Add Foundry Agents Tool Sample - Memory Search by @rogerbarreto in #3700
  • .NET: [BREAKING] Add ChatClient decorator for calling AIContextProviders by @westey-m in #4097
  • Updated GitHub action for manual integration tests by @dmytrostruk in #4147
  • .NET: Fix Structured Output for agents configured with function middleware by @SergeyMenshykh in #4179
  • Make Cosmos DB tests read COSMOSDB_ENDPOINT and COSMOSDB_KEY from environment variables by @Copilot in #4156
  • .NET: Add Foundry Agents Tool Sample - Web Search by @rogerbarreto in #4040
  • .NET: Fix case-sensitive property mismatch in CosmosChatHistoryProvider queries by @Copilot in #3485
  • Revert devcontainer bug workaround by @westey-m in #4206
  • .NET: Add Foundry Agents Tool Sample - Bing Custom Search by @rogerbarreto in #3701
  • .NET: Fix JSON arrays of objects parsed as empty records when no schema is defined by @LEDazzio01 in #4199
  • .NET: Implement Task support for A2A Hosting package by @DeagleGross in #3732
  • Add Additional Properties ADR by @westey-m in #4246
  • .NET: Add Foundry SharePoint Tool Sample by @rogerbarreto in #4227
  • .NET: Update .NET package version to rc2 by @dmytrostruk in #4257

Full Changelog: dotnet-1.0.0-rc1...dotnet-1.0.0-rc2

python-1.0.0rc1

20 Feb 02:53
0086d38

Choose a tag to compare

[1.0.0rc1] - 2026-02-19

Release candidate for agent-framework-core and agent-framework-azure-ai packages.

Added

  • agent-framework-core: Add default in-memory history provider for workflow agents (#3918)
  • agent-framework-core: Durable support for workflows (#3630)

Changed

  • agent-framework-core: [BREAKING] Scope provider state by source_id and standardize source IDs (#3995)
  • agent-framework-core: [BREAKING] Fix chat/agent message typing alignment (#3920)
  • agent-framework-core: [BREAKING] Remove FunctionTool[Any] compatibility shim for schema passthrough (#3907)
  • agent-framework-core: Inject OpenTelemetry trace context into MCP requests (#3780)
  • agent-framework-core: Replace wildcard imports with explicit imports (#3908)

Fixed

  • agent-framework-core: Fix hosted MCP tool approval flow for all session/streaming combinations (#4054)
  • agent-framework-core: Prevent repeating instructions in continued Responses API conversations (#3909)
  • agent-framework-core: Add missing system instruction attribute to invoke_agent span (#4012)
  • agent-framework-core: Fix tool normalization and provider sample consolidation (#3953)
  • agent-framework-azure-ai: Warn on unsupported AzureAIClient runtime tool/structured_output overrides (#3919)
  • agent-framework-azure-ai-search: Improve Azure AI Search package test coverage (#4019)
  • agent-framework-anthropic: Fix Anthropic option conflicts and manager parse retries (#4000)
  • agent-framework-anthropic: Track and enforce 85%+ unit test coverage for anthropic package (#3926)
  • agent-framework-azurefunctions: Achieve 85%+ unit test coverage for azurefunctions package (#3866)
  • samples: Fix workflow, declarative, Redis, Anthropic, GitHub Copilot, Azure AI, MCP, eval, and migration samples (#4055, #4051, #4049, #4046, #4033, #4030, #4027, #4032, #4025, #4021, #4022, #4001)

dotnet-1.0.0-rc1

20 Feb 03:03
0086d38

Choose a tag to compare

What's Changed

  • .NET Workflows - Rename agent-provider and add comments (Declarative Workflows) by @crickman in #3895
  • .NET: [BREAKING] Add session StateBag for state storage and support multiple providers on the Agent by @westey-m in #3806
  • .NET: [Breaking] Structured Output improvements by @SergeyMenshykh in #3761
  • .NET: Add CreateSessionAsync overload with taskId for A2AAgent session resumption by @Copilot in #3924
  • .NET: Add skill to verify samples by @westey-m in #3931
  • .NET: Fixes for bug bash. by @westey-m in #3927
  • .NET: [BREAKING] Refactor providers to move common functionality to base by @westey-m in #3900
  • .NET: Surface downstream experimental flags and remove unnecessary suppressions by @westey-m in #3968
  • .NET: [BREAKING] Replace Typed Base Providers with Composition by @westey-m in #3988
  • .NET: Fix sample resource path resolution by @westey-m in #3952
  • .NET: Fixing some small issues from bugbash by @westey-m in #3961
  • .NET: Improve session cast error message quality and consistency by @westey-m in #3973
  • .NET Workflows - Add unit tests for RequestExternalInputExecutor by @Copilot in #3891
  • .NET Workflows - Add unit tests for ConditionGroupExecutor by @Copilot in #3893
  • .NET: Open an active item in Solution Explorer in VS Code automatically by @SergeyMenshykh in #3992
  • .NET Workflows - Add unit tests for QuestionExecutor by @Copilot in #3892
  • .NET: Add additional build, test and project structure skills by @westey-m in #3987
  • .NET: Update Microsoft.Agents.ObjectModel packages to 2026.2.2.1 by @Copilot in #4003
  • .NET: Disable intermittently failing AzureAIAgentsPersistent integration tests by @SergeyMenshykh in #3997
  • .NET: Inline private RunCoreAsync into the protected one by @SergeyMenshykh in #3928
  • .NET: Add Foundry Evaluation samples (Safety + Quality) by @Copilot in #3697
  • .NET: Fix MCP samples: update MCP SDK to 0.8.0-preview.1 and fix README references by @SergeyMenshykh in #3959
  • .NET: BREAKING: Unify AgentResponse[Update] events as WorkflowOutputEvents by @lokitoth in #3441
  • .NET: Support InvokeFunctionTool for declarative workflows by @peibekwe in #4014
  • .NET: Fix FoundryAgents_Step15_ComputerUse sample for Azure Agents API by @rogerbarreto in #3989
  • .NET: Add File Search Sample for Foundry Agents. by @rogerbarreto in #3990
  • .NET: Fixes AgentWithHostedMCP chat fails: ErrorHTTP 404 (: 404) Resource not found by @rogerbarreto in #3856
  • .NET: [BREAKING] Implement Polymorphic Routing by @lokitoth in #3792
  • .NET: Fix CheckpointInfo.Parent always null in InProcessRunner by @lokitoth in #3812
  • .NET: Update AdditionalAIContext sample with simplified implementation by @westey-m in #4039
  • .NET: Add Foundry Agents Tool Sample - OpenAPI Tools by @rogerbarreto in #3702
  • [BREAKING] .NET: Decouple Checkpointing from Run/StreamAsync APIs by @lokitoth in #4037
  • .NET: Updated package versions for RC release by @dmytrostruk in #4067
  • .NET: Add tweaks to .net agent skills by @westey-m in #4081
  • .NET: Support a message only AIContextProvider as an AIAgent Decorator by @westey-m in #4009
  • .NET: Remove FunctionCalls and Tool Messages from Handoff passed messages by @lokitoth in #3811
  • .NET: Small fixes in README by @dmytrostruk in #4099
  • .NET: [BREAKING] Workflows API Review Naming Changes (Part 1?) by @lokitoth in #4090

Full Changelog: dotnet-1.0.0-preview.260212.1...dotnet-1.0.0-rc1

python-1.0.0b260212

13 Feb 00:13
65e77e5

Choose a tag to compare

[1.0.0b260212] - 2026-02-12

Important

To see details about related breaking changes, please visit the Python 2026 Significant Changes Guide.

Added

  • agent-framework-core: Allow AzureOpenAIResponsesClient creation with Foundry project endpoint (#3814)

Changed

  • agent-framework-core: [BREAKING] Wire context provider pipeline, remove old types, update all consumers (#3850)
  • agent-framework-core: [BREAKING] Checkpoint refactor: encode/decode, checkpoint format, etc (#3744)
  • agent-framework-core: [BREAKING] Replace Hosted*Tool classes with tool methods (#3634)
  • agent-framework-core: Replace Pydantic Settings with TypedDict + load_settings() (#3843)
  • agent-framework-core: Centralize tool result parsing in FunctionTool.invoke() (#3854)
  • samples: Restructure Python samples into progressive 01-05 layout (#3862)
  • samples: Adopt AzureOpenAIResponsesClient, reorganize orchestration examples, and fix workflow/orchestration bugs (#3873)

Fixed

  • agent-framework-core: Fix non-ascii chars in span attributes (#3894)
  • agent-framework-core: Fix streamed workflow agent continuation context by finalizing AgentExecutor streams (#3882)
  • agent-framework-ag-ui: Fix Workflow.as_agent() streaming regression (#3875)
  • agent-framework-declarative: Fix declarative package powerfx import crash and response_format kwarg error (#3841)

python-1.0.0b260210

11 Feb 00:35
65b6b28

Choose a tag to compare

[1.0.0b260210] - 2026-02-10

Important

To see details about related breaking changes, please visit the Python 2026 Significant Changes Guide.

Added

  • agent-framework-core: Add long-running agents and background responses support with ContinuationToken TypedDict, background option in OpenAIResponsesOptions, and continuation token propagation through response types (#3808)
  • agent-framework-core: Add streaming support for code interpreter deltas (#3775)
  • agent-framework-core: Add explicit input, output, and workflow_output parameters to @handler, @executor and request_info (#3472)
  • agent-framework-core: Add explicit schema handling to @tool decorator (#3734)
  • agent-framework-core: New session and context provider types (#3763)
  • agent-framework-purview: Add tests to Purview package (#3513)

Changed

  • agent-framework-core: [BREAKING] Renamed core types for simpler API: ChatAgentAgent, RawChatAgentRawAgent, ChatMessageMessage, ChatClientProtocolSupportsChatGetResponse (#3747)
  • agent-framework-core: [BREAKING] Moved to a single get_response and run API (#3379)
  • agent-framework-core: [BREAKING] Merge send_responses into run method (#3720)
  • agent-framework-core: [BREAKING] Renamed AgentRunContext to AgentContext (#3714)
  • agent-framework-core: [BREAKING] Renamed AgentProtocol to SupportsAgentRun (#3717)
  • agent-framework-core: [BREAKING] Renamed next middleware parameter to call_next (#3735)
  • agent-framework-core: [BREAKING] Standardize TypeVar naming convention (TNameNameT) (#3770)
  • agent-framework-core: [BREAKING] Refactor workflow events to unified discriminated union pattern (#3690)
  • agent-framework-core: [BREAKING] Refactor SharedState to State with sync methods and superstep caching (#3667)
  • agent-framework-core: [BREAKING] Move single-config fluent methods to constructor parameters (#3693)
  • agent-framework-core: [BREAKING] Types API Review improvements (#3647)
  • agent-framework-core: [BREAKING] Fix workflow as agent streaming output (#3649)
  • agent-framework-orchestrations: [BREAKING] Move orchestrations to dedicated package (#3685)
  • agent-framework-core: [BREAKING] Remove workflow register factory methods; update tests and samples (#3781)
  • agent-framework-core: Include sub-workflow structure in graph signature for checkpoint validation (#3783)
  • agent-framework-core: Adjust workflows TypeVars from prefix to suffix naming convention (#3661)
  • agent-framework-purview: Update CorrelationId (#3745)
  • agent-framework-anthropic: Added internal kwargs filtering for Anthropic client (#3544)
  • agent-framework-github-copilot: Updated instructions/system_message logic in GitHub Copilot agent (#3625)
  • agent-framework-mem0: Disable mem0 telemetry by default (#3506)

Fixed

  • agent-framework-core: Fix workflow not pausing when agent calls declaration-only tool (#3757)
  • agent-framework-core: Fix GroupChat orchestrator message cleanup issue (#3712)
  • agent-framework-core: Fix HandoffBuilder silently dropping context_provider during agent cloning (#3721)
  • agent-framework-core: Fix subworkflow duplicate request info events (#3689)
  • agent-framework-core: Fix workflow cancellation not propagating to active executors (#3663)
  • agent-framework-core: Filter response_format from MCP tool call kwargs (#3494)
  • agent-framework-core: Fix broken Content API imports in Python samples (#3639)
  • agent-framework-core: Potential fix for clear-text logging of sensitive information (#3573)
  • agent-framework-core: Skip model_deployment_name validation for application endpoints (#3621)
  • agent-framework-azure-ai: Fix AzureAIClient dropping agent instructions (Responses API) (#3636)
  • agent-framework-azure-ai: Fix AzureAIAgentClient dropping agent instructions in sequential workflows (#3563)
  • agent-framework-ag-ui: Fix AG-UI message handling and MCP tool double-call bug (#3635)
  • agent-framework-claude: Handle API errors in run_stream() method (#3653)
  • agent-framework-claude: Preserve $defs in JSON schema for nested Pydantic models (#3655)

dotnet-1.0.0-preview.260209.1

10 Feb 04:09
29af002

Choose a tag to compare

What's Changed

  • .NET: [BREAKING] Introduce Core implementation methods for session methods on AIAgent by @westey-m in #3699
  • .NET: [BREAKING] Add ability to mark the source of Agent request messages and use that for filtering by @westey-m in #3540
  • .NET: Workflow telemetry opt in by @TaoChenOSU in #3467
  • .NET Pre-Publish - Update package version to 260209 by @crickman in #3777

Full Changelog: dotnet-1.0.0-preview.260205.1...dotnet-1.0.0-preview.260209.1

dotnet-1.0.0-preview.260205.1

06 Feb 03:06
f96772f

Choose a tag to compare

What's Changed

  • .NET: Consolidate durable agent samples into Durable/Agents folder by @kshyju in #3471
  • .Net: Update Anthropic and Anthropic.Foundry package versions by @Copilot in #3517
  • .NET: Workflows - Support fidelity when converting to and from ChatMessage in declarative workflows by @peibekwe in #3505
  • Update readme by @dmytrostruk in #3576
  • .NET: [BREAKING] Rename GetNewSession to CreateSession by @westey-m in #3501
  • .NET: [BREAKING] Move AgentSession.Serialize to AIAgent by @westey-m in #3650
  • .NET: Improve unit test coverage for Microsoft.Agents.AI.Abstractions by @Copilot in #3381
  • .NET: Add .NET Anthropic Claude Skills sample by @Copilot in #3497
  • .NET: [BREAKING] Rename session state json param by @westey-m in #3681
  • .NET: Rename 3rdPartyThreadStorage sample to 3rdPartyChatHistoryStorage by @westey-m in #3643
  • [BREAKING] Obsoleting ReflectingExecutor in favor of source gen by @alliscode in #3380
  • .NET: Adding AgentRunContext to allow accessing agent run info in external downstream components by @westey-m in #3476
  • .NET: [BREAKING] Remove UserInputRequests property by @westey-m in #3682
  • .NET: Fix Error 404 Agent Hosted MCP by @rogerbarreto in #3678
  • .NET: [BREAKING] Provide agent and session to AIContextProvider & ChatHistoryProvider by @westey-m in #3695

Full Changelog: dotnet-1.0.0-preview.260128.1...dotnet-1.0.0-preview.260205.1