Examples & Recipes
Examples & Recipes
Practical examples and recipes for building agents with supyagent, from simple assistants to multi-agent systems.
Examples & Recipes
These examples demonstrate real-world patterns for building agents with supyagent. Each example includes complete configuration files, system prompts, and step-by-step explanations.
Examples
| Example | Difficulty | Description |
|---|---|---|
| Code Assistant | Beginner | Build a coding assistant with search-read-edit-test workflow |
| Email Summarizer | Intermediate | Daemon agent that reads Gmail and posts summaries to Slack |
| Research Agent | Intermediate | Web research agent with browser tool and cross-session memory |
| Customer Support | Advanced | Multi-agent system with router and specialist agents |
| Data Pipeline | Intermediate | Execution mode agent for batch data processing |
| Custom Tool | Beginner | Build and deploy a custom API integration tool end-to-end |
Prerequisites
All examples assume you have completed the Quickstart:
pip install supyagent
supyagent init
supyagent config set # Configure your API keyCommon Patterns
These examples share several common patterns:
- Agent YAML configuration -- Every agent is defined in a
agents/*.yamlfile - System prompt engineering -- Clear instructions with structured workflows
- Tool permissions -- Controlling what tools an agent can access via
tools.allowandtools.deny - Model selection -- Choosing the right model and temperature for the task
- Delegation -- Breaking complex tasks across multiple specialized agents
Running Examples
Each example provides a complete agent YAML that you can copy into your agents/ directory:
# Copy the YAML from the example page into agents/
# Then run the agent:
supyagent chat myagent # Interactive
supyagent run myagent "task" # Execution mode
supyagent daemon myagent # Daemon mode