Open Agent Specification, Agent Spec#
Open Agent Specification (Agent Spec) is a portable language for defining agentic systems. It defines building blocks for standalone agents and structured agentic workflows as well as common ways of composing them into multi-agent systems.
A portable, platform-agnostic configuration language for more reliable agents and agentic systems.
Why Agent Spec?
Flexible Agent Spec lets you focus on designing an agentic solution — ranging from single agents to multi-agent systems and tailored structured flows — ensuring a strong fit for your needs.
Reliable & Consistent With Agent Spec, each agent follows an explicit specification, promoting uniform behavior across frameworks and increasing confidence in important workflows.
Extensible Agent Spec is designed to be extensible, allowing developers to define custom components to meet their specific needs. This flexibility lets Agent Spec adapt to a wide range of requirements.
Modular & Reusable Agent Spec’s component-based design lets agents and flows be developed independently, then mixed and matched like building blocks, making reuse and composition into complex assistants faster and simpler.
Portable Across Frameworks Author agents once and run them with any compatible runtime. Agent Spec decouples design from execution, helping deliver more predictable behavior across frameworks.
Evaluation-Ready By defining agents with a standardized representation, Agent Spec is designed to streamline testing and side-by-side comparisons on frameworks that support the specifications.
Agent Spec Positioning
How does Agent Spec fits the modern Agentic Ecosystem
Agent Spec aims to streamline the architecture and design of agentic assistants and workflows, serving as an intermediate representation that abstracts away implementation details of specific agentic frameworks.
While protocols like MCP and A2A standardize tool or resource provisioning as well as inter-agent communication, Agent Spec complements these efforts by enabling standardized configuration of components related to agentic system design and execution in general.
Agent Spec Components
Agents
Agents are LLM-powered assistants that can converse with users, use external tools, and cooperate with other agents, autonomously managing their processes and strategies to flexibly achieve assigned tasks.
Flows
Flows are structured assistants composed of connected nodes that form coherent action sequences. Each node performs a specific function, supporting controllable and efficient execution of business processes and tasks.
Using Agent Spec
PyAgentSpec
PyAgentSpec is an SDK designed to create agents in Python that conform to the Agent Spec spec and generate their configuration as JSON or YAML.
Agent Spec Runtimes
Agent Spec configurations can be executed with Agent Spec-compatible runtimes, such as WayFlow, or with other agentic frameworks, like AutoGen and LangGraph, through adapters.
Quick Start
To install pyagentspec, run:
pip install "pyagentspec==25.4.1"
For a complete list of supported Python versions and platforms, see the installation guide.
Explore the Documentation
How-to Guides
Goal-oriented guides with self-contained code examples to help you complete specific tasks.
API Documentation
Dive deeper into the API documentation to explore the classes, methods, and functions available in the library.
Language specification
Give a look at the latest version of the Agent Spec configuration language specification.