Агент на карточке

Эта страница о том, как агент работает с карточкой: кто её берёт, как отвечать на вопросы и что остаётся на карточке.

Кому достаётся карточка

Карточку берёт тот, на кого она назначена. Поле назначения — обычное поле доски с типом «человек»; в шаблонах оно называется по-разному: «Исполнитель» на доске «Разработка», «Кто делает» на «Личном», «Кто ведёт» в «Контенте».

Заполнять его нужно руками: приложение никого не назначает само. Карточку, назначенную на человека или ни на кого, автоматика не трогает — она просто стоит там, куда её положили.

Агент бывает двух видов, и на карточке они не различаются:

программа на этом компьютере — Claude Code, Codex и другие агенты по ACP;
модель по ключу API — приложение само обращается к Anthropic или OpenAI с вашим ключом. На сервере есть только такие агенты, и папок у них нет («Компьютер и сервер»).

Оба подключаются в «Настройки → ИИ» → «Подключить агента…» («Подключение агентов»). После этого агент есть в поле назначения на любой доске, рядом с людьми: откройте поле и выберите его. Участником доски агент не становится, и добавлять его на доску не нужно.

В списке — все ваши агенты, и только ваши. Доска не держит своего состава; чужих агентов на сервере в списке нет. Единственное, что убирает ваших, — выключатель «Агенты работают с карточками» в «Настройки → ИИ».

Задание агент читает из описания карточки — отдельного поля для задания нет. К описанию добавляется инструкция доски, общая для всех её агентов («Системный промпт доски»), и его собственный промпт («Системный промпт агента» в его настройках).

Что запускает работу

Перенос карточки в другую колонку. Всё, что нужно, чтобы это сработало:

на карточке назначен агент;
агенты включены в настройках.

Больше ничего настраивать не нужно — у колонок нет ни действий, ни состава. Агент получает название колонки, в которую карточку положили, и список остальных колонок доски; что делать, он читает с карточки.

Если карточку вытащили из колонки, пока агент работал, работа отменяется: перенос — это новое указание, а не продолжение старого.

Что агент делает в конце

пишет один комментарий с результатом;
если задача этого требовала, записывает что-то в поля карточки;
сам переносит карточку в колонку, название которой говорит, что случилось: «Готово», «На ревью», «Заблокировано». Если подходящей колонки нет, карточка остаётся на месте;
говорит, что работа закончена, — этим сессия и завершается.

Перенос, который сделал агент, новую работу не запускает.

Если агент закончил, ничего не написав, комментарий напишет приложение — на карточке всегда остаётся след. Если работу оборвали (закрыли приложение, упал CLI), карточка остаётся на месте, а причина написана на ней.

Обсудить с агентом, пока карточки нет

Задачу можно проговорить до того, как она станет карточкой: стрелка у кнопки «Создать» в шапке доски → «Обсудить с агентом…».

Сначала спрашивают, каким агентом и в какой папке — предлагаются папки доски, «черновики доски» и «Добавить папку…»; на сервере папки не спрашивают. Дальше это обычный разговор: вы пишете, агент отвечает, «Остановить» прерывает его ответ. Агент с самого начала знает название доски и её описание — чем понятнее описание, тем меньше ему приходится переспрашивать.

Агент в таком разговоре ничего не меняет в папке — инструкция и политика разрешений держат его на чтении, — а карточки, о которых договорились, он создаёт прямо на этой доске.

Наверху диалога — «Открытые разговоры»: разговор живёт дольше своего окна. «Завершить разговор» останавливает агента и убирает разговор из списка.

Вопросы агента

Агент спрашивает по протоколу: разрешение на инструмент, который ему не выдан, или выбор, который за него не сделать. Вопрос появляется в трёх местах, и ответить можно в любом:

на карточке — янтарный значок в правом нижнем углу, а сам вопрос с кнопками виден, когда карточку открыли;
в уведомлении в углу окна доски;
на телефоне, в разделе «Ждут».

Чей ответ пришёл первым, тот и засчитан; остальные перестают показывать вопрос.

Уведомление можно убрать крестиком «Скрыть» — это значит «я знаю», а не «ответил»: вопрос останется на карточке, пока на него не ответят. Убранное уведомление не возвращается ни в другом окне, ни на телефоне, ни после перезагрузки страницы.

Если приложение свёрнуто, уведомление приходит от системы, а на значке рядом с часами появляется янтарная точка.

Уведомления отключаются в настройках. Значок на карточке и точка рядом с часами остаются в любом случае — уведомление говорит о вопросе, а они о том, что агент всё ещё ждёт.

История: кто что делал с карточкой

В панели инструментов карточки есть кнопка «История». Она открывает справа список того, что с карточкой происходило, новое сверху:

кто её создал;
кто переименовал и во что;
кто менял поле и как: «Статус»: В работе → Готово;
кто написал комментарий — и что именно.

Имена настоящие. У каждого зарегистрированного агента есть учётная запись на доске, и его правки подписаны им, а не вами: по истории видно, что колонку поменял агент, а срок поставили вы.

История есть у любой карточки, даже у той, которую никто не трогал: её создание — тоже запись. Она лежит на самой доске и уезжает вместе с ней в экспорт и на другую машину.

Что видно на карточке

Что сейчас делает агент — в строчке под заголовком карточки; его вопрос — под ней.

Итог работы агента — комментарий. В панели инструментов карточки есть кнопка «Комментарии», она открывает панель справа, а на лице карточки — значок с их числом. Так и на компьютере, и на сервере.

Если работа не смогла начаться — не нашлась папка, папку держит другая карточка, — причина показана на карточке и исчезает, как только по ней снова что-то происходит.