Skip to content

Releases: microsoft/agent-framework

python-1.0.0b251028

28 Oct 19:08
eed7e59

Choose a tag to compare

[1.0.0b251028] - 2025-10-28

Added

  • Added thread to AgentRunContext (#1732)
  • AutoGen migration samples (#1738)
  • Add Handoff orchestration pattern support (#1469)
  • Added Samples for HostedCodeInterpreterTool with files (#1583)

Changed

  • [BREAKING] Introduce group chat and refactor orchestrations. Fix as_agent(). Standardize orchestration start msg types. (#1538)
  • [BREAKING] Update Agent Framework Lab Lightning to use Agent-lightning v0.2.0 API (#1644)
  • [BREAKING] Refactor Checkpointing for runner and runner context (#1645)
  • Update lab packages and installation instructions (#1687)
  • Remove deprecated add_agent() calls from workflow samples (#1508)

Fixed

  • Reject executor on staticmethod/classmethod with clear error message (#1719)
  • DevUI Fix Serialization, Timestamp and Other Issues (#1584)
  • MCP Error Handling Fix + Added Unit Tests (#1621)
  • InMemoryCheckpointManager is not JSON serializable (#1639)
  • Fix gen_ai.operation.name to be invoke_agent (#1729)

dotnet-1.0.0-preview.251028.1

28 Oct 19:36
eed7e59

Choose a tag to compare

Changes:

  • a816408 .NET: Add Rag AIContext Provider (#1630)
  • b70030d .NET Workflows - Expose SendMessage override to all platforms (#1741)
  • 742203f .NET: Porting Mem0Provider to Agent Framework (#1601)
  • 8408209 Fix gen_ai.operation.name to be invoke_agent (#1729)
  • 92925a8 .NET Workflows - Add support for tool approval (#1685)
  • f8b427c Bump Anthropic.SDK from 5.7.1 to 5.8.0 (#1703)
See More
  • 76f3d4a Bump Aspire.Hosting.AppHost from 9.5.1 to 9.5.2 (#1704)
  • 81ec5da Bump Aspire.Hosting.Azure.CognitiveServices from 9.5.1 to 9.5.2 (#1705)
  • 8a3a67e Bump Aspire.Microsoft.Azure.Cosmos from 9.5.1 to 9.5.2 (#1706)
  • a0282b7 Bump danielpalme/ReportGenerator-GitHub-Action from 5.4.17 to 5.4.18 (#1713)
  • c1d8ae9 Bump actions/download-artifact from 5 to 6 (#1714)
  • b0f9cdb Bump actions/upload-artifact from 4 to 5 (#1715)
  • ff7de7a excluded devui frontend in pyproject.toml (#1697)
  • 899d8ff fix: .NET: Concurrency Support for Orchestrations (#1689) [ #1613, #1637 ]
  • 418d7f2 Bump Anthropic.SDK from 5.6.0 to 5.7.1 (#1647)
  • 73eb00b .NET: API to manage AgentThreads in hosting scenarios (#1520)
  • 3aa6820 feat: Add Cancellation API on StreamingRun (#1675)
  • b2246ef fix: InMemoryCheckpointManager is not JSON serializable (#1639)
  • c408a2d update the sample to have more relevant background responses prompts and reference official documentation. (#1654)
  • 72c391b .NET: Refactor A2A and AIAgent hosting extensions (#1625)
  • 8441b7e Bump OpenTelemetry and OpenTelemetry.Exporter.InMemory (#1651)
  • 183a1f9 Bump FluentAssertions from 8.7.1 to 8.8.0 (#1648)
  • 3a842c2 Bump OpenTelemetry and OpenTelemetry.Exporter.Console (#1650)
  • cd17cac Bump OpenTelemetry and OpenTelemetry.Exporter.OpenTelemetryProtocol (#1652)
  • 202bfdc allow a2a agent to accept non-user messages (#1661)
  • feb3404 samples: WorkflowHelper => WorkflowFactory (#1640)
  • e9687d5 Propagate cancellation token down the stack (#1641)
  • 0fc1b88 Fixes issue 1623 - .NET: [BUG] Fix Invalid Mermaid/DOT Identifiers in Fan-In Node Visualization (#1624)
  • 23bf1db Bump ModelContextProtocol to 0.4.0-preview.3 (#1585)
  • d89631e .NET: Fix solution reference to deleted ParseValue.yaml file (#1610)
  • 8e33fa1 Bump Microsoft.ML.OnnxRuntimeGenAI from 0.9.2 to 0.10.0 (#1410)
  • 103c7e7 .NET: Improve fidelity of OpenAI Responses hosting (#1550)
  • 1bf520a .NET: Add support for background responses (#1501)
  • 699149c .NET: Update Microsoft.Extensions.AI packages to version 9.10.1 (#1626)
  • 4554de0 .NET: Sample on Worflows mixing Agents And Executors, showcasing best patte… (#1562)
  • 965cce0 .NET Workflows - Remove debug file ParseValue.yaml from workflow-samples (#1608)
  • d7f422b .NET: Use extension methods from A2A package for converting between MEAI & A2A model classes (#1600)
  • 22d76e5 .NET: Fix handoff function naming (#1370)
  • 731e3a7 .NET Workflows - Fix ability of ParseValue action to process list/table types. (#1577)
  • 0ef4e73 refactor: [BREAKING] Remove generic Workflow (#1551)
  • 7c1e3db .NET: AIAgentHostExecutor to use ToAgentRunResponse (#1439)
  • c724555 .NET: Add comprehensive test classes for extension methods in Microsoft.Agents.AI.Workflows.Declarative (#1555)
  • 470cd10 Bump danielpalme/ReportGenerator-GitHub-Action from 5.4.16 to 5.4.17 (#1418)
  • cf7890f Bump OpenTelemetry.Api from 1.12.0 to 1.13.1 (#1514)
  • ec0a320 Bump AWSSDK.Extensions.Bedrock.MEAI from 4.0.4 to 4.0.4.1 (#1558)
  • 7e18863 Bump OllamaSharp from 5.4.7 to 5.4.8 (#1559)
  • 7d6b597 Bump github/codeql-action from 3 to 4 (#1417)
  • b67f017 Bump astral-sh/setup-uv from 6 to 7 (#1419)
  • 8f87328 .NET: Add comprehensive unit tests for entity extraction in Declarative Workflows (#1534)
  • e7a9128 Force source generation tests in .net core (#1298)
  • 2046f16 .NET README - Declarative Workflows (#1526)
  • df776ae .NET Workflows - Declarative updated for Question action (#1532)

This list of changes was auto generated.

python-1.0.0b251016

16 Oct 22:39
8c24a72

Choose a tag to compare

[1.0.0b251016] - 2025-10-16

Added

  • Add Purview Middleware (#1142)
  • Added URL Citation Support to Azure AI Agent (#1397)
  • Added MCP headers for AzureAI (#1506)
  • Add Function Approval UI to DevUI (#1401)
  • Added function approval example with streaming (#1365)
  • Added A2A AuthInterceptor Support (#1317)
  • Added example with MCP and authentication (#1389)
  • Added sample with Foundry Redteams (#1306)
  • Added AzureAI Agent AI Search Sample (#1281)
  • Added AzureAI Bing Connection Name Support (#1364)

Changed

  • Enhanced documentation for dependency injection and serialization features (#1324)
  • Update README to list all available examples (#1394)
  • Reorganize workflows modules (#1282)
  • Improved thread serialization and deserialization with better tests (#1316)
  • Included existing agent definition in requests to Azure AI (#1285)
  • DevUI - Internal Refactor, Conversations API support, and performance improvements (#1235)
  • Refactor RequestInfoExecutor (#1403)

Fixed

  • Fix AI Search Tool Sample and improve AI Search Exceptions (#1206)
  • Fix Failure with Function Approval Messages in Chat Clients (#1322)
  • Fix deadlock in Magentic workflow (#1325)
  • Fix tool call content not showing up in workflow events (#1290)
  • Fixed instructions duplication in model clients (#1332)
  • Agent Name Sanitization (#1523)

dotnet-1.0.0-preview.251016.1

16 Oct 19:24
85921ed

Choose a tag to compare

Changes:

  • 85921ed .NET: Sample 06_subWorkflows to showcase the sub workflows (workflow composability) (#1493)
  • 7fb8bcf Version preview.251016.1 (#1521)
  • 3e59ac0 Remove unnecessary Microsoft.Net.Compilers.Toolset package (#1448)
  • 021e3ba Bump AWSSDK.Extensions.Bedrock.MEAI from 4.0.3.6 to 4.0.4 (#1512)
  • 98726a9 Bump Moq.Analyzers from 0.3.0 to 0.3.1 (#1513)
  • 54c3eb7 .NET: Add support for getting and creating Assistant and Foundry agents with ChatClientAgentOptions (#1304)
  • 3b9193c Small fix in OpenAI Responses client (#1509)
  • f9a9fc7 Add copilot instructions for c# (#1482)
  • 9677899 .NET: Duplicate System Instruction when creating a ChatClientAgentOptions instance with the constructor (#1382)
See More
  • 331c750 .NET: [BREAKING] Enable sharing of workflow instances across concurrently executing runs (#1464)
  • 69e1ab0 fix: Update WorkflowHostAgent post Checkpointing implementation (#1498)
  • 5333cce .NET: Remove Semantic Kernel Migration instructions (moved already to SK Repository) (#1485)
  • f593bb5 Temp: re-upload missing favicons via LFS (#1479)
  • d7094d5 .NET: ChatClientBuilderExtensions should be in the M.E.AI namespace (#1484)
  • ab45007 Update to M.E.AI 9.10 (#1461)
  • 8e8dfb3 Better (#1463)
  • a6b6937 .NET Workflows - Support agent level function invocation for declarative workflow (#1442)
  • a403913 .NET: Remove reflection samples (#1460)
  • 38e10ea Bump Azure.AI.Agents.Persistent from 1.2.0-beta.5 to 1.2.0-beta.6 (#1409)
  • 0331331 .NET [WIP]: introduce Hosting extensions for Workflows (#1359)
  • f42a3ee .NET: Enable access to hosted AIAgents via OpenAI Chat Completions (#1302)
  • ea8f751 Added support boundaries for AI services, and Copilot Studio (#1391)
  • 1f0faff .NET: Add sample showing how to create ai function per a2a skill (#1452)
  • 166aa8f Update uv requirement from <0.9.0,>=0.8.2 to >=0.8.2,<0.10.0 in /python (#1430)
  • 64b5763 .NET: Mitigation for issue 1315 (#1432)
  • 7e8a3fa .NET: support .NET8 for hosting projects (#1426)
  • 5fa1536 .NET Workflows - Update State Serialization for JSON Checkpointing (#1388)
  • 29cb87b Added example with MCP and authentication (#1389)
  • d6fdb91 .NET: Inline const values in samples where used only once (#1387)
  • 3730db3 .NET: Sanitize agent name (#1368)
  • 00a124d Added git tag property (#1386)
  • 7e1fd67 .NET Workflows - Capture the identifier of the LastMessage (the workflow input) (#1372)
  • 2c9cf6f Remove unused PackageVersions from Directory.Packages.props (#1334)
  • 4cd81fe .NET: fix: Make State Persistence APIs work better with PortableValue (#1367)

dotnet-1.0.0-preview.251009.1

09 Oct 11:02
8967269

Choose a tag to compare

Changes:

  • 8967269 Fix: Add missing ChatMessage[] handler to ChatProtocolExecutor (#1337) [ #782 ]
  • d16d56b Bump AWSSDK.Extensions.Bedrock.MEAI from 4.0.3.5 to 4.0.3.6 (#1340)
  • f17bf0a Bump FluentAssertions from 8.7.0 to 8.7.1 (#1341)
  • 1b5e20b Version preview.251009.1 (#1339)
  • 15afc96 .NET: Add missing workflow properties to the workflow.definition tag (#1261)
  • 988623e .NET Workflow - Update declarative code patterns (#1313)
  • 74864f3 Update to latest OpenAI (#1286)
See More
  • 523127f Update readme.md sample to show sample parameter values and switch to openai sdk (#1265)
  • 5902bcb .NET: [BREAKING] Propagate CancellationToken into Workflow Executors and message handlers (#1280)
  • eb049c4 .NET Workflows - Enhance support and validation for image input (#1274)
  • 362652b .NET: Add Azure Monitor OpenTelemetry Exporter samples (#1231)
  • 127bf68 Reference the correct JsonUtilities class (#1270)
  • 1a81ed2 Updated (#1272)
  • df54779 .NET: Add Orchestration SK->AF migration samples (#1044)

Python packages 1.0.0b251007

07 Oct 21:53
8b73b5b

Choose a tag to compare

The first release after we went public, lots of small fixes, some bigger pieces, the highlights:

  • Support for approval_modes on AIFunctions and MCP Tools
  • Setting up your agent as a MCP server

And two breaking changes:

  • Parameter naming and other fixes (#1255)
    • This includes moving the parameters that were: model all to model_id
    • Some updates to the names of parameters on agent.run to more clearly indicate how you can pass provider specific settings.
  • Introduce add_agent functionality and added output_response to AgentExecutor; agent streaming behavior to follow workflow invocation (#1184)

Added

  • Added method to expose agent as MCP server (#1248)
  • Add PDF file support to OpenAI content parser with filename mapping (#1121)
  • Sample on integration of Azure OpenAI Responses Client with a local MCP server (#1215)
  • Added approval_mode and allowed_tools to local MCP (#1203)
  • Introducing AI Function approval (#1131)
  • Add name and description to workflows (#1183)
  • Add Ollama example using OpenAIChatClient (#1100)
  • Add DevUI improvements with color scheme, linking, agent details, and token usage data (#1091)
  • Add semantic-kernel to agent-framework migration code samples (#1045)

Changed

  • [BREAKING] Parameter naming and other fixes (#1255)
  • [BREAKING] Introduce add_agent functionality and added output_response to AgentExecutor; agent streaming behavior to follow workflow invocation (#1184)
  • OpenAI Clients accepting api_key callback (#1139)
  • Updated docstrings (#1225)
  • Standardize docstrings: Use Keyword Args for Settings classes and add environment variable examples (#1202)
  • Update References to Agent2Agent protocol to use correct terminology (#1162)
  • Update getting started samples to reflect AF and update unit test (#1093)
  • Update Lab Installation instructions to install from source (#1051)
  • Update python DEV_SETUP to add brew-based uv installation (#1173)
  • Update docstrings of all files and add example code in public interfaces (#1107)
  • Clarifications on installing packages in README (#1036)
  • DevUI Fixes (#1035)
  • Packaging fixes: removed lab from dependencies, setup build/publish tasks, set homepage url (#1056)
  • Agents + Chat Client Samples Docstring Updates (#1028)
  • Python: Foundry Agent Completeness (#954)

Fixed

  • Ollama + azureai openapi samples fix (#1244)
  • Fix multimodal input sample: Document required environment variables and configuration options (#1088)
  • Fix Azure AI Getting Started samples: Improve documentation and code readability (#1089)
  • Fix a2a import (#1058)
  • Fix DevUI serialization and agent structured outputs (#1055)
  • Default DevUI workflows to string input when start node is auto-wrapped agent (#1143)
  • Add missing pre flags on pip packages (#1130)

dotnet-1.0.0-preview.251007.1

07 Oct 19:37
93577f7

Choose a tag to compare

Important breaking change in Microsoft.Agents.AI.Workflows

  • InputPort => RequestPort. Renamed (to align with better with Python). Simple Search/Replace will fix it.
  • Run.RunStatus => Run.GetRunStatusAsync().
  • StreamingRun.HasUnprocessedRequestsneeds => StreamingRun.GetRunStatusAsync()
  • StreamingRun and Run become IAsyncDisposable and need to be .Disposed()
  • All executors must have an ID explicitly supplied - we no longer auto-generate Ids.

Changes:

  • 2b2d3a4 Version preview.251007.1 (#1271)
  • 554e161 Rename AsAIAgent to GetAIAgent and update for foundry as well (#1257)
  • b2c5d79 Bump Aspire.Hosting.Azure.CognitiveServices from 9.5.0 to 9.5.1 (#1200)
  • 1cff86b enable enum serialization as strings and relaxed json escaping (#1267)
  • 959e584 Removing duplicating update coalescing logic in AgentRunResponseExtensions (#1169)
See More
  • d10b44d .NET: Enable access to hosted AIAgents via OpenAI Responses (#947)
  • 3fd5768 .NET: Improve structured output for chat client agent (#1172)
  • 5117d7d Add AzureCLI to the dev containers (#1254)
  • 3dc14da .NET: Add a CreateAIAgent extension method to IChatClient (#1223)
  • 74905af .NET: Fix bug where ChatClientAgent throws when providing a ChatMessageStore with a service that requries service storage (#1229)
  • 7506046 .NET: Add sample to show ChatReducer usage (#1221)
  • 7ebe00e [BREAKING] .NET: Workflow Off-Thread Execution Mode (#1233)
  • 0113e04 .NET Workflows - Fix code generation cases (#1242)
  • 477c0db Bump danielpalme/ReportGenerator-GitHub-Action from 5.4.13 to 5.4.16 (#966)
  • fb95a92 Bump Aspire.Hosting.AppHost from 9.5.0 to 9.5.1 (#1199)
  • 00d5a09 Bump Aspire.Microsoft.Azure.Cosmos from 9.5.0 to 9.5.1 (#1201)
  • f81b4a5 .NET Workflows - Fix converation behaviors for declarative worfklows (#1237)
  • f1694b0 Correcting parameter assignment and using parameter naming vs relying on position (#1239)
  • 66009c6 docs: update dev.md to fix "Get the Code" section (#1217)
  • ee8d95b test: Make ChatClientAgent no-message test less flaky (#1196)
  • b2ab993 Bump AWSSDK.Extensions.Bedrock.MEAI from 4.0.3.2 to 4.0.3.5 (#1102)
  • b839669 Add Devcontainers to allow easy use of the AF repo from github codespaces (#1224)
  • 6285419 .NET: Fix A2A conversion routines to ignore unknown content types instead of throwing exceptions (#1154)
  • 4c5c6d0 Align skill naming (#1207)
  • 0cd794a added missing lib/utils.ts in devui frontend (#1197)
  • 5a7ca13 feat: Add name and description support to workflows (#1183) [ #1181 ]
  • 61ac6d4 .NET Workflows - Update ObjectModel and PowerFx packages (#1125)
  • 50c532b docs: Update References to Agent2Agent protocol to use correct terminology (#1162)
  • 32e7ff0 .NET: Add support for Subworkflows and many threading fixes (#1066)
  • 880a99c .NET Workflows - Enable "human in the loop" case for declarative integration tests (#1171)
  • 3ee7461 Fix createdAt merging for agent run updates (#1161)
  • cfcb90b fix: Make CheckpointInfo constructor public (#1156)
  • 6a4e759 Add sample showing how to use any foundry model (#1159)
  • c3b995f Change MD linkchecker to only run when md files are changed in a PR and to run nightly (#1148)
  • ca9f6fe update a2a sample to work with latest a2a library (#1149)
  • cf831b0 Update A2A library to 0.3.1-preview (#1141)
  • 4daeeb0 Add some DebuggerDisplays / DebuggerTypeProxys to abstraction types (#1144)
  • 5a208ab Bump Microsoft.Identity.Client.Extensions.Msal from 4.77.0 to 4.77.1 (#1103)
  • 3bbb01c Bump Anthropic.SDK from 5.5.2 to 5.5.3 (#1101)
  • 58e2e58 Bump Microsoft.NET.Test.Sdk from 17.14.1 to 18.0.0 (#1105)
  • 390cc54 .NET Workflows - Clean-up declarative docs and product-context. (#1134)
  • bbf7e9c Ignore CS8002 warnign when building packages (#1136)
  • caf0516 Version preview.251002.1 (#1112)
  • 2f66235 .NET: Update dotnet tests workflow to be merge queue friendly (#1133)
  • 2696de7 docs: add missing pre flag (#1130)
  • d5fe617 added language and updated docs (#1129)
  • a659e38 Checks were missing from setup - no change needed to config (#1128)
  • d6c40ed .NET: Enable integration tests on merge (#1123)
  • 074529e .NET: dotnet sample for OTEL -> Application Insights + Grafana (#1083)
  • 79def86 .NET: Add Prompt to support and improve AI Agent SK->AF Migration Results (#1081)
  • 08ea625 .NET: NET Workflows - Skip conversation initialization when identifier is provided (#1087)
  • cb62407 .NET: Improve some core types xml docs (#1115)
  • 56beb52 .NET: Fix lists in XML comments so they render properly in the documentation. (#1113)
  • b128225 .NET: Move the AsAIAgent extension methods to the correct class (#1106) [ #1109 ]
  • 1693b76 Update pip install command for agent-framework (#1098)
  • 3ae9065 Tweak AgentAbstractionsJsonUtilities to better match AIJsonUtilities (#1094)
  • 4f4890c Update getting started samples to reflect AF. Update a unit test. (#1093)
  • 6d0f28e .NET Workflows - Re-enable Declarative Integration Tests (#1080) [ #2 ]
  • 9a59b86 Update README hello world example (#1075)
  • a414461 .NET: Re-enable ImplicitUsings in samples and clean up NoWarns (#1060)
  • 0fef277 Remove System.Linq.Async dependency from src assemblies (#1069)
  • ae4cb7d README update: badges, docs, and improved hello world (#1072)
  • 79414f9 Disable (#1071)
  • 364188c .NET: Add link inspector (#1062)
  • 193503c Added nuget-props to hosting packages (#1068)
  • 0e813b9 fix links in README for Python workflows and observability sections (#1067)

This list of changes was auto generated.

python packages 1.0.0b251001

01 Oct 14:38
b8a5e7f

Choose a tag to compare

The first release of Agent Framework for python, it comprises of a number of packages:

  • agent-framework-core: all the main abstractions, types and the implementations for OpenAI and Azure OpenAI
  • agent-framework-azure-ai: the integration with Azure AI Foundry Agents, will pull in core at the same time when installed.
  • agent-framework-copilotstudio: the integration with Microsoft Copilot Studio agents, seamlessly combine different kinds of agents together, will pull in core at the same time when installed.
  • agent-framework-a2a: create A2A agents with this package, another type of agent to play around with, will pull in core at the same time when installed.
  • agent-framework-devui: a amazing browser based to chat with your agents and workflows, uses tracing to visualize when a workflow runs and supplies everything you need to develop your agents, will pull in core at the same time when installed.
  • agent-framework-mem0 and agent-framework-redis: two packages that supply different kind of integrations, for Mem0 a Context Provider to give you agent better memory, and for Redis, both a Context Provider and a Chat Memory Store for persistent storage of your chats.
  • agent-framework: the "kitchen-sink" install, this installs all of the packages above to get you started with all the goodies right away!

For more info on the first release of Agent Framework see: https://devblogs.microsoft.com/foundry/introducing-microsoft-agent-framework-the-open-source-engine-for-agentic-ai-apps/

.Net 1.0.0-preview.251001.3

01 Oct 16:19
f5ca4f4

Choose a tag to compare

Pre-release

Public Preview

Release notes will start from here

Nightly dotnet-1.0.0-nightly-251001.2

01 Oct 09:52
ef88b51

Choose a tag to compare

Pre-release

What's Changed

Read more