Maestro docs
Custom agents
Last updated November 7, 2026
A custom agent is a role you define once and use in any chat: its name, its instructions and the tools it may use. You make and edit agents in Agent Studio once you're signed in.
What an agent is
- A name and a role. The name shows in your agent list and in every chat that uses the agent; the role says what it is for.
- Instructions. The prompt that tells the agent how to work: what to check, what to avoid and how to report.
- Snippets. Reusable pieces of instructions that your agents share. Change a snippet once and every agent that uses it gets the change.
- Tools. Which tools the agent may use, from reading files and running commands to the custom tools your panels declare.
Use an agent
Pick the agent for a chat with the chat's agent picker. The model is chosen in the chat, so one agent runs on whichever model you pick.
An example
A "Paper reviewer" for a lab reads drafts the way a journal referee would. Its instructions list what to check and how to write up the report. A snippet holds the lab's style rules, which the lab's other agents use too. Its tools let it read files and open a draft beside the chat.
Make one
Sign in and open Agent Studio. Create an agent, write its instructions, choose its tools and save it; it then appears in your agent picker. This page is a short introduction, and a fuller guide with screenshots is coming.