> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nemu.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom agents

> Save an agent with its own prompt, tools, model and steps

A custom agent is a reusable worker you define once and call by name. It has its
own system prompt, its own tool list, optionally its own model, and optionally a
pipeline of steps.

Manage them at **Agents** in the sidebar, or with `/agents`.

## What you configure

| Field         | Notes                                      |
| ------------- | ------------------------------------------ |
| Name          | Up to 64 characters, unique to you         |
| Description   | Up to 280 characters                       |
| Icon          | Shown in the picker                        |
| System prompt | Up to 20,000 characters                    |
| Tools         | Which capabilities it may use              |
| Connectors    | Which of your connectors it may reach      |
| Model         | A specific model, or inherit from the chat |
| Effort        | Reasoning effort for its own runs          |
| Steps         | An optional ordered pipeline               |

The tools you can grant are web search, fetching a URL, searching your indexed
sites, creating artifacts, generating PDFs, using connectors, and using
integrations.

## Steps

An agent can run as a pipeline rather than a single pass. Each step has its own
prompt, model and tools, and is either a **generate** step that produces
something or a **validate** step that judges it.

A validate step returns a pass or fail with a reason, and you choose what
happens on failure: stop, continue anyway, or retry up to five times.

Twelve steps maximum.

## Using one

Attach an agent to a chat from the composer and the assistant prefers it for
matching work. Or let the assistant pick: it sees your saved agents and their
descriptions and calls the one that fits.

A good description matters more than a good name here, because the description
is what the assistant reads when deciding.

## Limits

| Free | Starter | Pro | Max | Enterprise |
| ---: | ------: | --: | --: | ---------: |
|    3 |      10 |  30 | 100 |        100 |