Uh oh!
There was an error while loading. Please reload this page.
.NET: Foundry V2 - Update Sample and Docs for clear distinction between Classic/New Foundry Agents. - #2459
Merged
Roger Barreto (rogerbarreto) merged 8 commits intoNov 26, 2025
Conversation
Roger Barreto (rogerbarreto)temporarily deployed
to
integration
November 25, 2025 17:08 — with 
GitHub Actions
Inactive
Roger Barreto (rogerbarreto)temporarily deployed
to
integration
November 25, 2025 17:08 — with GitHub Actions
Inactive
Copilotstarted reviewing on behalf of Roger Barreto (rogerbarreto)November 25, 2025 17:08 View session
Roger Barreto (rogerbarreto)
enabled auto-merge
November 25, 2025 17:09
Uh oh!
There was an error while loading. Please reload this page.
westey (westey-m)
approved these changes
Nov 25, 2025
Contributor
There was a problem hiding this comment.
Pull request overview
This PR clarifies the distinction between classic and new Azure Foundry Agents experiences by updating documentation and improving code clarity in sample files. The changes help developers understand which agent type they're working with and provide guidance for migration.
Key changes:
- Added documentation sections explaining classic vs new Foundry Agents with migration guide links
- Improved variable naming (e.g.,
jokerAgentV1→existingJokerAgent,latestVersion→latestAgentVersion) - Removed unnecessary instruction constants and inlined literal strings for improved clarity
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/samples/GettingStarted/FoundryAgents/README.md | Added section explaining classic vs new Foundry Agents with migration documentation link |
| dotnet/samples/GettingStarted/AgentProviders/Agent_With_AzureAIProject/README.md | Added header and comparison section identifying this as a new Foundry Agents sample |
| dotnet/samples/GettingStarted/AgentProviders/Agent_With_AzureAIProject/Program.cs | Updated variable names, removed constant, and inlined instruction strings for clarity |
| dotnet/samples/GettingStarted/AgentProviders/Agent_With_AzureAIAgentsPersistent/README.md | Added header and comparison section identifying this as a classic Foundry Agents sample |
| dotnet/samples/GettingStarted/FoundryAgents/FoundryAgents_Step01.1_Basics/Program.cs | Updated variable names, removed constants, and inlined instruction strings for clarity |
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
SergeyMenshykh
approved these changes
Nov 25, 2025
Roger Barreto (rogerbarreto)had a problem deploying
to
integration
November 26, 2025 00:42 — with GitHub Actions
Error
Roger Barreto (rogerbarreto)had a problem deploying
to
integration
November 26, 2025 00:42 — with GitHub Actions
Error
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Roger Barreto (rogerbarreto)temporarily deployed
to
integration
November 26, 2025 00:43 — with GitHub Actions
Inactive
Roger Barreto (rogerbarreto)temporarily deployed
to
integration
November 26, 2025 00:43 — with GitHub Actions
Inactive
westey (westey-m)
approved these changes
Nov 26, 2025
github-merge-queueBot
removed this pull request from the merge queue due to failed status checks
Nov 26, 2025
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
This was referenced Dec 22, 2025
This was referenced Jan 9, 2026
This was referenced Jan 19, 2026
This was referenced Jan 28, 2026
Aris Nguyen (arisng) pushed a commit
to arisng/agent-framework
that referenced
this pull request
Feb 2, 2026
…en Classic/New Foundry Agents. (microsoft#2459) * Address potential confusion around agent version vs API version * Address potential confusion around agent version vs API version * Add extra documentation for clarity * Remove V2 remainers * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: westey <164392973+westey-m@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>
This was referenced Mar 2, 2026
Open
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request updates the Azure Foundry Agents samples and documentation to clarify the differences between the classic and new Foundry Agents experiences, and to improve code clarity and consistency in the agent creation samples. The changes also update variable names for better readability and remove unnecessary constants.
Documentation improvements:
README.mdfiles for both classic and new Foundry Agents samples, including a comparison and a link to the official migration guide. [1][2][3]README.mdto highlight the new experience and direct users to the appropriate samples and migration documentation.Sample code consistency and clarity:
Agent_With_AzureAIProject/Program.csandFoundryAgents_Step01.1_Basics/Program.cs, removed unnecessary instruction string constants, updated variable names (e.g.,jokerAgentV1→existingJokerAgent,jokerAgentV2→newJokerAgent,latestVersion→latestAgentVersion), and inlined instruction strings for improved clarity. [1][2]