agent-framework

.NET: Implement browse/clear functionality for state (#513 )

* feat: Implement browse/clear functionality for state

* fix: Assertion comments in StateManagerTests

Jacob Alber · 2025-08-27 21:12:21 +00:00

80e89a7d87

Python: Improved Azure OpenAI integration tests (#489 )

* Improved Azure OpenAI integration tests

* Small fixes

* Credential fixes

* small fix

* error fix

---------

Co-authored-by: Giles Odigwe <gilesodigwe@microsoft.com>

Giles Odigwe · 2025-08-27 17:41:11 +00:00

1134350fcf

.NET: Fixes for ChatClientAgent to improve MEAI static analysis compliance (#502 )

* Fixes for ChatClientAgent to improve MEAI static analysis compliance

* Improve instruction handling and fix unit tests.

* Address PR comments.

westey · 2025-08-27 15:27:41 +00:00

938d91d1db

Python: Tracing for workflows (#480 )

* workflow tracing design doc

* add tracing implementation for workflow

* fix bug caused by double wrapping of sub workflow request

* add unit tests for tracing

* add documentation for workflow tracing

* remove unnecessary file

* update aspire command

* fix tests

* proper serialization of subworkflows and add workflow.definition

* add serialization test

* fix subworkflow serialization

* workflow_id --> id

* update workflow sample to address comments

* update naming; use costant

* use NoOpTracer instead of nullcontext

* use span event instead of attribtutes for status

* fix typing

* add workflow.build span

* rename methods for clarity

* ensure all source trace contexts are propagated in fan in

Eric Zhu · 2025-08-27 14:09:16 +09:00

379e3b9a00

.NET: Make WorkflowBuilder more intuititve (#503 )

* feat: Make WorkflowBuilder more intutitve

Right now Executorish binding has some unintutitive behaviour. When a user adds an eecutor with an id of an executor that already exists, we silently replace it, if the user provides it inside of add_edge. When a user introduces an executor via an unbound id, the user must bind it via BindExecutor, even though the registration is created implicitly when an edge id added.

The change will remove the invisible update in favor of a "best efforts" check of type and instance equality.

* Expand errors when rebinding to disallowed

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Jacob Alber · 2025-08-26 22:42:07 +00:00

78125f019a

Add transparency FAQ (#504 )

* Add transparency FAQ

* Update TRANSPARENCY_FAQs.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update TRANSPARENCY_FAQs.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update TRANSPARENCY_FAQs.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Add documentation links to transparency FAQ

* Update transparency FAQ formatting

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

e-straight · 2025-08-26 20:44:41 +00:00

1f279b01d2

Python: Clean up and formatting (#487 )

* Clean up and formatting

* Fix mypy

* Bug fix

Tao Chen · 2025-08-26 20:21:32 +00:00

beb5218838

Added contributing guidelines (#470 )

* Added contributing guidelines

* Address PR feedback: remove TypeScript references and fix .NET build commands

e-straight · 2025-08-26 20:10:55 +00:00

5df0bd6cb0

fix: State Updates are not published without CheckpointManager (#501 )

Jacob Alber · 2025-08-26 17:41:48 +00:00

8544cd9b03

Python: Removed DefaultAzureCredential (#490 )

* Removed DefaultAzureCredential

* Renamed ad_credential to credential

Dmytro Struk · 2025-08-26 15:33:17 +00:00

fa88641263

Add logging and error handling for team membership

Log team membership data and handle errors gracefully.

Mark Wallace · 2025-08-26 08:15:15 +01:00

20d861076a

Remove members property because it is invalid (#491 )

Mark Wallace · 2025-08-26 08:06:18 +01:00

90fb1eb78b

.NET: feat: Implement Checkpointing API (#420 )

* feat: Implement Checkpointing API

* refactor: Normalzie Namespaces and break out multi-class files

* feat: Support checkpointing in AIAgentHostExecutor

* test: Representation tests

* feat: Add Step-level Tracing and WorkflowEvents

* feat: Add Checkpointing Sample and Smoke Test

* Fixes an issue where StateManager was not properly clearing the incoming queued updates.
* Fixes order of checkpointing and in-step event publication
* Adds import of RunContext state on LoadCheckpoint
* Add re-firing of events for unserviced ExternalRequests on Checkpoint load

* docs: Add documentation to publics

* Also adds documentation to ICheckpointManager which may go public

* refactor: Fix Union Aggregators and add Tests

* fix: Fix issues raised in PR comments and remove dead code

Jacob Alber · 2025-08-25 23:04:38 +00:00

d7c39d72cc

Add proposed stucture for samples and user documentation (#484 )

westey · 2025-08-25 17:11:09 +00:00

435fd14da5

.NET: API specification for Foundry SDK alignment (#359 )

* API specification for Foundry SDK alignment

* Add descriptions to the samples

* Add descriptions to the samples

* Address some review feedback

* Remove sample

* Remove sample

* Update docs/specs/001-foundry-sdk-alignment.md

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* Update docs/specs/001-foundry-sdk-alignment.md

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* Update docs/specs/001-foundry-sdk-alignment.md

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* Update docs/specs/001-foundry-sdk-alignment.md

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* Address code review feedback

---------

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

Mark Wallace · 2025-08-25 17:04:56 +00:00

5284b611c2

Add logic to exclude labelling issues created by the development team (#468 )

Mark Wallace · 2025-08-25 16:58:54 +00:00

5cae83402a

fix chat_options in kwargs error path in responses client (#483 )

peterychang · 2025-08-25 16:52:42 +00:00

7942a52ca1

Adding draft version of workflows design doc. (#271 )

* Adding draft version of workflows design doc.

* Adding message flow diagrams and fixing group chat sample.

* Added sequence diagram for fan_in with WhenAny

* Updating workflows design

* clean up

* Clean up request & response contents

* Add more future enhacements

* message_handler -> handler

* remove mention of visual designer

* Minor updates and rename

* Name reformat

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
Co-authored-by: Tao Chen <taochen@microsoft.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Ben Thomas · 2025-08-25 16:10:24 +00:00

32c26c3c25

Improved exception messages (#479 )

Dmytro Struk · 2025-08-25 14:46:48 +00:00

4b9eea906f

fix thread deserialization (#481 )

Korolev Dmitry · 2025-08-25 12:15:02 +00:00

e72cfa1d71

.NET: feat: Microsoft.Extensions.AI.Agents.Hosting.A2A package (#390 )

* add timeout handling for message send

* prepare a2a proj

* fix it finally

* add a holder for selected protocol

* init types ;

* see discoveredAgentCardJson

* prettify json

* correct usage

* client setup for card

* setp?

* message:send

* init task based communication

* try call it via the agent thread

* okay i got back the message wooooow!

* nit

* fix duplicates

* yea matey!

* fix knights-knaves for A2A-Task-based communication

* fix a2a agents csproj

* AI feedback

* a2a does not support netstandard / netfx

* try fix build + refactor

* bump a2a for net9 only

* rollback System.Net.ServerSentEvents & Microsoft.Bcl.AsyncInterfaces version upgrade; override in-place and retarget to net9;net8 for A2A

* address PR comments x1

* refactor a2a interfaces

* address PR comments x2

* fix cancel usage

* separate project for A2A.AspNetCore

* simplify

* cleanup

* cleanup dependencies

* generate convertor tests / fix namespaces etc

* setup actor client!

* fix build

* backoff conversations

* fix duplicate message streaming

* address PR comments x1

* remove internalsvisibleto

* dont implement agent card query on my own: give it to the user

* nit

* rename and move projects

* fix dotnet-format

* address PR comments x1

* remove unreferenced project

* rollback

* rename

* nit

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Korolev Dmitry · 2025-08-25 11:14:55 +00:00

6ec21859cf

.NET: Add Approval capabilities to FunctionInvokingChatClient (#457 )

* Add Approval capabilities to FunctionInvokingChatClient

* Address PR comments.

* Address PR comments.

* Address PR comments.

* Address PR feedback, add sample, and fix bug plus unit test.

* Address PR comments

westey · 2025-08-25 10:41:10 +00:00

a40eda48f1

Python: Adding support for nested workflows (#460 )

* Adding design documents and data flow descriptions for sub-workflows

* Updating docs.

* Sub-workflow implementation #1. Stuck because of singleton RequestInfoExecutor, going to make a change to remove that restrivtion.

* Removed the singleton restriction on RequestInfoExecutor so enable sub-workflows.

* Scenarios seem to be working.

* Sample improved.

* going to have intern add generic response wrappers.

* Wrapped responses working.

* Non-hardcoded routing is working.

* Sample showing external approved and not approved.

* Cleaning up.

* Updating some samples and user guide.

* Removing old design doc.

* Cleaning up.

* Adding python-package-setup.md back.

* Update python/packages/workflow/agent_framework_workflow/_executor.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/workflow/agent_framework_workflow/_validation.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Removing prints.

* Fixing lint and type issues.

* Update python/packages/workflow/agent_framework_workflow/_executor.py

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

* Adding type hints to intercepts decorator.

* Removing unused files.

* Fixing issue with sample 5 groupchat with hil.

* Removing redundent samples.

* Updates to ensure no conflicting request interceptors and to support a subflow with multiple requests in a single super step.

* Fixing pypi errors.

* clean up samples

* update samples to make it more clear

* warning for unhandled request info from sub workflow

* add logger info

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Ben Thomas · 2025-08-23 03:21:37 +00:00

dotnet-0.0.1-nightly-250825.1 dotnet-0.0.1-nightly-250824.1 dotnet-0.0.1-nightly-250823.1 b0b3fd151c

feat: Expose wrapped Request/Response API (#471 )

* Allows creation of ExternalRequest objects directly to control the requestId
* Allows receiving ExternalResponse objects rather than unwrapped Data
* Normalizing naming

Jacob Alber · 2025-08-22 22:07:28 +00:00

b26d9c95fe

Python: Move Workflow, Edge, EdgeGroup and Executor to AFBaseModel (#472 )

* Refactor workflow to introduce EdgeRunner for edge execution.

* Fix edge cases

* Convert Workflow, Edge, EdgeGroup, and Executor into AFBaseModel to support object model serialization

* format

* remove accidental file

* fix typing

* Add type information to EdgeGroup and Executor subclasses

* fix format

* Add condition_name field to Edge

* Add new fields

* remove Optional

* Update

Eric Zhu · 2025-08-22 22:02:34 +00:00

6e9d35830f

.NET: feat: Host Workflow as AIAgent (#469 )

* feat: Host Workflow as AIAgent

* Also changes AIAgent-as-Executor to use streaming runs and streaming
  events
* Also enables default setting for yielding events

* fix: Infinite loop in GenerateNewId()

* docs: Spelling

* test: Add Workflow-as-Agent sample and test

Jacob Alber · 2025-08-22 22:01:30 +00:00

88c51013c6

.NET: Enhance console samples while preserving copyability (#475 )

* Enhance console samples while preserving copyability

* Add readme for minimal console demo

* Suppress pre-release version warning

* Address PR comments

* Change showing settings to opt-in

* Update comment

westey · 2025-08-22 14:58:10 +00:00

71a0bf22eb

.NET: chore: support retries on Cosmos storage creation (#402 )

* support retries

* tests + registration options

* fix ordering ..

* HK + update packages

* fix paths

* Update dotnet/tests/CosmosDB.IntegrationTests/Microsoft.Extensions.AI.Agents.Runtime.Storage.CosmosDB.Tests/CosmosTestFixture.cs

* re create project and fix some pk usage

* fix all tests

* try workflow?

* wip 1

* fix definition

* try with cosmos_use_emulator env?

* try ignore SSL errors?

* other cert verifications

* hardcode to 8081?

* proper valuation of ENV

* logging

* ensure db exsists for CI

* bump

* cleanup

* fix usage

* nit comment

* try only release for stability?

* try skip some flaky tests

* merge fixes + rollback container

* reimplement with iasyncdisposable pattern

* remove example doc struct

Korolev Dmitry · 2025-08-21 18:37:12 +00:00

dotnet-0.0.1-nightly-250822.1 25291de8cb

Fix URLs in in README (#467 )

Eric Zhu · 2025-08-21 17:18:02 +00:00

1116916737

Fix AzureOpenAI version (#466 )

Roger Barreto · 2025-08-21 16:37:59 +00:00

9f934d8b55

Python: Use generic for WorkflowContext and use its type parameters to indicate executor's output types (#444 )

* Use generic for WorkflowContext and use its type parameters to indicate executor's output types

* Update

* Fix type errors and add in-line comments

* fix test

* type

* Fix executor type issues

Eric Zhu · 2025-08-21 02:40:43 +00:00

dotnet-0.0.1-nightly-250821.1 65836ab125

Python: Improved main package test coverage (#445 )

* Fixed failing foundry tests and improved main coverage

* Add back mistakenly deleted code

* Update python/packages/main/tests/openai/test_openai_assistants_client.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/main/tests/openai/test_openai_assistants_client.py

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

* Small fix

---------

Co-authored-by: Giles Odigwe <gilesodigwe@microsoft.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Giles Odigwe · 2025-08-20 20:18:48 +00:00

123a0bca10

Python: Request cancellation sample (#459 )

* request cancellation via tasks

* fix missing kwargs

peterychang · 2025-08-20 19:56:26 +00:00

feb4e908ae

.NET: Bring OpenAIResponsesChatClient temporarily (#449 )

* copy OpenAIResponsesChatClient from meai temporarly

* Update dotnet/src/Microsoft.Extensions.AI.Agents.OpenAI/NewOpenAIResponsesChatClient.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* add AsNewIChatClient extension method

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

SergeyMenshykh · 2025-08-20 15:12:12 +00:00

011edfe420

.NET: Fix bugbash issues (#448 )

* Fix bugbash issues

* Update dotnet/samples/GettingStarted/Providers/AIAgent_With_OpenAIResponseClient.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Mark Wallace · 2025-08-20 12:22:11 +00:00

0982aa9d6d

Decision on where Foundry SDK extensions should live (#442 )

* Decision on where Foundry SDK extensions should live

* Address code review feedback

Mark Wallace · 2025-08-20 11:46:19 +00:00

4277aa2576

Python: Workflow visualization. (#372 )

* Workflow visualization.

* fix typing

* address comments

* update all samples

* Update fan in edge group visual

* fix quality check

* Update python/samples/getting_started/workflow/step_06_map_reduce.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* address comment

* Catch up with changes in workflow; add to_mermaid method

* Update examples

* fix test

* add installation guide to error messages

* Remove visualization for samples except for one.

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

Eric Zhu · 2025-08-20 00:07:49 +00:00

dotnet-0.0.1-nightly-250820.1 6900d3456c

.NET: feat: Improve Support for AIAgent-as-Executor (#432 )

* feat: Support Executor-targeted messages

This adds support for only sending a message to a given executor. Messages will still only route through connected edges.

* feat: Support sending all valid input types after starting a run

* feat: Normalize AIAgent-as-Executor Message Protocol to use MEAI types

Jacob Alber · 2025-08-19 20:04:03 +00:00

baaa9c0aee

Fix chat options for Responses API (#441 )

peterychang · 2025-08-19 00:23:01 +00:00

dotnet-0.0.1-nightly-250819.1 953ed7560d

Enable Mypy for Workflow (#433 )

Tao Chen · 2025-08-15 22:57:28 +00:00

dotnet-0.0.1-nightly-250818.1 dotnet-0.0.1-nightly-250817.1 dotnet-0.0.1-nightly-250816.1 c0c49d31d0

Python: Web search file search tools (#395 )

* Add web and file search tools

* add tests

* PR comments

* Add tools support for chat and assistants clients

* fix code checks

* add tests for assistants client

* Add samples

* fix fn descriptions

* Add openai responses model id to environment variables

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

peterychang · 2025-08-15 19:35:23 +00:00

0410f51777

Python: Workflow Edge Groups (#393 )

* Introducing edge groups

* Add conditional and partitioning edge groups; next add samples and tests

* Add unit tests

* Add samples

* Address comments 1

* Address comments 2

* Update conditional edge group to take in cases and default

* Minor updates to sample

* Collapsing Paritioning Edge group and Conditional Edge group to source edge group

* Improve sample clarity

* Name consolidation

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Tao Chen · 2025-08-15 18:11:35 +00:00

ed86baa6cb

Python: Foundry Chat Client unit tests to improve coverage (#423 )

* Add unit tests for Foundry Chat Client to improve coverage

* Updated Azure OpenAI endpoint and tests timeout

* Error fixes for Foundry Chat Client tests

* Error fixes

---------

Co-authored-by: Giles Odigwe <gilesodigwe@microsoft.com>
Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Giles Odigwe · 2025-08-15 17:45:14 +00:00

19d91bb950

.NET: Update MEAI 9.8.0 and accepted proposed abstractions (#427 )

* Update MEAI 9.8.0 and accepted proposed abstractions

* Address manual change in samples

* Address warnings

* Revert "Address warnings"

This reverts commit 52a7d60129.

Roger Barreto · 2025-08-15 17:34:56 +00:00

753f336a3a

.NET: Bring some MEAI types to AF temporarily. (#426 )

* Bring some MEAI types to AF temporarily.

* Exclude the copied files from code completion.

westey · 2025-08-15 15:41:45 +00:00

db253ccda0

.NET: Update OpenTelemetry Agent - Added Demo, AIAgentMetadata and Agent.GetService() (#356 )

* OTEL Demo

* updating telemetry sample

* OTEL updates

* WIP

* Adding GetService and Agent Metadata for Telemetry

* WIP

* Add UT for OTEL System behavior

* Address Unicode problem

* Add logging

* Adjust for new extensions

* Change Logger to LoggerFactory for the extension method

* Address AI Feedback

* Simplify script and readme just for Azure OpenAI

* Increase code converage

* Address merge conflict

* Another slnx fix

* Address PR comments

* Address PR feedback + Add UT

* Added Hosting UT to the solution

* Address PR comments

* Address missing sensitivity tests

* Remove unecessary override

* Address PR comments

Roger Barreto · 2025-08-15 15:41:21 +00:00

531132057b

Python: Thread storage and serialization (#394 )

* Updates for message store support

* Added unit tests

* Added suspend-resume example

* Added example with custom chat message store

* Small fix

* Addressed PR feedback

* Renaming and documentation

* More renaming

* Addressed more PR feedback

* Small fixes in Foundry chat client and examples

* Small update

* Addressed PR feedback

* Increased timeout for Azure tests

Dmytro Struk · 2025-08-14 21:15:42 +00:00

dotnet-0.0.1-nightly-250815.1 dea736e550

Small fix in Foundry chat client and samples (#407 )

Dmytro Struk · 2025-08-14 20:21:23 +00:00

95cb20ca40

Azure package unit tests to improve coverage (#414 )

Co-authored-by: Giles Odigwe <gilesodigwe@microsoft.com>

Giles Odigwe · 2025-08-14 16:19:44 +00:00

4007785b66

.Net: WIP: feat: Define Workflow and Executor APIs (#261 )

* feat: Define Workflow and Executor APIs

* feat: Define IExecutionContext and Events

* feat: Simple Workflow Demos

* refactor: Move Workflows classes to separate assembly

* feat: Move FanOut/In to LowLevel API with new semantics

* feat: Implement Local Execution

* refactor: Assembly name .Workflow => .Workflows

* feat: Enable Default Message Handling

* also lifts Bind in MessageHandlerInfo to better be able to direclty invoke handlers (for AOT, later)

* feat: Implement StreamingHandle APIs

This allows the user to respond to WorkflowEvents with external messages, enabling HIL.

* feat: Add checks for duplicate edges and chain cycles

* feat: Add built-in WorkflowEvents

* refactor: Pull classes into own files

* refactor: Simplify Disposal pattern in Executor

* refactor: Break EdgeRunner file into per-type files

* refactor: Use Throw.IfNull()

* refactor: Remove AddLoop()

Per https://github.com/microsoft/agent-framework/pull/272#discussion_r2241739079 we decided this was not very useful.

* refactor: Normalize use of ValueTask

* fix: Build Break from removing .AddLoop

* refactor: Explicit routing and RouteBuilder

Split out reflection from MessageRouter implemention into build phase, enabling AOT compilation to drive RouteBuilding without reflection.

* test: Add Reflection/Invocation tests

* fix: Terminate on Completion event

* refactor: Update public API surface

* feat: Add support for external requests

* feat: Support hosting AIAgent instances in Workflows

* fix: Fix routing to go through Executor.ExecuteAsync

* test: Update samples for "must SendMessage" semantics

* Add invoking samples to unit tests to avoid future breaks

* fix: ExternalRequest should block Workflow completion

* feat: Normalize API surface against Python

* Also adds xmldoc to all public APIs

* refactor: Normalize UnitTest and Sample namespaces

* fix: Formatting

* refactor: Normalize project/folder names

* feat: Remove DynamicCodeExecution from ValueTaskTypeErasure

* fix: Fix ILTrim warnings

* docs: Add missing docs and fix typos

* feat: Hosted Agents should report Run events

* fix: Fix type propagation for ILTrim changes

* refactor: Simplify DynamicallyAccessedMembers annotations

* sample: Use static-Type construction of InputPort

* feat: Support non-Streaming Run Mode

* test: Add test for non-streaming execution

* refactor: Remove unused types

* refactor: Simplify Event and EdgeData type hierarchies

* feat: Add Switch (=Conditional Edge Group) control flow

* feat: Make .NET AutoSend the MessageHandler result

* feat: Implement State APIs

* refactor: Simplify public namespaces and code organization

* refactor: Reconcile .NET and Python names

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Jacob Alber · 2025-08-13 22:34:39 +00:00

dotnet-0.0.1-nightly-250814.1 32711cfa95

2119 Commits