Actor YAML Format
An Actor is defined in a single YAML file. The file declares the Actor's identity, the agents it is composed of, and the routes that determine how requests flow through those agents. CleverThis validates this YAML against the Actor Configuration Standard before accepting a deployment.
This page gives a high-level tour of the format. For the full field reference, see the Actor Configuration Standard in the API guide.
Top-level structure
name: my-actor
version: "1.0.0"
agents:
- id: classifier
type: llm
# ...
- id: responder
type: llm
# ...
routes:
entry: classifier
graph:
- from: classifier
to: responder
condition: "true"
The top-level keys are:
| Key | Required | Description |
|---|---|---|
name | yes | Identifier for this actor. Used as the model ID when deployed. |
version | yes | Semver string. |
agents | yes | List of agent node definitions. |
routes | yes | Routing configuration: entry point and graph edges. |
Agent types
Each entry in agents has a type field: llm, router, or tool.
llm— calls a provider model with a configurable system prompt and parameters.router— evaluates a condition or classification to select the next agent.tool— calls an external function or HTTP endpoint and injects the result into the conversation.
Route types
The routes block supports three patterns: stream (pipe output directly to caller), graph (step through a directed graph of agents), and bridge (delegate to another Actor).
The full field-by-field reference with validation rules and examples is in the Actor Configuration Standard.