python-1.0.0b251016

[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

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

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

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

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

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

Public Preview

Release notes will start from here

Nightly dotnet-1.0.0-nightly-251001.2

What's Changed

• Add initial skeleton of package, including tooling setup and CI by @jackgerrits in #4
• Remove path filter so that required checks can be used by @jackgerrits in #7
• Add skeleton dotnet project structure by @westey-m in #49
• Design doc draft by @ekzhu in #5
• Thread interfacce by @ekzhu in #50
• .Net: Fixed solution build in Visual Studio by @dmytrostruk in #55
• Add build and test for dotnet projects by @westey-m in #51
• .Net: Added shared classes by @dmytrostruk in #58
• Memory, RAG, and other Context Providers by @rickyloynd-microsoft in #54
• .Net: Added Agent abstractions from SK repository by @dmytrostruk in #56
• Adding nuget.config + Small Async fix by @rogerbarreto in #62
• Add IMessagesRetrievableThread interface by @westey-m in #63
• Remove create/delete from AgentThread to avoid needing a thread implementation for each service. by @westey-m in #64
• .Net: ChatClientAgent (Non-Streaming initial impl) by @rogerbarreto in #65
• .Net ChatClientAgent Streaming API Impl. by @rogerbarreto in #69
• .Net: Add ChatClientAgent Samples - OpenAI Model Client by @rogerbarreto in #72
• Update ChatClientAgentThread to support both in-memory and service storage. by @westey-m in #70
• Add sample for OpenAIAssistant ChatClientAgent by @westey-m in #74
• Add test infrastructure for agent conformance tests by @westey-m in #77
• .Net: Adding ChatOptions configuration to the Agent level by @rogerbarreto in #75
• Add additional integration tests and add OpenAIAssistant integration tests project. by @westey-m in #79
• .Net: Add Azure OpenAI Agent Model Samples by @rogerbarreto in #80
• Add tests for ChatClientAgent with OpenAI responses by @westey-m in #82
• .Net: Added Azure AI Persistent Agents by @dmytrostruk in #81
• .Net: Add OpenAI Responses Agent Samples by @rogerbarreto in #83
• Remove AdditionalInstructions from AgentRunOptions since it is not well supported outside of ChatClientAgents by @westey-m in #87
• Add function call integration tests by @westey-m in #90
• Add decisions folder and ADR templates by @markwallace-microsoft in #101
• Suggested tweaks to Agent by @stephentoub in #88
• .Net: Add Reasoning Model Integration tests by @rogerbarreto in #100
• .Net: Agent Samples - Adding AzureAIAgentsPersistent to Steps by @rogerbarreto in #105
• Renaming to use Microsoft.Extensions prefix by @markwallace-microsoft in #120
• .Net: Code interpreter tool abstraction and implementation examples by @dmytrostruk in #110
• Python package design by @eavanvalkenburg in #108
• Python: package setup with logger by @eavanvalkenburg in #125
• feat: Model Client and associated Content Types by @lokitoth in #53
• Python: added poe setup and docs by @eavanvalkenburg in #131
• .Net: Fix warnings by @rogerbarreto in #133
• Python: added embeddingsclient and redid chatclient by @eavanvalkenburg in #132
• .Python: Added Agent and AgentThread abstractions by @dmytrostruk in #130
• .NET Port Agent Orchestration by @crickman in #107
• Python: small streamline of agents and agent threads by @eavanvalkenburg in #145
• Logging for integration test runs by @markwallace-microsoft in #152
• Port Agent Runtime abstractions / inprocess runtime by @stephentoub in #149
• Enable running dotnet-build-and-test for push operations by @markwallace-microsoft in #153
• Python: added ChatClientBase with function calling by @eavanvalkenburg in #147
• Run integration tests when PR is being merged by @markwallace-microsoft in #155
• Python: removed version and reinstated init by @eavanvalkenburg in #160
• First round of cleanup of runtime abstractions by @stephentoub in #156
• Remove instructions from base agent type, and ensure description is only required where necessary. by @westey-m in #154
• Update some dependency versions by @stephentoub in #162
• .Net: Update Code Interpreter Sample as a Step. by @rogerbarreto in #148
• Python: OpenAI Connector by @peterychang in #144
• ADR for Agent Tools by @dmytrostruk in #103
• Run integration tests by @markwallace-microsoft in #161
• Add PoC CopilotStudio agent by @westey-m in #84
• Add CodeQL and Dependabot by @markwallace-microsoft in #159
• Set CopilotStudio integration tests to manual run only. by @westey-m in #166
• Run Response ADR & Updates by @westey-m in #104
• .Net: Introduce Dependency Injection Samples by @rogerbarreto in #165
• Round 2 of cleanup for agent runtime and orchestrations by @stephentoub in #164
• Python: Added AgentRunResponse and AgentRunResponseUpdate types by @dmytrostruk in #157
• Python: Added ChatClientAgentThread and ChatClientAgent implementations by @dmytrostruk in #150
• Fix handoff function names by @stephentoub in #178
• Allow InProcessRuntime subscriptions to be processed concurrently by @stephentoub in #179
• Python: follow on work on OpenAI by @eavanvalkenburg in #169
• Basic agent invocation sample by @westey-m in #175
• Update {Azure.AI.}OpenAI package versions by @stephentoub in #187
• Python: simple Agent sample by @eavanvalkenburg in #180
• Bump actions/github-script from 6 to 7 by @dependabot[bot] in #167
• Bump danielpalme/ReportGenerator-GitHub-Action from 5.4.4 to 5.4.8 by @dependabot[bot] in #168
• Disable some experimental features for dependabot by @markwallace-microsoft in #170
• Python: updated package structure by @eavanvalkenburg in #189
• .Net: Removed PersistentAgentsChatClient implementation in favor of Persistent SDK by @dmytrostruk in #190
• Python: Azure chat client by @peterychang in #185
• .NET Fix - Display thread type name in error message by @crickman in #192
• Add ChatClientAgent constructor overload by @westey-m in #188
• Add extension methods to get an AF agent from a Foundry Client by @westey-m in #191
• .Net: Add OpenTelemetry Support and Samples by @rogerbarreto in #182
• Rename Agent to AIAgent and add DisplayName prop by @westey-m in #201
• Python: improved loading by @eavanvalkenburg in #202
• Python: Implemented FoundryChatClient by @dmytr...