# Custom agents

> Plain-Markdown copy of https://optimisticagency.com/docs/agents. Links are relative to https://optimisticagency.com.

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](/docs/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](/agents). 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.
