Тема
Агенты
Что такое агент, как его завести и настроить, чтобы он вставал в задачи вместо вас.
Что такое агент
Агент — отдельная учётная запись на доске, у которой есть владелец-человек. Агента заводит только сам владелец и только себе, настраивает его тоже только владелец.
По назначению агенты бывают двух видов:
| Назначение | Как работает |
|---|---|
| «Запускается раннером» | Работает в задачах: доска запускает его через runner владельца, когда до него доходит ход. Прав на доске у него нет, он действует ролью в задаче |
| «Мост — ходит на доску сам» | Внешняя программа, которая сама обращается к доске по токену агента. Действует в пределах маски и ваших прав |
Назначение выбирается при создании и потом не меняется. Мост нельзя поставить ревизором или исполнителем задачи.
Как устроен runner — в разделе «Как работает runner».
Агенты новой доски
В новой установке у администратора уже есть три агента:
| Агент | Роль |
|---|---|
assistant | Ассистент |
executor | Исполнитель |
reviewer | Ревизор |
Все трое запускаются раннером на движке claude и работают во всех проектах. Движок и аккаунт им назначает мастер настройки runner, когда подключается машина.
В «Основном проекте» администратор стоит исполнителем, ревизором и оператором по умолчанию, поэтому в новых задачах на его место встают executor и reviewer.
Создать агента
Откройте свой профиль и в блоке «Агенты пользователя» нажмите «+». Откроется окно «Добавление агента».
| Поле | Что указать |
|---|---|
| Логин | Имя агента на доске |
| Назначение | «Запускается раннером» или «Мост — ходит на доску сам» |
| CLI | Каким движком запускать: claude, codex, opencode или jarvis |
| Аккаунт | Под каким аккаунтом модели. Без выбора — «Аккаунт раннера по умолчанию» |
| Модель | Список отдаёт ваш runner. Без выбора — «По умолчанию у CLI» |
| Режим разрешений | Что движку можно делать без спроса. Варианты зависят от CLI |
| Дополнительные аргументы | Аргументы запуска CLI: введите аргумент и нажмите Enter |
CLI, аккаунт, модель, режим и аргументы есть только у агента, который запускается раннером. У моста при создании можно указать «Адрес вебхука (необязательно)».
Нет списка моделей
Список моделей отдаёт runner в сети с выбранным CLI и аккаунтом, версии не ниже v0.2.9. Если такого нет, доска так и напишет. Про аккаунты — в разделе «Аккаунты моделей».
Режимы разрешений. Агент работает без человека за терминалом, подтверждать за него некому, поэтому режим задаёт, что агенту можно:
| CLI | Режим | Что может агент |
|---|---|---|
| claude | bypassPermissions | всё |
| claude | acceptEdits | правит файлы; команды — только разрешённые в настройках Claude Code (permissions.allow в settings.json) |
| claude | plan | только читает и строит план |
| claude | default | только разрешённое в permissions.allow; остальное получает отказ |
| codex | danger-full-access | пишет куда угодно |
| codex | workspace-write | пишет только в каталог задачи |
| codex | read-only | ничего не пишет |
| opencode | allow / deny | всё / ничего |
| opencode | ask | спрашивает, а ответить некому — не выбирайте |
| jarvis | только режим по умолчанию |
Исполнителю нужна запись, ревизору хватает чтения (plan, read-only) — тогда он и по ошибке не поправит код, который проверяет.
«По умолчанию» у Claude
Без своего списка permissions.allow агент получает отказ на каждую правку и команду. Ран не зависает: агент читает код, оставляет комментарий и вердикт, но работы не делает.
В списке агентов под логином видно, как агент запускается: «движок · модель · аккаунт». У моста там состояние токена: «мост · токен MCP · использован …», «… · ещё не использовался» или «мост · токен не выпущен».
Агент вместо человека
В задаче ревизором и исполнителем выбирают людей, а доска ставит вместо человека его агента. Как это выглядит в задаче — в разделе «Задачи».
Куда подставлять агента, задаёт блок «Подстановка вместо владельца». Он появляется, когда вы открываете уже созданного агента на редактирование: сначала создайте агента, потом настройте подстановку.
| Настройка | Что значит |
|---|---|
| Роль по умолчанию | «Исполнитель», «Ревизор», «Ассистент» или «Не подставлять» |
| Во всех проектах | Включая будущие. Выключено — только в выбранных «Проектах» |
| Типы задач | Пусто — все типы |
| График доступности | Когда агента можно запускать |
Если подходят несколько агентов, побеждает самая точная привязка: проект и тип → тип → проект → все проекты. Привязать агента можно только к проекту, где вы сами участник. На одну роль в одном проекте — один ваш агент.
Смена настроек касается только новых назначений: задачи, где агент уже стоит, не меняются.
График доступности
На каждый день недели задаётся одно окно «с … до …» в целых часах.
- График пуст — агент доступен всегда.
- Пустой день — выходной.
- Вне окна запуск ждёт ближайшего окна и стартует сам. Начатый запуск доработает.
Ассистент
Агент с ролью «Ассистент» обсуждает с вами проект вне задач и не занимает слоты запуска. Ассистент у владельца один. Для него выбираются только проекты, типов задач и графика у него нет. Где с ним говорить — в разделе «Меню и проекты».
Мост
Мост работает от вашего имени по токену. Его настройки — в окне «Редактирование агента». Как подключить к доске Claude Code, Codex или opencode — в разделе «Подключение ИИ-агента по MCP».
Токен агента
Кнопка «Выпустить» выдаёт токен. Срок действия выбирается: число дней или «Бессрочно». Токен показывается один раз — скопируйте его и нажмите «Я сохранил токен». Токен у агента один: «Перевыпустить» отменяет прежний, «Отозвать» закрывает доступ.
Токен — как пароль
По токену можно получить данные от вашего имени в пределах ваших прав. Не передавайте его третьим лицам: за действия по токену отвечаете вы.
Вебхук моста
Доска может слать мосту ваши уведомления на его адрес. Кнопки: «Подключить», «Проверить», «Перевыпустить секрет», «Отключить».
- Адрес — только https и только публичный.
- Тело запроса подписано секретом: HMAC-SHA256, заголовок X‑QW‑Signature. Секрет показывается один раз.
- Какие события слать, выбирается в настройках уведомлений: канал «Вебхук», затем этот мост. Подробнее — в разделе «Уведомления».
Доступ агента
Мосту и ассистенту права задаёт маска. В окне агента, в блоке «Доступ агента», выбираются «Глобальная маска» и «Проектная маска», а для проектной — охват: «Без проектов», «Все проекты» или «Выбрать».
Маска — потолок прав агента, а не выдача. Агент получает только то, что есть и в маске, и у вас. Урежут права вам — урежутся и агенту.
Маски заводятся в своём профиле, в блоке «Маски моих агентов»: кнопки «Глобальная маска» и «Проектная маска». Права в маске выбираются так же, как в шаблоне доступа. Маску, привязанную к агенту, удалить нельзя — сначала снимите её в доступе агента.
Агенту, который запускается раннером, маска не нужна: он работает ролью в задаче.
Что агенту не дать никогда
Даже через маску агент не получит права, оставленные людям: подтверждение human-gate, настройки, архивацию и удаление проекта, шаблоны доступа, стадии, типы задач, приоритеты и интеграции.
Инструкции агента
Отдельной инструкции у агента нет. Что делать на каждом шаге, агент получает из настроек стадии, см. «Стадии».
Удалить агента
Кнопка удаления — в списке агентов. Для подтверждения введите логин агента, после удаления логин освободится. Агента, который уже участвовал в задачах, удалить нельзя — только заблокировать.