Skip to content

Add OSOP workflow example — multi-agent debate in portable format#2540

Open
Archie0125 wants to merge 3 commits intoag2ai:mainfrom
Archie0125:add-osop-example
Open

Add OSOP workflow example — multi-agent debate in portable format#2540
Archie0125 wants to merge 3 commits intoag2ai:mainfrom
Archie0125:add-osop-example

Conversation

@Archie0125
Copy link
Copy Markdown

@Archie0125 Archie0125 commented Apr 2, 2026

Summary

  • Adds a portable YAML workflow definition (notebook/osop/multi-agent-debate.osop.yaml) describing a structured multi-agent debate pattern with moderator, pro/con agents, and human judge
  • Includes a README mapping OSOP concepts to AutoGen equivalents (ConversableAgent, UserProxyAgent, initiate_chat() chains, etc.)
  • Additive only — no existing files are modified

What is OSOP?

OSOP (Open Standard for Orchestration Protocols) is a portable YAML format for describing AI agent workflows — think OpenAPI, but for agent orchestration. It lets you document, validate, and visualize multi-agent patterns in a framework-agnostic way.

The .osop.yaml file is self-documenting and human-readable. It works standalone without any OSOP tooling installed.

Files Added

File Description
notebook/osop/README.md Explains OSOP + AutoGen integration with concept mapping table
notebook/osop/multi-agent-debate.osop.yaml Debate workflow: moderator opens → pro/con argue in parallel → rebuttals → synthesis → human judge

Test Plan

  • Verify YAML is valid: python -c "import yaml; yaml.safe_load(open('notebook/osop/multi-agent-debate.osop.yaml'))"
  • Confirm no existing files were modified
  • Review README for accuracy of AutoGen concept mappings

Adds a portable YAML workflow definition describing a structured multi-agent
debate pattern (moderator + pro/con agents + human judge) using the OSOP
open standard. Additive only — no existing files modified.

OSOP (Open Standard for Orchestration Protocols) is a framework-agnostic
format for describing agent workflows, similar to how OpenAPI standardizes
REST API descriptions.
Adds documentation explaining OSOP format and how it maps to AutoGen concepts.
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Apr 2, 2026

CLA assistant check
All committers have signed the CLA.

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Apr 2, 2026
Copy link
Copy Markdown
Member

@Lancetnik Lancetnik left a comment

Choose a reason for hiding this comment

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

Seems like you didn't expose the repos to public: https://github.com/osopcloud/
And now all links are invalid

Image

@Archie0125
Copy link
Copy Markdown
Author

Thanks for the review @Lancetnik! You're right — the links were pointing to the wrong GitHub organization. Fixed in the latest commit — all links now resolve correctly.

Let me know if you have any feedback on the workflow example itself!

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

None yet

Development

Successfully merging this pull request may close these issues.

3 participants