remo · документация
AI EN

Агенты

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

Статус: доступно обновлено 2026-11-02

Что даёт

Агент выполняет задачу в комнате по короткому описанию: строит схему, превращает выделение в карточки, раскладывает выделение ровными колонками или предлагает план структуры. Модель работает на сервере; готовый план применяет ваша вкладка одной транзакцией.

Когда использовать

  • Нужно быстро превратить текст в схему.
  • Нужно разложить выделенные стикеры в карточки канбана.
  • Нужно разложить бриф в структуру и проверить результат до записи.
  • Нужно разложить выделенные стикеры ровными колонками и вернуть всё одним ⌘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.

Подключить интеграцию — как забрать активность агента через события.

Связанные возможности

Принципал и бюджет, делегировать задачу, агент комнаты, доступ, события.