Skip to main content
Next we’re going to create a new agent using Claude Code. A great side-effect of having a unified platform is that coding agents can manage it end-to-end. The codebase comes with five prompts that cover the full ADLC. Let’s try docs/create-new-agent.md

​
Run the prompt

Open Claude Code in your agent-platform directory and paste: 
Run docs/create-new-agent.md
Claude will ask a few questions and build your agent out. Once the spec is locked in, Claude generates agents/<slug>.py, registers it in app/main.py, adds three starter prompts to app/config.yaml, restarts the container, and hits the new endpoint with cURL. It reads the container logs to confirm the right tools fired.

​
Test your agents on the AgentOS UI

Open os.agno.com, select your new agent in the sidebar, and try a few prompts:
  • The golden path. What you built the agent for.
  • Edge cases. Unusual inputs, ambiguous questions, partial information.
  • Adversarial inputs. Prompt injection, out-of-scope requests, attempts to make it do something it shouldn’t.

​
Summary

Congrats on creating a new agent. Here are the details if you’re looking to do this manually:
  • Create a file in agents/<slug>.py.
  • Register the agent in app/main.py.
  • Add quick-start prompts in app/config.yaml.

​
Next

Improve the agent →