Schema Reference
Complete reference for the OSSA agent manifest schema.
Overview
The OSSA schema defines the structure of agent manifests. Every field serves a specific purpose in the agent lifecycle.
Resource Kinds
OSSA supports multiple resource kinds (v0.3.1+):
- Agent - Single agent definition
- Workflow - Multi-agent composition
- Task - Deterministic task definition
- MessageRouting - Message routing rules
Core Fields
Agent Identification
- agent.id - Unique agent identifier
- agent.name - Human-readable name
- agent.version - Semantic version
- agent.role - Agent role classification
Agent Capabilities
- agent.capabilities - What the agent can do
Workflow Composition
- workflow.spec - Workflow specification
- workflow.steps - Workflow steps
- workflow.triggers - Workflow triggers
Schema Versions
- Current: v0.2.8-RC
- Stable: v0.2.8
- Previous: v0.3.0, v0.3.0
See Versioning Guide for migration information.
Validation
Validate your agent manifests:
ossa validate agent.ossa.yaml
Complete Schema
View the complete JSON Schema: