Pick the right starting point
Don’t build AgentOS from scratch. Start from a template that’s closest to what you want to ship.
All four templates ship with Docker Compose, Railway scripts, Slack manifest, JWT setup, and a
.env.production flow. You’re 90% of the way to deploy on day one.
Replace the demo data
Templates ship with synthetic data so the first run works. Replace it with your own:
The goal is a single agent that does one useful thing on real data. Then iterate.
The shipping checklist
Each row maps to a page in this section. Don’t re-read them here; this is the punch list.Iterate from real usage
The first version is wrong about things, and that’s expected. The interesting question is how fast can you find what’s wrong and fix it. The loop:- A user reports a bad answer (Slack, support ticket, your own dogfooding).
- Find the run. Filter
agno_sessionsbyuser_idandcreated_atto narrow it down. The session ID gives you the full thread. - Pull the trace from
agno_tracesandagno_spans. Look at what tools were called, what the model saw, what came back. - Replay it locally. Run the same input through the same agent in a script. Reproduce.
- Patch the prompt, swap the tool, add a learning, fix the knowledge. Re-run.
- Add the case to your eval suite so the regression can’t come back.
- Ship.
Keep the agent learning
The agents that get better over time have feedback loops baked in. The agents that get worse are the ones nobody is watching. Three patterns the templates use: LearningMachine. Agno’s built-in pattern for agents that store discovered facts and retrieve them on the next run. When the agent figures out that therevenue_v2 table replaced revenue last March, it writes that to a learnings table; the next time someone asks a revenue question, that learning is in the prompt. Dash uses this end-to-end. See Learning.
Knowledge updates as a feedback loop. When you find a wrong-answer pattern, add the right answer to knowledge. The user who asked the question gets a fix; every subsequent user gets the right answer the first time. Pal and Scout both lean on this.
Eval-gated deploys. Every deploy runs an eval suite. Regressions block the merge. The eval suite grows with the bugs you find — every postmortem ends with a new eval case. Over time the suite becomes the institutional memory of what your agent should and shouldn’t do.
What’s left
You shipped. The rest is normal product work that AgentOS doesn’t try to solve:
AgentOS gives you the runtime. The product is yours to ship.
See it work end-to-end
Pick the one closest to your product and follow it end-to-end. Then swap the data and ship.