Visitar URL original
.NET: Adding AgentRunContext to allow accessing agent run info in external downstream components by westey-m · Pull Request #3476 · microsoft/agent-framework · GitHub
Skip to content

.NET: Adding AgentRunContext to allow accessing agent run info in external downstream components - #3476

Merged
westey (westey-m) merged 19 commits into
microsoft:mainfrom
westey-m:agentruncontext
Feb 5, 2026
Merged

.NET: Adding AgentRunContext to allow accessing agent run info in external downstream components#3476
westey (westey-m) merged 19 commits into
microsoft:mainfrom
westey-m:agentruncontext

Conversation

@westey-m

@westey-m westey (westey-m) commented Jan 28, 2026

Copy link
Copy Markdown
Collaborator

Motivation and Context

#3411

Description

  • Adding AgentRunContext
  • Setting AgentRunContext automatically on each run in AIAgent.

Contribution Checklist

  • The code builds clean without any errors or warnings
  • The PR follows the Contribution Guidelines
  • All unit tests pass, and I have added new tests where possible
  • Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

Copilot AI review requested due to automatic review settings January 28, 2026 11:41
@markwallace-microsoft Mark Wallace (markwallace-microsoft) added documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs .NET Usage: [Issues, PRs], Target: .Net labels Jan 28, 2026
@github-actions github-actions Bot changed the title Adding AgentRunContext to allow accessing agent run info in external downstream components .NET: Adding AgentRunContext to allow accessing agent run info in external downstream components Jan 28, 2026
Copilot AI reviewed Jan 28, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces AgentRunContext to provide ambient access to agent run information for downstream components like tools and middleware. This addresses issue #3411 regarding ConversationId propagation in Agent-as-a-Tool scenarios by making agent run context (agent, session, messages, options) accessible via AIAgent.CurrentRunContext using AsyncLocal<T>.

Changes:

  • Added AgentRunContext class to encapsulate agent run state (agent, session, request messages, run options)
  • Modified AIAgent to set CurrentRunContext using AsyncLocal<T> at the start of each run (both streaming and non-streaming)
  • Added comprehensive unit tests for AgentRunContext and updated AIAgent tests to verify context propagation
  • Added architectural decision record documenting the design rationale

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
dotnet/src/Microsoft.Agents.AI.Abstractions/AgentRunContext.cs New sealed class providing read-only access to agent run information
dotnet/src/Microsoft.Agents.AI.Abstractions/AIAgent.cs Added AsyncLocal field and CurrentRunContext property; modified RunAsync/RunStreamingAsync to set context
dotnet/tests/Microsoft.Agents.AI.Abstractions.UnitTests/AgentRunContextTests.cs Comprehensive unit tests for AgentRunContext constructor validation and property accessors
dotnet/tests/Microsoft.Agents.AI.Abstractions.UnitTests/AIAgentTests.cs Added tests verifying CurrentRunContext is set for all RunAsync/RunStreamingAsync overloads; updated TestAgentSession visibility
docs/decisions/0015-agent-run-context.md Architectural decision record explaining design choices and trade-offs

Comment thread docs/decisions/0015-agent-run-context.md Resolved
Comment thread docs/decisions/0015-agent-run-context.md Resolved
Comment thread docs/decisions/0015-agent-run-context.md Resolved
Comment thread dotnet/src/Microsoft.Agents.AI.Abstractions/AgentRunContext.cs Resolved
Comment thread docs/decisions/0015-agent-run-context.md Resolved
@westey-m
Apply suggestions from code review
068f624 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
rogerbarreto
Roger Barreto (rogerbarreto) reviewed Jan 28, 2026
View reviewed changes
Comment thread dotnet/tests/Microsoft.Agents.AI.Abstractions.UnitTests/AgentRunContextTests.cs Resolved
This was referenced Mar 16, 2026
Open
Closed
Merged
Closed
Open
Closed
This was referenced Mar 23, 2026
Open
Open
Open
Closed
Closed
Closed
Merged
Closed
This was referenced Apr 6, 2026
Closed
Open
Open
This was referenced May 2, 2026
Closed
Closed
Merged
This was referenced May 9, 2026
Closed
Closed
Closed
Closed
Closed
This was referenced May 18, 2026
Closed
Closed
@dependabot dependabot Bot mentioned this pull request Jun 10, 2026
Closed
@dependabot dependabot Bot mentioned this pull request Jun 24, 2026
Closed
@dependabot dependabot Bot mentioned this pull request Jul 15, 2026
Open

This branch was previously deployed

1 inactive deployment
integration — 2b40b8eb Deployed Feb 4, 2026 by westey-m via dotnet-build-and-test (net10.0, ubuntu-latest, Release, true, integration) #10797
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@rogerbarreto Roger Barreto (rogerbarreto) rogerbarreto approved these changes
@SergeyMenshykh SergeyMenshykh SergeyMenshykh approved these changes
@stephentoub Stephen Toub (stephentoub) Awaiting requested review from stephentoub

Assignees

No one assigned

Labels

documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs .NET Usage: [Issues, PRs], Target: .Net

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@westey-m @rogerbarreto @SergeyMenshykh @markwallace-microsoft