Custom agents
Custom agent — заранее настроенный профиль с собственным системным промптом и набором инструментов, который вы выбираете явно. Чем отличается от субагентов.
Что это
Custom agent — это заранее настроенный профиль агента: свой системный промпт и свой набор доступных инструментов, оформленные файлом. Вместо того чтобы каждый раз объяснять модели «веди себя как ревьюер» или «отвечай только по документации», вы один раз описываете такой профиль и дальше выбираете его явно, когда он нужен.
Технически custom agent в WorkAI — это тот же файл .agent.md, что описан на странице Subagents: одна и та же сущность, но с двумя разными способами использования.
Чем отличается от Subagents
Это частый источник путаницы, потому что механизм один, а сценарии — разные:
- Custom agent — вы сами выбираете профиль в интерфейсе и дальше ведёте диалог с ним напрямую, как с обычным режимом чата.
- Subagent — основной агент делегирует часть работы этому же профилю сам, внутри текущей сессии, без вашего явного выбора; вы видите только итог в свёрнутом блоке.
Файл, который лежит на диске, поддерживает оба сценария одновременно: поле user-invocable в его шапке определяет, можно ли выбрать агента вручную (по умолчанию — можно), а disable-model-invocation — можно ли делегировать ему задачу автоматически. Один и тот же профиль вполне может работать и так, и так.
Формат файла
Файл называется <имя>.agent.md — обычный markdown с YAML-шапкой сверху и текстом системного промпта под ней. В шапке задаются имя агента, описание, набор доступных инструментов и другие поля, определяющие поведение профиля; тело файла — сама инструкция, что агент должен делать.
Полный список полей шапки, правила ограничения инструментов и разбор формата Claude Code — на странице 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/rules
- Переиспользуемые процедуры под конкретную задачу — /docs/skills