The template ships a Claude Code prompt atDocumentation Index
Fetch the complete documentation index at: https://docs.agno.com/llms.txt
Use this file to discover all available pages before exploring further.
docs/create-new-agent.md that handles the mechanical parts of adding an agent: creating the file in agents/, registering it in app/main.py, restarting the container, and running a smoke test.
Run the prompt
Open Claude Code in the repo and paste:- What should the agent do? A one-line description. “Summarize GitHub issues for a given repo,” “Triage incoming Slack messages,” etc.
- What tools does it need? Pick from Agno’s 100+ toolkits or describe a custom tool.
- Any specific instructions? Tone, format, escalation rules, anything you’d put in the system prompt.
agents/<your_agent>.py, adds the import and registration to app/main.py, runs docker compose restart, and hits the new agent’s endpoint to confirm it responds.
A simple agent (one toolkit, no custom tools) takes 5–10 minutes. A bespoke agent with custom tools takes longer.
Test in the AgentOS UI
Open os.agno.com, select your new agent in the sidebar, and try realistic prompts. Run it through:- The golden path. What you built it for.
- Edge cases. Unusual inputs, partial information, ambiguous questions.
- Adversarial inputs. Prompt injection, out-of-distribution requests, attempts to make it do something it shouldn’t.
What just happened
| Action | Where it landed |
|---|---|
| Agent definition | agents/<your_agent>.py |
| Registration | app/main.py |
| Endpoint | http://localhost:8000/agents/<your_agent> |
| Sessions and traces from your test runs | Postgres, viewable in the AgentOS UI |