What are Agents?
Agents are intelligent orchestrators that coordinate multiple actions to complete complex tasks. Unlike traditional scripts, agents are declarative - you define what they should do through instructions, not imperative code.Agent Parameters
Configure agent behavior with decorator parameters:Parameter Details
Unique identifier for the agent. Use
<verb>_agent naming pattern.Human-readable name displayed in the dashboard and logs.
Description of what the agent does. Shown in dashboard and API docs.
System prompt that defines agent behavior. This is how you tell the agent what to do, which actions to call, and how to handle scenarios. This is the core of your agent - think of it as the agent’s job description.
List of action IDs this agent can use. Agent can only call actions specified here.
LLM model to use for AI-powered agents. Supported models:
gpt-4o-mini(default, fast and cheap)gpt-4o(most capable)gpt-4-turboclaude-3-5-sonnet-20241022claude-3-opus-20240229
Maximum number of actions the agent can call in a single run. Prevents infinite loops.
Building Agents
Minimal Agent
The simplest agent with just instructions:Agent with Actions
An agent that uses actions to get work done:Using Memory
Actions store data in memory, and your agent instructions can reference that data:Using Integrations
Agents can use actions that leverage built-in integrations:Testing Agents
Test your agent locally before deploying:- Agent execution flow
- Actions being called
- Memory operations
- Integration calls (mocked locally)
- Strategy execution
Deployment
Deploy your agent:- API
- CLI
- Python SDK
- Dashboard
Best Practices
Keep agents focused
Keep agents focused
Each agent should have a clear, single purpose.✅ Good: Separate agents for different workflows❌ Bad: One agent doing everything
Use descriptive IDs
Use descriptive IDs
Agent IDs should follow
<verb>_agent pattern and be clear.✅ Goodsupport_agentresearch_agentbooking_agent
agent1my-agenttest
Write clear instructions
Write clear instructions
Your instructions are the core of your agent - make them detailed and specific.
Set appropriate max_steps
Set appropriate max_steps
Prevent runaway execution by setting reasonable limits.
Guide memory usage in instructions
Guide memory usage in instructions
Tell your agent how to use memory in the instructions.
Specify available actions clearly
Specify available actions clearly
Only list actions the agent actually needs.
Limitations
Current limitations:
- Max execution time: 15 minutes per run
- Max steps: Configurable, default 40
- Declarative only: Agents use instructions, not imperative code
- State in memory: All state must be stored in memory
- No async actions: Parallel execution coming soon