What are Agents?
1min read
TL;DR: Agents are configurable AI assistants in your Ballet workspace. Each agent has instructions, a language model, tools, skills, and optional memory. Use agents in playbook steps or configure them from the Agents page in the sidebar.
Who this is for
Builders creating AI-powered automation components.
What makes up an agent?
| Component | Purpose |
|---|---|
| Instructions | System prompt defining the agent's behavior and expertise |
| Model | Language model (via AI Gateway / Ballet Models) |
| Tools | Callable functions the agent can invoke |
| Skills | Reusable instruction templates applied for specific tasks |
| Memory | Optional context the agent retains across interactions |
How do agents differ from Ask Ballet?
Ask Ballet (Console) is the general-purpose assistant for building and debugging. Agents are specialized assistants you configure for specific domains — for example, a "Support Triage" agent or a "Code Review" agent.
How do I create an agent?
- Open Agents from the sidebar (or ⌘K → Create agent).
- Set instructions, model, tools, and skills.
- Reference the agent in playbook steps or let Ask Ballet use it during Build.
When should I use an agent?
Use agents when a playbook step needs domain-specific AI behavior that differs from the default Console assistant — specialized prompts, specific tools, or persistent memory.