Что даёт
Агент выполняет задачу в комнате по короткому описанию: строит схему, превращает выделение в карточки, раскладывает выделение ровными колонками или предлагает план структуры. Модель работает на сервере; готовый план применяет ваша вкладка одной транзакцией.
Когда использовать
- Нужно быстро превратить текст в схему.
- Нужно разложить выделенные стикеры в карточки канбана.
- Нужно разложить бриф в структуру и проверить результат до записи.
- Нужно разложить выделенные стикеры ровными колонками и вернуть всё одним ⌘Z.
- Нужно повторять одно и то же действие по расписанию.
Как работает
Агент — отдельный принципал, которым владеет человек. Он не имеет собственных прав: задача получает доступ владельца на момент выполнения.
Порядок: администратор организации включает агентов, владелец или со-владелец разрешает их в комнате, вы создаёте агента, ставите задачу с описанием и бюджетом, сервер выполняет её.
У задачи четыре пути записи:
| Скилл | Что делает | Когда появляется в комнате | Отмена |
|---|---|---|---|
| Brief to room | предлагает план структуры | после «Применить» | один ⌘Z |
| Diagram from a description | рисует фигуры и связи | сразу | вручную: ⌘Z не отменяет |
| Cards from a selection | делает карточки из выделения (копирует или переносит) | после «Запустить пакет» | вручную; пакет можно остановить и продолжить |
| Tidy up selection | раскладывает выделение ровными колонками; блоки — фреймы | после «Применить» | один ⌘Z |
План приходит как превью: оно ничего не пишет, применение одной транзакцией создаёт объекты и связи, а один ⌘Z отменяет всё. План с объектом за допустимыми координатами (±1 000 000) применить нельзя; ответ с более чем 10 операциями отклоняется как TOO_MANY_OPERATIONS, а план больше 300 объектов или размещений — как PLAN_TOO_LARGE. В обоих случаях план отклоняется до сохранения, поэтому превью нет.
Карточки идут как change set с прогрессом; его можно остановить и возобновить. Диаграмма пишется сразу, без превью.
Упорядочивание двигает только выделенные объекты: размеры, тексты и связи не меняются, заблокированные объекты остаются на месте с предупреждением. Выбранный фрейм раскладывается внутри себя; вложенных фреймов не появляется. Карточка канбана в выделении не двигается: её место задаёт ячейка, поэтому она остаётся на месте с предупреждением, а план применяется к остальным объектам. Раскладка детерминированная, модель может только назвать блоки — без ключа упорядочивание работает, и предупреждения о модели нет.
Бюджет обязателен: задача без ограничения по действиям или стоимости не создаётся. В диалоге задаются изменения и деньги; токены и время сервер берёт по умолчанию. Без ключа провайдера задача не падает, а остаётся в очереди; карточки модель не вызывают.
Пример
Вход: комната и выделение из восьми стикеров. Действие: задача «преврати выделение в карточки», бюджет 40 действий. Результат: восемь карточек, запись в аудите и событие board.item.created на каждую карточку.
Что можно настроить
Агента (имя, состояние), бюджет задачи, скилл, расписание. Ключи провайдера хранятся в организации или у человека и никогда не возвращаются в интерфейс.
Ограничения
- Агенты выключены по умолчанию; включает администратор организации, а в комнате разрешает владелец или со-владелец.
- Задачу можно поставить только от аккаунта с правом редактирования комнаты.
- Агент не может больше, чем человек, от имени которого он действует.
- План и диаграмма вызывают модель; без ключа такие задачи ждут в очереди. Упорядочивание работает и без модели.
- Пакет карточек создаёт событие
board.item.createdна каждую карточку; применение плана и диаграмма оставляют только записи аудита. - Задачу нельзя продолжить после ошибки: её ставят заново. Продолжить можно только пакет карточек.
- Один план — до 10 операций, 300 объектов и 100 связей; больше 200 объектов превью предупреждает о близости к пределу. Больше 10 операций — отказ
TOO_MANY_OPERATIONS, больше 300 объектов или размещений —PLAN_TOO_LARGE. Упорядочивание принимает до 50 объектов; лимит считается после раскрытия групп и фрейма, а больший набор отклоняется до сохранения плана. - Упорядочивание не двигает карточки канбана: их место задаёт ячейка. Карточка в выделении остаётся на месте с предупреждением, план применяется к остальным объектам.
Ключи провайдера
Ключ — это доступ к бюджету провайдера, а не настройка интерфейса. Заведите отдельный ключ для remo, ограничьте его в кабинете провайдера лимитом расходов и сроком действия; не используйте основной личный ключ и не передавайте ключ коллегам. У каждого человека и организации должен быть свой ключ. В remo секрет хранится в базе в зашифрованном виде, показывается один раз при сохранении и расшифровывается только на время задачи; отозвать его можно в любой момент. Технические меры — в разделе Безопасность.
Практические инструкции
Поставить задачу агенту — общий путь и четыре скилла.
Получить план и применить его — превью, лимиты и что уходит в модель.
Упорядочить выделение — колонки, блоки и один ⌘Z.
Подключить интеграцию — как забрать активность агента через события.
Связанные возможности
Принципал и бюджет, делегировать задачу, агент комнаты, доступ, события.