agent-framework

Python: Azure chat client (#185 )

* updated openai, fcc works, with sample

* reduced files in openai

* Add azure chat client

* fix tests

* Update python/packages/main/tests/unit/test_openai_chat_completion_base.py

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

* Update python/packages/azure/agent_framework/azure/__init__.py

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

* Update python/packages/azure/agent_framework/azure/_azure_openai_settings.py

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

* PR comments

* fix bad merge

* disable tests for now

* actually disable tests for azure

* fix tests, align test files with merge changes

* update code for new project structure

* PR comments

* add streaming integration tests. Fix flakiness

---------

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

peterychang · 2025-07-15 18:38:09 +00:00

f0dc661c3e

Removed Persistent SDK IChatClient implementation (#190 )

Dmytro Struk · 2025-07-15 17:37:42 +00:00

fa96f74ee9

small update in init (#189 )

Eduard van Valkenburg · 2025-07-15 15:09:32 +00:00

2e6f6a4008

Disable some experimental features for dependabot (#170 )

Mark Wallace · 2025-07-15 14:08:32 +00:00

c30d726914

Bump danielpalme/ReportGenerator-GitHub-Action from 5.4.4 to 5.4.8 (#168 )

Bumps [danielpalme/ReportGenerator-GitHub-Action](https://github.com/danielpalme/reportgenerator-github-action) from 5.4.4 to 5.4.8.
- [Release notes](https://github.com/danielpalme/reportgenerator-github-action/releases)
- [Commits](https://github.com/danielpalme/reportgenerator-github-action/compare/5.4.4...5.4.8)

---
updated-dependencies:
- dependency-name: danielpalme/ReportGenerator-GitHub-Action
  dependency-version: 5.4.8
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

dependabot[bot] · 2025-07-15 14:08:10 +00:00

7f08c0b8ad

Bump actions/github-script from 6 to 7 (#167 )

Bumps [actions/github-script](https://github.com/actions/github-script) from 6 to 7.
- [Release notes](https://github.com/actions/github-script/releases)
- [Commits](https://github.com/actions/github-script/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/github-script
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

dependabot[bot] · 2025-07-15 14:07:44 +00:00

4ab1f3aa9c

Python: simple Agent sample (#180 )

* tweaks to agents and sample

* updated clients and agents

* single line run and print

* improved tool handling

* added note on setting max iterations

* fixed streaming param name

* updated tools test

* made kwargs alphabetical

* added params to run methods

* tweak to ensure right overload

Eduard van Valkenburg · 2025-07-15 14:01:21 +00:00

62917ee5e5

Update {Azure.AI.}OpenAI package versions (#187 )

Stephen Toub · 2025-07-14 18:04:52 -04:00

59bf7343af

Basic agent invocation sample (#175 )

* Basic agent invocation sample

* Simplify sample further.

* Add additional comment.

* Address code review comments.

* Suppress CA2000 and remove using from most basic sample, since the IChatClient instances involved do not do any disposal.

westey · 2025-07-14 15:15:46 +00:00

55045b5c1e

Python: follow on work on OpenAI (#169 )

* updated openai, fcc works, with sample

* reduced files in openai

Eduard van Valkenburg · 2025-07-12 05:15:51 +00:00

407ed6de70

Allow InProcessRuntime subscriptions to be processed concurrently (#179 )

* Allow InProcessRuntime subscriptions to be processed concurrently

* Fix tests

Stephen Toub · 2025-07-11 21:50:51 -04:00

80c1e2ee0a

Fix handoff function names (#178 )

* Fix handoff function names

Handoffs are including the agent name in the function name. But the agent name can include characters that are invalid for a function name, which results in errors. Replace them.

* Update dotnet/src/Microsoft.Agents.Orchestration/Handoff/HandoffActor.cs

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

---------

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

Stephen Toub · 2025-07-11 21:35:10 -04:00

18299bc701

Python: Added ChatClientAgentThread and ChatClientAgent implementations (#150 )

* Added ChatClientAgentThread

* Initial version of ChatClientAgent

* Completed ChatClientAgent

* Small fixes and unit tests

* Fixes based on pre-commit

* Small fixes

* Small renaming

* Small improvement

* Small fixes

* Addressed PR feedback

* Small fix

* Added method for AgentRunResponse from streaming conversion

* Addressed PR feedback

* Addressed PR feedback

* Addressed PR feedback

* Small fix

* More fixes

Dmytro Struk · 2025-07-11 18:09:09 +00:00

94e00bd49a

Python: Added AgentRunResponse and AgentRunResponseUpdate types (#157 )

* Removed instructions property from Agent

* Added AgentRunResponse and AgentRunResponseUpdate types

* Added unit tests for agent response types

* Small fix

* Addressed PR feedback

* Small improvement

* Small fix

Dmytro Struk · 2025-07-11 15:13:06 +00:00

df84675c0f

Round 2 of cleanup for agent runtime and orchestrations (#164 )

- Moved InProcessRuntime type into abstractions package and deleted InProcess package.
- Moved several members of IAgentRuntime to be extension methods instead, e.g. multiple GetActorAsync overloads.
- Added synchronous RegisterMessageHandler overloads and used them to avoid unnecessary async usage at call sites.
- Removed unnecessary surface area from InProcessRuntime, e.g. StopAsync, RunUntilIdleAsync, etc.
- Fixed spin loop in InProcessRuntime that would consume an entire core for the duration of the orchestration's operation.
- Removed a bunch of allocation from InProcessRuntime.
- Made a runtime optional for orchestrations, defaulting to using a temporary InProcessRuntime if none is provided.
- Removed custom delegate types from orchestrations.
- Consolidated namespaces.
- Used records to simplify message classes.
- Tweaked naming on AgentActor to make purpose of protected methods more clear.
- Removed invocation in AgentActor.InvokeAsync of empty update / isFinal parameter.
- Changed OrchestrationHandoffs to avoid needing to pass in agents duplicatively.
- Made various extension methods, such as those on OrchestrationHandoffsExtensions, into instance methods.

Stephen Toub · 2025-07-11 11:12:18 -04:00

456e7d1b65

.Net: Introduce Dependency Injection Samples (#165 )

* DI WIP

* Update dependency injection examples and Agent Creation update

* Rollback override for GettingStarted as Azure.AI.OpenAI package currentl does not support OpenAI 2.2.0 GA version

* Dropping ct

* Update dotnet/samples/GettingStarted/AgentSample.cs

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

---------

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

Roger Barreto · 2025-07-11 13:27:07 +00:00

eca0eb9cd0

Run Response ADR & Updates (#104 )

* Add ADR for different run response options

* Add another option to the list.

* Update agno non-streaming with further clarification

* Add another option

* Adding optional includeUpdates option

* Adding Pros/Cons for each option

* Make pros/cons a list

* Add some thoughts on structured outputs and custom AIContent types

* Update design doc to clarify primary and secondary better and split out custom response types with it's own options

* Add structured outputs competitive comparison and suggestion

* Address PR comments.

* Remove AgentRunFinishReason until we can find a good use case for it.

* Add finish reason to list of excluded properties.

* Add custom agent run response types.
Usage to follow.

* Update Agent run response types

* Add additional code coverage

* Remove onIntermediateMessage since it is unecessary with the new response approach.

* Add AgentId to response.

* Rename ParseAsStructuredOutput to Deserialize

* Update decision doc.

* Fix formatting.

* Update CopilotStudio to return new response types

* Address PR comment

Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

---------

Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

westey · 2025-07-11 11:39:18 +00:00

715769e649

Set CopilotStudio integration tests to manual run only. (#166 )

westey · 2025-07-11 10:58:37 +00:00

33d09d263b

Add CodeQL and Dependabot (#159 )

* Add CodeQL and Dependabot

* Address code review feedback

Mark Wallace · 2025-07-11 10:34:06 +00:00

4cafe1c985

Add PoC CopilotStudio agent (#84 )

* Add project and skeleton files.

* Add CopilotStudioAgent implementation

* Add CopilotStudio integration tests

* Fix typos and PR feedback.

* Fix .net framework build errors.

* Address PR comments

* Remove temp test.

* Add rawresponse for streaming updates and more comments.

* Add TODO to review streaming updates

* Address PR comments and fix some issues with streaming messages.

* Map additional properties to agent reponses

* Update CopilotStudio integration tests to match new approach.

* Update copilot studio namespaces/project names to match new naming

* Add todo's for AIContent types.

* Remove files from PR.

* Fix up sln file.

* Update .gitignore.

* Remove duplicate package version items.

westey · 2025-07-11 09:20:40 +00:00

b708e2507d

Run integration tests (#161 )

Mark Wallace · 2025-07-11 08:30:48 +00:00

b85c17c935

ADR for Agent Tools (#103 )

* Added ADR templates and README

* First version

* Added remaining sections and commonalities across different providers

* Small formatting update

* Small formatting fix

* Updates for code interpreter tool

* Small update

---------

Co-authored-by: Mark Wallace <127216156+markwallace-microsoft@users.noreply.github.com>

Dmytro Struk · 2025-07-11 08:12:09 +00:00

b9122eccea

Python: OpenAI Connector (#144 )

* Initial checkin of openai connector

* add tests

* extensions work

* chat completion client implicitly implementing ChatClient

* remove AIServiceClientBase

* remove PromptExecutionSettings

* consolidate chat completion types

* add integration test

* fix pre-commit check errors

* remove usage statistics from OpenAIHandler

* Update python/extensions/agent-framework-openai/agent_framework/openai/exceptions.py

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

* PR comments

* fix merge

* fix test import

* remove tests for now because they just fail

* Remove fixed TODO

---------

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

peterychang · 2025-07-11 07:34:25 +00:00

e70401e658

.Net: Update Code Interpreter Sample as a Step. (#148 )

* Updating code interpreter samples

* Small adjustments to ensure it works as expected

* Update dotnet/samples/GettingStarted/Steps/Step03_ChatClientAgent_UsingCodeInterpreterTools.cs

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

* Address xmldoc

* Addressing PR coment, external implementaions + ChatClients update, removing RawRepresentationFactory requirement

* Address warnings

* Update Fix warnings

* Proposed changes for the OpenAIAssistantChatClient

* Address PR comments

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Mark Wallace <127216156+markwallace-microsoft@users.noreply.github.com>

Roger Barreto · 2025-07-10 15:26:41 +00:00

fef4fd2c18

Update some dependency version (#162 )

Stephen Toub · 2025-07-10 14:22:17 +00:00

01fd74a80c

Remove instructions from base agent type, and ensure description is only required where necessary. (#154 )

* Remove instructions from base agent type, and ensure description is only required where necessary.

* Fix code issue.

* Remove unused import.

* Remove typo

* Make the description parameter optional

* Also use name for handoffs if no description is provided.

westey · 2025-07-10 13:06:45 +00:00

bc6573f475

First round of cleanup of runtime abstractions (#156 )

Stephen Toub · 2025-07-10 07:57:51 -04:00

fbf1f10a8a

removed version and reinstated init (#160 )

Eduard van Valkenburg · 2025-07-10 13:32:39 +02:00

a233d31813

Run integration tests when PR is being merged (#155 )

Mark Wallace · 2025-07-10 10:29:57 +00:00

f69c23020b

Python: added ChatClientBase with function calling (#147 )

* added ChatClientBase with function calling

* streaming update

* fixed typing

* test setup

* small update

* src setup

* removed src, updated test naming

* fixed test command

* alolow args

* updated test run

* added unit test folder to azure

* added init and unit test to azure

* added other cross tests

* restructured

* reset test run

* fix name

* removed always

* updated test

* extend pytest.xml locations

* run surface always

* added decorators for FC and marked tests

* fixed mypy settings and added tests

* fix override import

* removed import

Eduard van Valkenburg · 2025-07-10 09:18:15 +00:00

3449902b03

Enable running dotnet-build-and-test for push operations (#153 )

* Enable running dotnet-build-and-test for push operations

* Enable integration tests for all runs

* Enable integration tests for all runs

* Enable integration tests

Mark Wallace · 2025-07-09 15:31:33 +00:00

daf4788868

Port Agent Runtime abstractions / inprocess runtime (#149 )

Stephen Toub · 2025-07-09 09:08:45 -04:00

4a0f8dcbe0

Enable integration tests (#152 )

Mark Wallace · 2025-07-09 11:57:52 +00:00

31dfdcb3ce

Python: small streamline of agents and agent threads (#145 )

* small streamline of agents and agent threads

* slight update to tests

Eduard van Valkenburg · 2025-07-08 19:01:22 +00:00

e5ec41b869

.NET Port Agent Orchestration (#107 )

* Checkpoint

* Checkpoint

* Namespaces

* Namespace

* Cleanup

* Namespace order

* Fix sync

* Formatting

* Formatting

* Namespace

* Namespace order

* Code convention

* Naming

* Naming

* Text handling

* Text handling

* Namespace

* Namespace order

* Namespace ordering

* Test

* ValueTask

* net472

* Test fix

* Fix namespace (net472)

* Namespace

* Fix conditional namespace

* Fix type expression

* Compatibility and cleanup

* Sample compatibility

* Sample compat

* Test compat

* modifier order

* Simply http-stub

* Formating fix for unit-test

* Fix test

* Real fix

* Test clean-up

* Update dotnet/src/Microsoft.Agents.Orchestration/Handoff/HandoffOrchestration.cs

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

* Fix build errors after merging

---------

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

Chris · 2025-07-08 13:04:34 -04:00

7c8ec5ec19

.Python: Added Agent and AgentThread abstractions (#130 )

* Added Agent and AgentThread classes

* Addressed PR feedback

* Converted Agent to protocol

* Removed thread deletion logic

* Small update

* Small updates to the Agent protocol

Dmytro Struk · 2025-07-07 17:47:14 +00:00

35c938fb5b

Python: added embeddingsclient and redid chatclient (#132 )

* added embeddingsclient and redid chatclient

* added to init

* added client tests

* fixed typing

* fixed slice import

* fixed pyright

Eduard van Valkenburg · 2025-07-07 16:43:54 +00:00

09309c1239

Fix warnings (#133 )

Roger Barreto · 2025-07-07 15:12:02 +00:00

d6c829cddf

Python: added poe setup and docs (#131 )

* added poe setup and docs

* smaller bandit exclude

* updated poe

* updated naming

* added something in samples

* exclude docs from bandit

* updated readme

* removed ds_store

* updated readme

Eduard van Valkenburg · 2025-07-07 15:03:57 +00:00

91c5414836

feat: Model Client and associated Content Types (#53 )

* feat: ModelClient and content types

* refactor: Pythonify ChatResponseFormat and ChatRole

* feat: Add guardrail interfaces

* refactor: Remove CancellationToken

* feat: Solidify the Usage APIs

* Adds well-known keys for additional_counts, and guidance for how to avoid collisions between providers
* Implement sum-aggregation for usage

* refactor: Move AITool out of model_client

* refactor: Copy editing

* fix: CI checks (pyupgrade, ruff, etc.)

* ci: Fix pre-commit to use pyright in  uv venv

The existing pyright precommit hook inside of python-pyright is no longer being maintained by the owner (see  https://github.com/RobertCraigie/pyright-python/issues/265)

The fix is to define the hook ourselves, relying on `uv run` to drive it. In order for that to work right we need to use the "system" language to break out of the sandbox.

* fix: Pyright error fixes

* docs: Update models and types design docs

* Python: Refinement of content types and model client  (#112)

* refinement of structure and buildup
with ports from semantigen

* refined the data and uri contents

* refined chat response and updates

* moved things and added tests

* moved out of src folder

* fixed imports and tests

* small tweaks

* missing build system

* upgrade

* add mypy

* fixed typing for types

* fix tests

* fixed tool

* disable json checks on vscode

* remove print

---------

Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <github@vanvalkenburg.eu>

Jacob Alber · 2025-07-03 17:51:49 +00:00

94c5d59984

Python: package setup with logger (#125 )

* package setup with logger

* set config once

* add unit test workflow

* updated naming of workflows

* add mypy check

* renamed job

* smaller name

* ignore certain files for ruff

* remove assignment

* fix ruff config

* removed pyright from pre-commit

* fixed logging test

* fix mypy setup

* mypy fix

* mypy

* mypy

Eduard van Valkenburg · 2025-07-02 15:17:28 +00:00

7cc29fe192

Python package design (#108 )

* initial draft of python package design

* typo

* revision

* further updates

* refinement

* refinement

* refinment

* added open q

* small edits

* type checking update

* refinement

* extended the logging section

* updates based on review

* added note on Otel

* restructured for even less verbosity

Eduard van Valkenburg · 2025-07-02 09:38:50 +00:00

0c61aee8e5

.Net: Code interpreter tool abstraction and implementation examples (#110 )

* Added code interpreter abstraction updates for OpenAI Assistants

* Updated Persistent Agents implementation based on latest changes in SDK

* Added code interpreter abstraction updates for Azure AI Persistent Agents

* Small note for OpenAI responses code interpreter

* Small update

* Fixes after merge

* Addressed PR feedback

* Small update

* Small fix

* Fix after merge

Dmytro Struk · 2025-07-01 14:59:51 +00:00

fbb0fdfe0d

Renaming to use Microsoft.Extensions prefix (#120 )

* Rename the folders

* Rename the .csproj files

* Some build file updates

* Update namespaces

* Fix order of imports

* Fix order of imports

* Fix order of imports

Mark Wallace · 2025-07-01 08:15:28 +00:00

95738b0ac2

.Net: Agent Samples - Adding AzureAIAgentsPersistent to Steps (#105 )

* Adding Persistent Agent to Steps

* Add comments

* Ensure changes

* Fix format

* Fix formatting

* Adding cancellation token good practice

Roger Barreto · 2025-06-26 22:17:59 +00:00

b46ee00468

.Net: Add Reasoning Model Integration tests (#100 )

* Add reasoning integration tests

* Adding Reasoning Model config

Roger Barreto · 2025-06-25 19:50:29 +00:00

06a690685f

Suggested tweaks to Agent (#88 )

- Id should return a stable ID, not a different value per access
- The RunAsync virtuals needn't be virtuals... a derived type can/should override just the main worker abstract method
- The protected methods should do argument validation

Stephen Toub · 2025-06-24 15:57:40 +00:00

e7b559fa62

Add decisions folder and ADR templates (#101 )

* Add decisions folder and ADR templates

* Update docs/decisions/README.md

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

---------

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

Mark Wallace · 2025-06-24 16:57:17 +01:00

feed6f4651

Add function call integration tests (#90 )

* Add function call tests

* Address PR comment

westey · 2025-06-23 09:02:17 +00:00

5f2af80735

Remove AdditionalInstructions from AgentRunOptions since it is not well supported outside of ChatClientAgents (#87 )

* Remove additional instructions from AgentRunOptions since it is not well supported outside of ChatClientAgents

* Fix typos and remove unused test.

* Make further namespace fixes and update AzureAIAgent with new tests.

* Expand tests to increase code coverage

westey · 2025-06-20 11:54:37 +00:00

578b35723a

1982 Commits