Skip to content

Adding draft version of workflows design doc. - #271

Merged
Tao Chen (TaoChenOSU) merged 18 commits into
microsoft:mainfrom
alliscode:workflows-design
Aug 25, 2025
Merged

Adding draft version of workflows design doc.#271
Tao Chen (TaoChenOSU) merged 18 commits into
microsoft:mainfrom
alliscode:workflows-design

Conversation

@alliscode

@alliscodeBen Thomas (alliscode) commented Jul 29, 2025

Copy link
Copy Markdown
Member

Adding initial draft of updated workflows design document. This document outlines the goals, design principles, and current thinking on coding patterns.

CopilotAI review requested due to automatic review settings July 29, 2025 19:25
@eavanvalkenburgEduard van Valkenburg (eavanvalkenburg) added the documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs label Jul 29, 2025
CopilotAI reviewed Jul 29, 2025
View reviewed changes

CopilotAI 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 a comprehensive technical design document for the Semantic Kernel Workflow Framework. The document outlines an executor-based orchestration system designed for complex multi-agent workflows using a graph-based architecture with Pregel-style execution.

  • Comprehensive framework design with type-safe executor architecture and async event-driven execution
  • Detailed implementation patterns for sequential, concurrent, conditional, and human-in-the-loop scenarios
  • Future enhancement roadmap covering checkpointing, distributed execution, and observability features

Comment threaddocs/design/workflows_updated.md Outdated
Comment threaddocs/design/workflows_updated.md Outdated
Comment threaddocs/design/workflows_updated.md Outdated
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
ekzhu
Eric Zhu (ekzhu) reviewed Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
ekzhu
Eric Zhu (ekzhu) reviewed Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
alliscode
Ben Thomas (alliscode) commented Jul 29, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
eavanvalkenburg
Eduard van Valkenburg (eavanvalkenburg) reviewed Jul 30, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
eavanvalkenburg
Eduard van Valkenburg (eavanvalkenburg) reviewed Jul 30, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
eavanvalkenburg
Eduard van Valkenburg (eavanvalkenburg) reviewed Jul 30, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
eavanvalkenburg
Eduard van Valkenburg (eavanvalkenburg) reviewed Jul 30, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
eavanvalkenburg
Eduard van Valkenburg (eavanvalkenburg) reviewed Jul 30, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
eavanvalkenburg
Eduard van Valkenburg (eavanvalkenburg) reviewed Jul 30, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
ekzhu
Eric Zhu (ekzhu) reviewed Aug 6, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
ekzhu
Eric Zhu (ekzhu) reviewed Aug 6, 2025
View reviewed changes
Comment threaddocs/design/workflows_updated.md Outdated
@TaoChenOSUTao Chen (TaoChenOSU) mentioned this pull request Aug 6, 2025
Closed
@ekzhuEric Zhu (ekzhu) linked an issue Aug 11, 2025 that may be closed by this pull request
Workflow interface design #21
Closed
@TaoChenOSUTao Chen (TaoChenOSU) mentioned this pull request Aug 11, 2025
Merged
4 tasks
@TaoChenOSU
Tao Chen (TaoChenOSU) added this pull request to the merge queueAug 25, 2025
Merged via the queue into microsoft:main with commit 32c26c3Aug 25, 2025
8 checks passed
Reuben Bond (ReubenBond) pushed a commit to ReubenBond/agent-framework that referenced this pull request Oct 28, 2025
@alliscode@crickman
@TaoChenOSU@ekzhu
Adding draft version of workflows design doc. (microsoft#271)
96fc2ed
* Adding draft version of workflows design doc.
* Adding message flow diagrams and fixing group chat sample.
* Added sequence diagram for fan_in with WhenAny
* Updating workflows design
* clean up
* Clean up request & response contents
* Add more future enhacements
* message_handler -> handler
* remove mention of visual designer
* Minor updates and rename
* Name reformat
---------
Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
Co-authored-by: Tao Chen <taochen@microsoft.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>
AQ-1970 (Arturo-Quiroga-MSFT) pushed a commit to Arturo-Quiroga-MSFT/agent-framework-public that referenced this pull request Nov 23, 2025
@alliscode@crickman
@TaoChenOSU@ekzhu
Adding draft version of workflows design doc. (microsoft#271)
46c7f45
* Adding draft version of workflows design doc.
* Adding message flow diagrams and fixing group chat sample.
* Added sequence diagram for fan_in with WhenAny
* Updating workflows design
* clean up
* Clean up request & response contents
* Add more future enhacements
* message_handler -> handler
* remove mention of visual designer
* Minor updates and rename
* Name reformat
---------
Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
Co-authored-by: Tao Chen <taochen@microsoft.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@eavanvalkenburgEduard van Valkenburg (eavanvalkenburg)eavanvalkenburg left review comments
@moonbox3Evan Mattson (moonbox3)moonbox3 left review comments
Copilot code reviewCopilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@TaoChenOSUTao Chen (TaoChenOSU)TaoChenOSU approved these changes
+2 more reviewers
@lokitothJacob Alber (lokitoth)lokitoth left review comments
@ekzhuEric Zhu (ekzhu)ekzhu approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

@alliscodeBen Thomas (alliscode)

Labels

documentationUsage: [Issues, PRs], Target: documentation in the code base and learn docs

Projects

Agent Framework
Status: Done

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Workflow interface design

8 participants

@alliscode@ekzhu@lokitoth@TaoChenOSU@eavanvalkenburg@moonbox3@crickman