## Что это

Custom agent — это заранее настроенный профиль агента: свой системный промпт и свой набор доступных инструментов, оформленные файлом. Вместо того чтобы каждый раз объяснять модели «веди себя как ревьюер» или «отвечай только по документации», вы один раз описываете такой профиль и дальше выбираете его явно, когда он нужен.

Технически custom agent в WorkAI — это тот же файл `.agent.md`, что описан на странице [Subagents](/docs/subagents): одна и та же сущность, но с двумя разными способами использования.

## Чем отличается от Subagents

Это частый источник путаницы, потому что механизм один, а сценарии — разные:

- **Custom agent** — вы сами выбираете профиль в интерфейсе и дальше ведёте диалог с ним напрямую, как с обычным режимом чата.
- **[Subagent](/docs/subagents)** — основной агент делегирует часть работы этому же профилю сам, внутри текущей сессии, без вашего явного выбора; вы видите только итог в свёрнутом блоке.

Файл, который лежит на диске, поддерживает оба сценария одновременно: поле `user-invocable` в его шапке определяет, можно ли выбрать агента вручную (по умолчанию — можно), а `disable-model-invocation` — можно ли делегировать ему задачу автоматически. Один и тот же профиль вполне может работать и так, и так.

## Формат файла

Файл называется `<имя>.agent.md` — обычный markdown с YAML-шапкой сверху и текстом системного промпта под ней. В шапке задаются имя агента, описание, набор доступных инструментов и другие поля, определяющие поведение профиля; тело файла — сама инструкция, что агент должен делать.

Полный список полей шапки, правила ограничения инструментов и разбор формата Claude Code — на странице [Subagents](/docs/subagents#собственные-субагенты): там это описано один раз, чтобы не расходиться в двух местах.

## Где хранятся

| Путь | Область действия |
| :--- | :--- |
| `.github/agents/` | Проект — файл в репозитории, доступен всем, кто открывает эту рабочую область |
| `.claude/agents/` | Проект — совместимость с форматом Claude Code |
| `~/.claude/agents/` | Все проекты текущего пользователя (формат Claude Code) |
| `~/.copilot/agents/` | Все проекты текущего пользователя (формат Copilot) |

## Как использовать

Профиль с `user-invocable: true` (это значение по умолчанию) появляется в переключателе режимов рядом с Agent, Ask и Plan — выбираете его там, и дальше диалог идёт с этим профилем напрямую, с его системным промптом и ограниченным набором инструментов.

Создать файл можно командой `/create-agent` в чате, командой **New Custom Agent…**, либо вручную — по одному из путей выше. Проверить, что агент найден, и включить или выключить его — через команду **Настроить пользовательские агенты…**, она открывает список всех обнаруженных файлов.

## Дальше

- Полный формат файла, поля шапки, ограничение инструментов — [/docs/subagents](/docs/subagents)
- Постоянные инструкции для всего проекта — [/docs/rules](/docs/rules)
- Переиспользуемые процедуры под конкретную задачу — [/docs/skills](/docs/skills)