Skip to content

Add OSOP workflow example — agent handoff pattern in portable format#76

Open
Archie0125 wants to merge 2 commits intoopenai:mainfrom
Archie0125:add-osop-example
Open

Add OSOP workflow example — agent handoff pattern in portable format#76
Archie0125 wants to merge 2 commits intoopenai:mainfrom
Archie0125:add-osop-example

Conversation

@Archie0125
Copy link
Copy Markdown

Summary

  • Adds a portable YAML workflow definition (examples/osop/swarm-customer-service.osop.yaml) describing a customer service agent handoff pattern with triage routing to specialist agents
  • Includes a README mapping OSOP concepts to Swarm equivalents (Agent, handoff functions, escalation patterns)
  • 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
examples/osop/README.md Explains OSOP + Swarm integration with concept mapping table
examples/osop/swarm-customer-service.osop.yaml Customer service workflow: triage agent → conditional routing to billing/technical/sales specialists → human escalation fallback

Test Plan

  • Verify YAML is valid: python -c "import yaml; yaml.safe_load(open('examples/osop/swarm-customer-service.osop.yaml'))"
  • Confirm no existing files were modified
  • Review README for accuracy of Swarm concept mappings

Adds a portable YAML workflow definition describing a customer service
agent handoff pattern (triage + specialist agents + human escalation)
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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant