agent-framework

Python: Add support for the MagenticWorkflowBuilder (#496 )

* magentic happy path - wip

* Support workflow high-level magentic builder API. Add tests and samples.

* Add sample docstring

* Addressing PR feedback round 1

* Fix mypy errors

* Callback improvements

* Rename to MagenticBuilder

* Improvements

* Emit function calling deltas

* PR feedback 2

* Clean up sample

Evan Mattson · 2025-08-28 05:39:48 +00:00

529341f58b

Python: Improved foundry integration tests (#514 )

* improved foundry integration tests

* Update python/packages/foundry/tests/test_foundry_chat_client.py

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

* Update python/packages/foundry/tests/test_foundry_chat_client.py

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

---------

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

Giles Odigwe · 2025-08-27 21:54:28 +00:00

8e14dfc522

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

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

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

Python: Removed DefaultAzureCredential (#490 )

* Removed DefaultAzureCredential

* Renamed ad_credential to credential

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

fa88641263

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

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

7942a52ca1

Improved exception messages (#479 )

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

4b9eea906f

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

b0b3fd151c

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

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

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

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

6900d3456c

Fix chat options for Responses API (#441 )

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

953ed7560d

Enable Mypy for Workflow (#433 )

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

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

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

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

Python: Introducing Local MCP Servers (#389 )

* mcp parts

* mcp parts 2

* removed structured output in favor of handling in chatresponse, mcp as AITool and running samples

* updated naming

* fixed test

Eduard van Valkenburg · 2025-08-13 09:48:22 +00:00

ad3d8171bf

Fixed foundry sample issue (#403 )

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

Giles Odigwe · 2025-08-12 19:03:43 +00:00

80b0920e58

Python: add better test coverage to individual tests, and all-tests task, gh … (#400 )

* add better test coverage to individual tests, and all-tests task, gh action to surface

* remove cache location

* test version-file

* updated uv setup for consistency

* mypy fix

* update naming

* temporarily removed mypy from workflow

Eduard van Valkenburg · 2025-08-12 18:35:36 +00:00

53866218d2

Python: openai updates (#388 )

* openai updates

* rebuild of openai structure

* updated responses structure

* renamed sample

* added file id support to code interpreter

* added hosted file ids to code interpretor

* mypy fixes

* removed default az cred from codebase

* updated agent name setup

* added kwargs to entra methods

* and further kwargs

* extra comment

* updated all samples

* readded custom get methods for responses

* updated int tests with ad credential

* missed one

Eduard van Valkenburg · 2025-08-12 06:14:22 +00:00

df9d85d1f0

Python: introduce workflow checkpointing (#366 )

* Add workflow checkpointing functionality.

* Reintroduce protocol that went missing during merge

* Checkpoint updates

* Fix ordering of checkpointing

* Cleanup

* Cleanup - thanks Copilot

* Cleanup - thanks Copilot

* State reset updates

* State reset updates 2

* Workflow fixes and updates. Addressed PR feedback

* A few updates

Evan Mattson · 2025-08-11 22:33:46 +00:00

19676978e9

Python: added HostedFileContent and HostedVectorStoreContent (#379 )

* added HostedFileContent and HostedVectorStoreContent

* added convenience functions for hostedcodeinterpretertools

* fix docstrings

* udpated docstring

* clarified parsing logic

* updated type names

* updated test

* and vector stores

Eduard van Valkenburg · 2025-08-11 14:23:32 +00:00

bbc07931c1

Python: added AIAnnotation types and extra tests (#374 )

* added AIAnnotation types and extra tests

* fixed typing and such

* use copy

* fix raw representation for add

* handle annotations in add

* clarified concat

* self to first

Eduard van Valkenburg · 2025-08-08 20:27:31 +00:00

82d39bc1f7

Python: added create_agent and removed need for Field in annotations (#380 )

* added create_agent

* add minimal sample

* allow multiple annotations

* improved docstring

Eduard van Valkenburg · 2025-08-08 17:55:20 +00:00

8f27e63df6

Python: Added examples for Azure OpenAI Responses agent (#363 )

* Added examples for Azure OpenAI Responses agent

* Update python/samples/getting_started/agents/azure_responses_client/azure_responses_client_with_code_interpreter.py

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

---------

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

Dmytro Struk · 2025-08-08 14:45:07 +00:00

757c48e367

Python: Define Workflow and Executor APIs (#272 )

* Workflow init commit

* Add samples and clean up

* ExecutionContext -> WorkflowContext

* Address comments 1

* Fix mypy

* flatting folder structure, and rename contexts

* Remove add_loop

* Add map reduce sample, remove Activation conditions

* Add AgentExecutor and allow multiple handlers per executor

* Minor improvement

* Add RequestInfoExecutor

* Add unit tests part 1

* Address comments 2

* Pre-commit update

* Add run method and more unit tests

* Add xml docs

* run_stream -> run_streaming

* message_handler -> handler

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
Co-authored-by: Evan Mattson <evan.mattson@microsoft.com>

Tao Chen · 2025-08-06 23:26:15 +00:00

c8694a8c76

Python: Azure Responses client (#311 )

* Azure Responses client

* Fix a change made in the wrong place

* allow api_version and token_endpoint to use env vars

* Add getting started sample

* add responses deployment name env var

* update azure clients to use defaults for api_version and token_endpoint

* make tests more reliable

---------

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

peterychang · 2025-08-06 14:18:38 +00:00

f43939d803

Fix README's and update getting started (#352 )

Mark Wallace · 2025-08-06 13:37:32 +00:00

5a1de491d4

Python: Azure OpenAI Assistants Chat Client and Agent (#300 )

* Initial version of assistant client

* More updates to assistant client

* Finished assistant chat client implementation

* Small fixes and basic example

* Added code interpreter example

* More examples

* Added chat client example

* Small fixes

* Added tests

* Enabled telemetry

* Small fix

* Removed files temporarily

* Revert "Removed files temporarily"

This reverts commit 5cdfa0d299.

* Small fixes

* Addressed PR feedback

* Fixed tests

* Small update

* Added Azure assistants client and examples

* Added tests

* Small fix

Dmytro Struk · 2025-08-05 14:51:36 +00:00

c1d306ec95

Added author name logic to ChatClientAgent (#313 )

Dmytro Struk · 2025-08-05 05:47:52 +00:00

544d2ba48f

Python: small fixes in foundry (#297 )

* small fixes in foundry

* other samples updated

* make it optional

* added instructions and response format to create agent

* mypy fix

* shortened main readme and improved python readme

Eduard van Valkenburg · 2025-08-04 08:13:44 +00:00

c39845d473

Python: OpenAI Assistants Chat Client and Agent (#288 )

* Initial version of assistant client

* More updates to assistant client

* Finished assistant chat client implementation

* Small fixes and basic example

* Added code interpreter example

* More examples

* Added chat client example

* Small fixes

* Added tests

* Enabled telemetry

* Small fix

* Removed files temporarily

* Revert "Removed files temporarily"

This reverts commit 5cdfa0d299.

* Small fixes

* Addressed PR feedback

* Fixed tests

* Small update

Dmytro Struk · 2025-08-01 12:12:41 +00:00

75794b4687

Python: updated doc generation setup and some slight api enhancements (#267 )

* updated doc generation setup and some slight api enhancements

* small fix in index

Eduard van Valkenburg · 2025-07-31 15:04:22 +00:00

42c7a59640

Python: add agent telemetry (#283 )

* add agent telemetry

* updated comments

* update AgentRunResponseUpdate

* updated create_agent var

---------

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

Eduard van Valkenburg · 2025-07-31 10:29:38 +00:00

caee8bfa90

Python: updated API in sync with dotnet (#269 )

* updated API in sync with dotnet

* fix test

* updated name and display_name

* fixed mypy setup

* add pre-commit cache

Eduard van Valkenburg · 2025-07-30 08:50:22 +00:00

1ed89d4db8

added telemetry decorators to other chat clients (#255 )

Eduard van Valkenburg · 2025-07-28 17:08:58 +00:00

dff700e469

Python: OpenAI Responses Agent - threads, code interpreter, bug fixes and examples (#242 )

* Added basic example with small fix

* Added example with function tools

* Added example with thread management

* Small renaming

* Added example with code interpreter

Dmytro Struk · 2025-07-28 17:07:29 +00:00

c794892d79

different secret for python tests (#248 )

Eduard van Valkenburg · 2025-07-28 11:37:26 +02:00

f36cc40080

Python: updated python design and dev setup (#171 )

* updated python design and dev setup

* updated dev setup

* updated dev setup

Eduard van Valkenburg · 2025-07-28 11:28:58 +02:00

08a1b714b4

Merge tests (#247 )

* removed hardcoded model names from tests

* add debug line

Eduard van Valkenburg · 2025-07-28 11:12:28 +02:00

ba008cf4c0

Python telemetry (#223 )

* initial work on telemetry

* moved tool operation const

* missing quotes

* working otel with samples

* updated readme and other assets

* added tests

* added tests

* small updates

* updated genaiattributes docs

* updated tests

* additional warning

* cleanup of tests

Eduard van Valkenburg · 2025-07-28 07:33:42 +00:00

0ce8eb1e2f

Python: OpenAI responses client (#239 )

* Responses client WIP

* add responses class

* fix typing errors

* move test

* streaming responses, structured outputs

* tests

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

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

* pr comments

* fix override import

* fix mypy

* add missing function override

* PR comments

* add docstrings

---------

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

peterychang · 2025-07-25 17:56:22 +00:00

3ee9dddfa2

Python: Added fixes and more examples for OpenAI and Azure chat client agents (#232 )

* Added non-streaming and streaming examples

* Updated resource management

* Added examples with thread management

* Added function tools examples

* Small rename

* Added code interpreter example

* Updated example

* Addressed PR feedback

* Added more OpenAI and Azure chat completion examples

* File renaming

* Small fix in tests

* Small revert

* More renaming

* Small fix

Dmytro Struk · 2025-07-24 15:31:05 +00:00

a72245287f

Python: Added fixes and more examples for Foundry agent (#217 )

* Added non-streaming and streaming examples

* Updated resource management

* Added examples with thread management

* Added function tools examples

* Small rename

* Added code interpreter example

* Updated example

* Addressed PR feedback

* Addressed PR feedback

Dmytro Struk · 2025-07-24 14:47:45 +00:00

14efb626ab

73 Commits