What Is an Agent?
An agent is a named LLM configuration. It combines:- A model URI that specifies the provider and model to use.
- A system prompt that shapes the model’s behaviour.
- An optional guardrails list that overrides the workflow-level defaults.
agents: key and reused by any number of nodes.
Defining an Agent
Model URI Format
Themodel field uses a provider:model URI:
System Prompts
The system prompt is passed to the model as asystem role message (OpenAI/Ollama) or as the top-level system parameter (Anthropic). Write prompts that are specific and task-focused:
Per-Agent Guardrails
By default, every agent inherits the workflow-levelguardrails: list (or ["injection"] if unset). You can override this per agent:
[]) disables all guardrails for that agent. The agent-level list replaces the workflow-level list rather than merging with it.
Configurable guardrails use the {name, config} form, exactly as at the workflow level:
Multiple Agents in One Workflow
A workflow can define as many agents as needed. Each node binds to exactly one agent:How Agents Receive Input
Each node’s agent receives:- System message — the agent’s
systemprompt. - User message — the first (root) node gets the raw user input; subsequent nodes receive the output of the most recently completed node.
writes field.