.NET Workflows - Declarative action update #1761

crickman · 2025-10-28T23:21:06Z

Motivation and Context

Updating declarative workflows to use updated Object Model and V2 Agents API.

Description

Conforms to design detailed here

Updated Microsoft.Bot.ObjectModel and related packages.
Targets Agent V2 API / SDK
Samples updated
Workflows updated

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.

Comment and nullable type alignment

Copilot

Pull Request Overview

This pull request updates the conversation retrieval/creation logic in the PersistentAgentsClientExtensions class. The changes include renaming GetConversationsClient() to GetConversationClient() and reformatting the ternary operator, but also introduces a duplicate call that appears to be unintentional.

Key Changes

Method name change from GetConversationsClient() to GetConversationClient()
Reformatted ternary operator for conversation assignment
Added a duplicate conversation creation call (likely unintended)

dotnet/src/Microsoft.Agents.AI.AzureAI/New/PersistentAgentsClientExtensions.cs

…tive-foundry-agents

Copilot

Pull Request Overview

Copilot reviewed 20 out of 21 changed files in this pull request and generated 1 comment.

dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/Interpreter/WorkflowActionVisitor.cs

…tive-foundry-agents

dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/ObjectModel/InvokeAzureAgentExecutor.cs

…tive-foundry-agents

Copilot

Pull Request Overview

Copilot reviewed 123 out of 125 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

workflow-samples/setup/TeacherAgent.yaml:1

Corrected spelling of 'congraluations' to 'congratulations'.

dotnet/src/Shared/Workflows/Execution/WorkflowFactory.cs

dotnet/src/Shared/Workflows/Execution/WorkflowRunner.cs

Copilot

Pull Request Overview

Copilot reviewed 123 out of 125 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/Extensions/JsonDocumentExtensions.cs:1

The assignment to AgentOutput?.Messages?.Path is outside the structured output parsing try-catch block. If ToTable() fails, the assignment will still complete. Consider whether this ordering is intentional or if the assignment should be conditional on successful parsing.

dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs

dotnet/src/Shared/Workflows/Execution/WorkflowRunner.cs

…cher/Program.cs Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 123 out of 125 changed files in this pull request and generated 2 comments.

dotnet/src/Shared/Workflows/Execution/WorkflowRunner.cs

workflow-samples/DeepResearch.yaml

…://github.com/microsoft/agent-framework into crickman/workflows-declarative-foundry-agents

crickman · 2025-11-07T19:37:09Z

