Spec / 004-01 · pattern 01 of 06
Single Agent
A single-agent architecture is the default. One controller calls tools, keeps state, and returns an output. It is easier to observe than a swarm, and it is enough for many jobs.
Input → agent → tools → output
Station 01 of 04 · Input
task
- intake
- agent
- tool
- output
- packet on the wire
intake
Input
The request.
Task.
Shape
The type is the contract. If you cannot write it, you do not have this pattern yet.
type SingleAgent = {
controller: Agent;
tools: Tool[];
output: Artifact;
};When to use it
Use when one role and a few tools can finish the task without specialist handoffs.
Not this
Not a multi-agent system. Extra names on the same chat are still this pattern.
Risks
- 01
The agent may try to do too many jobs.
- 02
State can still hide inside a long prompt.
Agents that use this pattern
199 agents · page 1 of 9
Showing 1–24 of 199
…