Skip to content

Adding draft version of workflows design doc.#271

Merged
TaoChenOSU merged 18 commits intomicrosoft:mainfrom
alliscode:workflows-design
Aug 25, 2025
Merged

Adding draft version of workflows design doc.#271
TaoChenOSU merged 18 commits intomicrosoft:mainfrom
alliscode:workflows-design

Conversation

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

Copilot AI review requested due to automatic review settings July 29, 2025 19:25
@eavanvalkenburg eavanvalkenburg added the documentation Improvements or additions to documentation label Jul 29, 2025
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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 thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
@ekzhu ekzhu added the workflow label Aug 5, 2025
Comment thread docs/design/workflows_updated.md Outdated
Comment thread docs/design/workflows_updated.md Outdated
@TaoChenOSU TaoChenOSU mentioned this pull request Aug 6, 2025
@ekzhu ekzhu linked an issue Aug 11, 2025 that may be closed by this pull request
@TaoChenOSU TaoChenOSU mentioned this pull request Aug 11, 2025
4 tasks
@TaoChenOSU TaoChenOSU added this pull request to the merge queue Aug 25, 2025
Merged via the queue into microsoft:main with commit 32c26c3 Aug 25, 2025
8 checks passed
ReubenBond pushed a commit to ReubenBond/agent-framework that referenced this pull request Oct 28, 2025
* 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>
Arturo-Quiroga-MSFT pushed a commit to Arturo-Quiroga-MSFT/agent-framework-public that referenced this pull request Nov 23, 2025
* 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 free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

Workflow interface design

8 participants