…1662) * WIP * Fixed build errors (#1638) Comment and nullable type alignment * .NET: Azure.AI.Agents Package Split + Initial Extensions (#1657) * Move packages * Update nuget.config * Address Xmldoc * Remove format from branches checks * Address Xmldocs * Add more details to the implementation * Moving Agent logic to ChatClient * Adding Name and Id overrides to AzureAIAgent * Updating extensions * Add GetAiAgent extensions * Adding support for version as name can conflict 409 using the Agents API with same name * Addressing more updates to the extensions * More improvements * Remove debugging code from sample * Address copilot feedback * Apply suggestions from co-pilot code review * Update Directory.Packages.props Fix package version rollback: Azure.AI.Agents.Persistent (beta-6 => beta-7) * .NET: Add comprehensive unit tests for Microsoft.Agents.AI.AzureAIAgents extension methods (#1786) * Initial plan * Add comprehensive unit test project for Microsoft.Agents.AI.AzureAIAgents Co-authored-by: rogerbarreto <[email protected]> * Add README documenting test project and package dependency requirements Co-authored-by: rogerbarreto <[email protected]> * Fix documentation URL to use learn.microsoft.com Co-authored-by: rogerbarreto <[email protected]> * Bump back AAAP 1.2.0-beta.7 * Address AI generated UT's * Remove UT Readme * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: rogerbarreto <[email protected]> Co-authored-by: Copilot <[email protected]> * .NET: Change model to be required just for prompt agent definition specific extensions (#1812) * Remove unneeded model from extensions * Add noop justification * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI (#1829) * .NET: Update Extensions for Strict Agent Definitions + Improvements (#1892) * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI * Update agents and extensions to comply with strict agent definitions * More static updates * Address UT, and ResponseTool support * Improving reusability extensions * Addressing ResponseTools Unit Tests and extension setup * Adapted workaround on breaking AAA with OpenAI 2.6.0 * Small updates * Remove strictness when retrieving agents, improved XmlDocs * Improve sample comments * Update dotnet/tests/Microsoft.Agents.AI.AzureAI.UnitTests/AgentsClientExtensionsTests.cs Co-authored-by: Copilot <[email protected]> * Apply suggestion from @Copilot Co-authored-by: Copilot <[email protected]> * Apply suggestion from @Copilot Co-authored-by: Copilot <[email protected]> * Address PR comments * Address UT failing * Address Copilot feedback * Address Copilot feedback * Address comment typo * Address PR feedback * Address typo * Add missing Extensions with ChatClientAgentOptions * Address comments --------- Co-authored-by: Copilot <[email protected]> * Version update (#1901) * Updated package version (#1906) * .NET: Allow Declarative AIAgents Extensions (#1931) * Improve reusability of extension code and additional option to losen the strictiness of in-proc tools * Add missing UT scenarios * Add missing UT test scenarios * Normalize changes * Updated (#1948) * .NET: AgentDefinition extensions method simplification (#1967) * Update extensions methods that accepts AgentDefinition type to not be restrictive * Update Unit Tests * Revert yarn/package-lock * Revert yarn/package-lock * Address copilot feedback * Fix bad merge * .NET Workflows - WIP Declarative action update (#1761) * WIP * Fixed build errors (#1638) Comment and nullable type alignment * Sync to SDK update * Checkpoint * Checkpoint: Tests passing * Checkpoint: EndWorkflow * Add trace * .NET: Azure.AI.Agents Package Split + Initial Extensions (#1657) * Move packages * Update nuget.config * Address Xmldoc * Remove format from branches checks * Address Xmldocs * Add more details to the implementation * Moving Agent logic to ChatClient * Adding Name and Id overrides to AzureAIAgent * Updating extensions * Add GetAiAgent extensions * Adding support for version as name can conflict 409 using the Agents API with same name * Addressing more updates to the extensions * More improvements * Remove debugging code from sample * Address copilot feedback * Apply suggestions from co-pilot code review * Checkpoint * Update Directory.Packages.props Fix package version rollback: Azure.AI.Agents.Persistent (beta-6 => beta-7) * Add project reference * .NET: Add comprehensive unit tests for Microsoft.Agents.AI.AzureAIAgents extension methods (#1786) * Initial plan * Add comprehensive unit test project for Microsoft.Agents.AI.AzureAIAgents Co-authored-by: rogerbarreto <[email protected]> * Add README documenting test project and package dependency requirements Co-authored-by: rogerbarreto <[email protected]> * Fix documentation URL to use learn.microsoft.com Co-authored-by: rogerbarreto <[email protected]> * Bump back AAAP 1.2.0-beta.7 * Address AI generated UT's * Remove UT Readme * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: copilot-swe-agent[bot] <[email protected]> Co-authored-by: rogerbarreto <[email protected]> Co-authored-by: Copilot <[email protected]> * .NET: Change model to be required just for prompt agent definition specific extensions (#1812) * Remove unneeded model from extensions * Add noop justification * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI (#1829) * Checkpoint for merge * No build errors * .NET: Update Extensions for Strict Agent Definitions + Improvements (#1892) * Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI * Update agents and extensions to comply with strict agent definitions * More static updates * Address UT, and ResponseTool support * Improving reusability extensions * Addressing ResponseTools Unit Tests and extension setup * Adapted workaround on breaking AAA with OpenAI 2.6.0 * Small updates * Remove strictness when retrieving agents, improved XmlDocs * Improve sample comments * Update dotnet/tests/Microsoft.Agents.AI.AzureAI.UnitTests/AgentsClientExtensionsTests.cs Co-authored-by: Copilot <[email protected]> * Apply suggestion from @Copilot Co-authored-by: Copilot <[email protected]> * Apply suggestion from @Copilot Co-authored-by: Copilot <[email protected]> * Address PR comments * Address UT failing * Address Copilot feedback * Address Copilot feedback * Address comment typo * Address PR feedback * Address typo * Add missing Extensions with ChatClientAgentOptions * Address comments --------- Co-authored-by: Copilot <[email protected]> * Updated package version (#1897) * Version update (#1901) * Checkpoint * Updated package version (#1906) * Checkpoint * Checkpoint * Checkpoint * Align with azure ai agent * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/samples/GettingStarted/Workflows/Declarative/MCPToolApproval/Program.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/samples/GettingStarted/Workflows/Declarative/DeepResearch/Program.cs Co-authored-by: Copilot <[email protected]> * Refactored external input * Update dotnet/samples/GettingStarted/Workflows/Declarative/MCPToolApproval/Program.cs Co-authored-by: Copilot <[email protected]> * Agent tools patch * Demos validated * Checkpoint * Hygiene * Checkpoint - Samples * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs Co-authored-by: Copilot <[email protected]> * Checkpoint * Checkpoint - Deep Research * Update baseline * Update * Typo * Checkpoint * Typos * Sample cleanup * Update dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/AzureAgentProvider.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/src/Microsoft.Agents.AI.AzureAI/AgentsClientExtensions.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/samples/GettingStarted/Workflows/Declarative/FunctionTools/Program.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/samples/GettingStarted/Workflows/Declarative/ToolApproval/Program.cs Co-authored-by: Copilot <[email protected]> * Update dotnet/samples/GettingStarted/Workflows/Declarative/DeepResearch/Program.cs Co-authored-by: Copilot <[email protected]> * Typo * Typo * Fix input loop * Sample - Function Calling / External Input * Typo * Finessed * Checkpoint * Fix feed * Checkpoint - so close * Ding dong! * "there" *** * Fixup comments * Fix sample * Code analysis * Header * Typo (variableName) * Remove dead code * Skip test (agent api ratchet) * Comment * Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs Co-authored-by: Copilot <[email protected]> * Typo --------- Co-authored-by: Roger Barreto <[email protected]> Co-authored-by: Copilot <[email protected]> Co-authored-by: Copilot <[email protected]> Co-authored-by: Dmytro Struk <[email protected]> * .NET: Latest updates Pre/Post V2 Bugbash Findings (#2040) * Improve V2 logic before/after bugbash prep * Apply suggestions from code review Co-authored-by: Stephen Toub <[email protected]> Co-authored-by: Copilot <[email protected]> --------- Co-authored-by: Stephen Toub <[email protected]> Co-authored-by: Copilot <[email protected]> * .NET: Update Foundry Agents to latest 2.0.0 alpha.20251107.3 (#2050) * Update extensions for new CreateVersionOptions structure * Update unit tests * Addresss capitalized * Update AgentsClientExtensionsTests.cs Fix invalid cast format failure * .NET: Feature foundry agent + user agent (#2058) * Update unit tests * Add user-agent protocol calls * Update unit tests * Update unit tests with http handler confirmation * UT fix * Fix xmldoc * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * Address copilot feedback --------- Co-authored-by: Copilot <[email protected]> * .NET: Update Extensions to be less restrictive for GetAIAgents (#2091) * Update behavior / restrictiveness when retrieving agents * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * Address format * Address copilot feedback --------- Co-authored-by: Copilot <[email protected]> Co-authored-by: Chris <[email protected]> * .NET Workflows - Support "structured inputs" feature for declarative workflows (#2053) * Bump version for release * .NET Workflows - Separate Foundry/AzureAI Provider into its own package (#2078) * Remove unused using directive in AzureAgentProvider Removed unused using directive for Extensions. * .NET: Updates to Foundry Agents Package (#2125) * Remove the conversation creation always * Update unit tests + address IL + refactor * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * Internalize unused methods --------- Co-authored-by: Copilot <[email protected]> * Fix declarative workflows integration testcase * .NET: Feature foundry agent/agent reference extension (Python Parity with Name + Version option) (#2147) * Add agent reference extensions * Add UT covering AgentReference and ModelId * .NET: Add GettingStarted Samples for Agents V2. (#2159) * Add gettingstarted samples for Foundry Agents * Address structured outputs * Net 10 -> Net 9 Temporary * Net 10 -> Net 9 Temporary * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * Address missing docs + old * Drop var for samples * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * Apply suggestions from code review Co-authored-by: Copilot <[email protected]> * Address copilot feedback --------- Co-authored-by: Copilot <[email protected]> * .NET: Foundry Agents V2 - Add CodeInterpreter Sample (#2180) * Adding Code Interpreter sample and AgentName naming validation * Add agent name check UT * Improve sample code * Apply suggestion * Apply suggestion * Fixed (#2190) * .NET Workflows - Add "CustomerSupport" sample (#2102) * .NET Workflows - Add sample for hosted declarative workflow (#2199) * fwiw * Less blank lines * Fixed (#2204) * Update version (#2206) * .NET: Feature foundry agent/update breaking v2.0 to v1.2 (#2212) * Migration WIP Checkpoint 1 * Build + UT + Workflow passing * Address latest commits after break * Revert rename in unrelated files * Address PR comments * Class renames * Allow dotnet-format workflow on feature branches Revert unintentional edit * .NET: Add Conformance Integration Tests for AzureAI Package (#2237) * Conformance tests added and passing * Correct namespace * Update Azure.AI.Project to latest public nuget version * .NET: Added Computer use tool sample (#2235) * Initial computer use sample implementation. * Added background thread to allow polling for long running requests. * Removed unrequired try-catch block and added missing thread for agent call. * Removed irrelevant chatOptions and updated code based on feedback. * Updated image assets and fixed response issue. * Updated based on PR comments. * Update to Azure.AI.Project --------- Co-authored-by: Roger Barreto <[email protected]> * Package descriptions --------- Co-authored-by: Chris <[email protected]> Co-authored-by: Copilot <[email protected]> Co-authored-by: Copilot <[email protected]> Co-authored-by: Dmytro Struk <[email protected]> Co-authored-by: Chris Rickman <[email protected]> Co-authored-by: Stephen Toub <[email protected]> Co-authored-by: Mark Wallace <[email protected]> Co-authored-by: Peter Ibekwe <[email protected]>

rogerbarreto and others added 9 commits October 21, 2025 16:02

WIP

06e05cf

Merge branch 'main' into feature-foundry-agents

29b9d6a

Fixed build errors (#1638)

c2d674c

Comment and nullable type alignment

Merge branch 'main' into feature-foundry-agents

d2c3198

Merge branch 'main' into feature-foundry-agents

c3ea06d

Merge branch 'main' into feature-foundry-agents

0557f11

Merge branch 'main' into feature-foundry-agents

192d676

Merge branch 'main' into feature-foundry-agents

4146b7c

Sync to SDK update

bb1eb41

crickman self-assigned this Oct 28, 2025

Copilot AI review requested due to automatic review settings October 28, 2025 23:21

crickman added this to Agent Framework Oct 28, 2025

crickman added enhancement New feature or request .NET workflows Related to Workflows in agent-framework labels Oct 28, 2025

crickman moved this to In Progress in Agent Framework Oct 28, 2025

Copilot AI reviewed Oct 28, 2025

View reviewed changes

dotnet/src/Microsoft.Agents.AI.AzureAI/New/PersistentAgentsClientExtensions.cs Outdated Show resolved Hide resolved

crickman and others added 6 commits October 28, 2025 17:02

Merge branch 'main' into feature-foundry-agents

0a06dc4

Merge branch 'feature-foundry-agents' into crickman/workflows-declara…

95729c9

…tive-foundry-agents

Checkpoint

4f4e0c9

Resolve merge from feature branch

5afdb5d

Checkpoint: Tests passing

e6c29aa

Checkpoint: EndWorkflow

e36f89d

Copilot AI review requested due to automatic review settings October 29, 2025 00:20

markwallace-microsoft added the documentation Improvements or additions to documentation label Oct 29, 2025

Copilot AI reviewed Oct 29, 2025

View reviewed changes

dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/Interpreter/WorkflowActionVisitor.cs Show resolved Hide resolved

crickman and others added 3 commits October 28, 2025 17:32

Add trace

3b30526

Merge branch 'main' into feature-foundry-agents

f995468

Merge branch 'feature-foundry-agents' into crickman/workflows-declara…

f0aef93

…tive-foundry-agents

Copilot AI review requested due to automatic review settings October 29, 2025 14:57

crickman had a problem deploying to integration November 7, 2025 18:15 — with GitHub Actions Failure

peibekwe reviewed Nov 7, 2025

View reviewed changes

dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/ObjectModel/InvokeAzureAgentExecutor.cs Outdated Show resolved Hide resolved

crickman had a problem deploying to integration November 7, 2025 18:25 — with GitHub Actions Failure

crickman added 2 commits November 7, 2025 10:28

Typo (variableName)

8221b7f

Remove dead code

e78a52e

Copilot AI review requested due to automatic review settings November 7, 2025 18:32

Merge branch 'feature-foundry-agents' into crickman/workflows-declara…

9dd9801

…tive-foundry-agents

Copilot AI reviewed Nov 7, 2025

View reviewed changes

alliscode reviewed Nov 7, 2025

View reviewed changes

dotnet/src/Shared/Workflows/Execution/WorkflowFactory.cs Show resolved Hide resolved

Skip test (agent api ratchet)

8dc2a8f

crickman requested a review from peibekwe November 7, 2025 18:57

peibekwe reviewed Nov 7, 2025

View reviewed changes

dotnet/src/Shared/Workflows/Execution/WorkflowRunner.cs Show resolved Hide resolved

peibekwe approved these changes Nov 7, 2025

View reviewed changes

Comment

7b080a6

crickman requested review from alliscode and Copilot November 7, 2025 19:02

crickman temporarily deployed to integration November 7, 2025 19:06 — with GitHub Actions Inactive

crickman had a problem deploying to integration November 7, 2025 19:06 — with GitHub Actions Failure

Copilot AI reviewed Nov 7, 2025

View reviewed changes

dotnet/samples/GettingStarted/Workflows/Declarative/StudentTeacher/Program.cs Outdated Show resolved Hide resolved

dotnet/src/Shared/Workflows/Execution/WorkflowRunner.cs Show resolved Hide resolved

Update dotnet/samples/GettingStarted/Workflows/Declarative/StudentTea…

dcda214

…cher/Program.cs Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings November 7, 2025 19:11

Copilot AI reviewed Nov 7, 2025

View reviewed changes

dotnet/src/Shared/Workflows/Execution/WorkflowRunner.cs Outdated Show resolved Hide resolved

workflow-samples/DeepResearch.yaml Show resolved Hide resolved

crickman added 2 commits November 7, 2025 11:19

Typo

bfb2229

Merge branch 'crickman/workflows-declarative-foundry-agents' of https…

99fb914

…://github.com/microsoft/agent-framework into crickman/workflows-declarative-foundry-agents

crickman merged commit 2b869c2 into feature-foundry-agents Nov 7, 2025
3 checks passed

github-project-automation bot moved this from In Review to Done in Agent Framework Nov 7, 2025

crickman changed the title ~~.NET Workflows - WIP Declarative action update~~ .NET Workflows - Declarative action update Nov 7, 2025

crickman deleted the crickman/workflows-declarative-foundry-agents branch November 11, 2025 16:21

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

.NET Workflows - Declarative action update #1761

.NET Workflows - Declarative action update #1761

Uh oh!

crickman commented Oct 28, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

crickman commented Nov 7, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

.NET Workflows - Declarative action update #1761

.NET Workflows - Declarative action update #1761

Uh oh!

Conversation

crickman commented Oct 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation and Context

Description

Contribution Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Key Changes

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

crickman commented Nov 7, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

crickman commented Oct 28, 2025 •

edited

Loading