agent-framework

Fix AgentRunResponse serialization. (#273 )

Aditya Mandaleeka · 2025-07-30 01:20:29 +00:00

89de1c3c2f

.Net: FileSearch Tool Sample + API Proposal Updates for MEAI.Abstractions/Azure.AI.Agents (#210 )

* Wip, bringing persistent chat client back

* Bring back code interpreter resource logic

* Add file search samples and proposal for new OpenAIAssistantChatClient and AgentPersistantChatCLient

* Update dotnet/samples/GettingStarted/External/MEAI.Abstractions/NewHostedFileSearchTool.cs

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

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

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

* Update dotnet/samples/GettingStarted/External/Azure.AI.Agents.Persistent/NewPersistentAgentsChatClient.cs

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

* Update MEAI abstractions to reflect latest discussions, updated underlying chatclients

* Remove unneeded comments

* Address PR feedback

* Address PR feedback

---------

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

Roger Barreto · 2025-07-29 10:41:35 +00:00

02814a4fc0

.Net: Bump Azure.AI.Agents.Persistent and 6 others (#243 )

* Bump Azure.AI.Agents.Persistent and 6 others

Bumps Azure.AI.Agents.Persistent from 1.1.0-beta.4 to 1.1.0
Bumps Microsoft.Agents.CopilotStudio.Client from 1.1.125-beta to 1.1.151
Bumps Roslynator.Analyzers from 4.12.10 to 4.14.0
Bumps Roslynator.CodeAnalysis.Analyzers from 4.12.4 to 4.14.0
Bumps Roslynator.Formatting.Analyzers from 4.12.11 to 4.14.0
Bumps xunit from 2.9.2 to 2.9.3
Bumps xunit.runner.visualstudio from 3.0.2 to 3.1.3

---
updated-dependencies:
- dependency-name: Azure.AI.Agents.Persistent
  dependency-version: 1.1.0
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: Microsoft.Agents.CopilotStudio.Client
  dependency-version: 1.1.151
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: Roslynator.Analyzers
  dependency-version: 4.14.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: Roslynator.CodeAnalysis.Analyzers
  dependency-version: 4.14.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: Roslynator.Formatting.Analyzers
  dependency-version: 4.14.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: xunit
  dependency-version: 2.9.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: xunit.runner.visualstudio
  dependency-version: 3.1.3
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

* Missing extra bump

---------

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

dependabot[bot] · 2025-07-28 08:37:36 +00:00

92c6e26054

Clean up handoff orchestration creation (#235 )

- Remove Dictionary-derived types
- Add an optional name to orchestrations
- Make Handoffs based purely on AIAgent instances rather than separately provided names

Stephen Toub · 2025-07-24 16:38:23 +00:00

233c557173

.Net: Add missing providers to tool samples (#211 )

* Add missing providers to tool samples

* Add Options ctor and simplify samples a bit

* Remove basic

Roger Barreto · 2025-07-24 09:31:24 +00:00

62be887947

Clean up usage of JsonSerializerContext (#229 )

* Clean up usage of JsonSerializerContext

* review feedback

Reuben Bond · 2025-07-23 19:34:54 +00:00

5e9b24e532

Fix and simplify build (#218 )

Reuben Bond · 2025-07-23 17:45:50 +00:00

e6aeb9a5db

Overhaul orchestration library with new approach (#199 )

Stephen Toub · 2025-07-23 16:29:37 +00:00

5472d6e996

Initial draft of actor runtime abstractions (#197 )

* Initial draft of actor runtime abstractions

Reuben Bond · 2025-07-22 16:05:58 -04:00

41d441420e

Add an AgentRunResponse ctor accepting a ChatResponse (#204 )

* Add an AgentRunResponse ctor accepting a ChatResponse

* Update dotnet/src/Microsoft.Extensions.AI.Agents.Abstractions/AgentRunResponseUpdate.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-21 14:49:47 +00:00

d964b05ae7

Add a minimum console demo app (#198 )

* Add a minimum console demo app

* Remove hardcoded values from sample.

* Make console project .net 9.0 only.

* Move minimum console demo to demo folder.

* Fix framework issue with demo project.

* Undo unintended commit.

* Address PR comments

* Fix build issue.

* Address PR Comments

* Rename Agent to AIAgent in new console app.

westey · 2025-07-21 09:49:47 +00:00

a8fadbc49c

Round 3 of cleanup (#186 )

- Enable warnings as errors
- Make the remaining src projects NativeAOT compatible
- Use Throw helpers

Stephen Toub · 2025-07-20 23:07:50 -04:00

6c12b2c0f8

Rename Agent to AIAgent and instroduce DisplayName (#201 )

westey · 2025-07-18 15:43:38 +00:00

fc999e2be8

.Net: Add OpenTelemetry Support and Samples (#182 )

* Adding sample and implementation similar to MEAI approach

* Add Telemetry UnitTests

* Fix Async suffix

* Add ADR with the proposal

* Address merge changes

* Fixing const visibility + coverage

* Increase test coverage, add metrics collection code paths

* Fix warnings

* WIp

* Convention adeherence

* Add gen-ai.system logic + UT

* Add convetion reference

* Address PR comments

* Addressing PR comments, Agent name optional

* Remove constant

* Update dotnet/src/Microsoft.Extensions.AI.Agents/ChatCompletion/ChatClientAgent.cs

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

* GetLoggingName

---------

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

Roger Barreto · 2025-07-16 17:00:24 +00:00

6e57489a44

Add extension methods to get an AF agent from a Foundry Client (#191 )

* Add helpers to go from foundry client to agent more easily.

* Fix xml docs.

westey · 2025-07-16 14:45:31 +00:00

dd32a6d399

Add ChatClientAgent constructor overload (#188 )

* Add ChatClientAgent constructor overload

* Add unit tests for new constructor

* Up code coverage with extra tests

* Address PR comments.

* Address PR comment

* Add additional test to increase code coverage.

westey · 2025-07-16 13:36:17 +00:00

95a3264c8b

Display thread type name in error message (#192 )

Chris · 2025-07-15 21:11:31 +00:00

e6d611abe4

Removed Persistent SDK IChatClient implementation (#190 )

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

fa96f74ee9

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

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

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 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

.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

Port Agent Runtime abstractions / inprocess runtime (#149 )

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

4a0f8dcbe0

.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

Fix warnings (#133 )

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

d6c829cddf

.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 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

.Net: Add OpenAI Responses Agent Samples (#83 )

* Improved Merge logic

* Add modularization for Model Samples and Azure OpenAI

* Address PR feedback

* Warning fix

* Address PR comments

* Adding OpenAI Response Samples

* Clean up

* Revert to provider specific chat options

* Fix warnings

* Revert slnx changes

Roger Barreto · 2025-06-19 18:06:08 +00:00

2cd77596c3

.Net: Added Azure AI Persistent Agents (#81 )

* Added PersistentAgentsChatClient

* Added integration tests

* Small fixes

* Added sample

* Added TODO for tools

* Small rename

* Removed user-secrets id

* Renamed project

* Fixed warning

* Fixed warning

* More fixes

* More fixes

Dmytro Struk · 2025-06-19 14:01:26 +00:00

47dcad6b49

Add tests for ChatClientAgent with OpenAI responses (#82 )

* Add tests for ChatClientAgent with OpenAI responses

* Address PR comments

* Fix typo

westey · 2025-06-19 09:12:24 +00:00

d1d69af482

.Net: Add Azure OpenAI Agent Model Samples (#80 )

* Improved Merge logic

* Add modularization for Model Samples and Azure OpenAI

* Address PR feedback

* Warning fix

* Address PR comments

Roger Barreto · 2025-06-18 12:00:38 +00:00

14f3811648

Add additional integration tests and add OpenAIAssistant integration tests project. (#79 )

* Add additional integration tests and add OpenAIAssistant integration tests project.

* Address PR comments.

* Address PR comments.

westey · 2025-06-17 11:43:29 +00:00

e6bfc51367

.Net: Adding ChatOptions configuration to the Agent level (#75 )

* Adding ChatOptions configuration to the Agent level

* fix warnings

* Address Copilot Feedback

* Add UT for new AgentExtensions

* Add UnitTests for ChatOptions merging behavior

* Fix warning

* Address PR Feedback

* Update dotnet/src/Microsoft.Agents/ChatCompletion/ChatClientAgent.cs

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

---------

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

Roger Barreto · 2025-06-17 09:08:11 +00:00

16cbc44611

Add test infrastructure for agent conformance tests (#77 )

* Add test infrastructure for agent conformance tests

* Address PR comments.

* Switch TargetFrameworks to have inline condition

westey · 2025-06-16 11:32:20 +01:00

293cdb1846

Add sample for OpenAIAssistant ChatClientAgent (#74 )

* Add sample for OpenAIAssistant

* Fix warning

* Add tools sample and simplify running samples.

* Restructure samples to show common features separate from each type of underlying IChatClient implementation.

* Remove unecessary suppression.

* Renaming namespaces based on suggestion from PR.

westey · 2025-06-13 17:11:56 +01:00

4d3b17eb27

Update ChatClientAgentThread to support both in-memory and service storage. (#70 )

* Update ChatClientAgentThread to support both in-memory and service storage.

* Fix typos.

* Address PR comments

* Move code to reusable sections.

* Remove DefaultThreadStorageLocation

* Change thread type naming and make it internal

* Fix bug for streaming case.

* Add additional unit tests

* Add more unit tests to verify agent's thread update behavior.

westey · 2025-06-12 13:28:08 +00:00

d6dc360215

960 Commits