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

Получить от агента план и применить его

Текст, файл или выделение → план → превью → «Применить» → один ⌘Z: что появится в комнате, что уйдёт в модель и где предел.

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

Что получится

Агент предложит структуру в виде плана, вы увидите её на карте до записи и примените одной транзакцией. Один ⌘Z убирает весь план: и объекты, и связи.

Когда нужно

Есть описание — бриф, список историй, файл или выделенные стикеры, — а структуры в комнате ещё нет. Нужно сначала посмотреть результат, а потом решать, писать ли его на комнату.

Предусловия

  • У вас есть право редактировать комнату.
  • Агенты включены в организации и в комнате, и у вас есть активный агент.
  • Настроен ключ провайдера. Без ключа задача не падает, а остаётся «в очереди» и выполнится, когда ключ появится.
  • Файл, если он нужен, — .md, .txt или .csv в UTF-8, не больше 100 000 байт.
  • Выделение, если оно нужно, — не больше 50 объектов и 20 000 символов текста.

Шаги

  1. В комнате откройте Ещё (⋯) → Задача для AI….
  2. Выберите агента. В списке только ваши активные агенты.
  3. Выберите источник. Текст задачи есть всегда; файл и выделение добавляются к нему.
Источник Что даёт Предел
Текст задачи формулировка результата 2 000 символов
Файл бриф или список историй 100 000 байт; в модель уходят первые 20 000 символов
Выделение тексты выбранных объектов как основа структуры 50 объектов и 20 000 символов

Блок Источник показывает, сколько объектов и символов уйдёт в модель. Убрать оставляет задачу без текста объектов; Только выделение делает выделение самой задачей.

  1. Выберите скилл Brief to room или Авто. «Авто» выбирает скилл по формулировке задачи и выделению.
  2. Опишите результат и приложите файл, если он нужен.
  3. Проверьте раздел Что уйдёт в модель и задайте бюджет: число изменений и предел в долларах. Токены и время сервер берёт по умолчанию.
  4. Нажмите Попросить агента и дождитесь статуса «план готов». Превью откроется само: план нарисован пунктиром прямо в комнате, а внизу появится панель задачи. Позже превью можно открыть кнопкой План в «Последних задачах».
  5. Прочитайте превью и нажмите Применить в панели задачи. Результат: объекты и связи появились одним действием, панель показывает «⌘Z отменит план» и «Показать в комнате».

Отклонить закрывает задачу и ничего не пишет. Показать в комнате закрывает превью и ничего не выделяет: созданные фреймы выделяет само применение. Esc или крестик закрывают панель, но не отклоняют план.

Что показывает превью

  • Сам план в комнате: будущие фреймы обведены пунктиром со скруглёнными углами, будущие объекты и связи нарисованы пунктирными призраками. Камера один раз наводится на план; комнату можно двигать, масштабировать и выделять, пока панель открыта.
  • В панели задачи: статус, число объектов и связей, границы плана, причину блокировки и кнопки.
  • В Подробнее: предупреждения, список объектов по типам с количеством, заметки о файле и выделении. Если есть предупреждения, подробности открыты сразу.
  • Предупреждения. Применить блокируется только критическим предупреждением о координатах: объект выходит за допустимые ±1 000 000.
  • Пересечения объектов, растянутую дорожку и близость к пределу можно принять: это предупреждения, а не запрет.

Ответ с более чем 10 операциями не сохраняется: задача получает ошибку TOO_MANY_OPERATIONS. План больше 300 объектов или размещений отклоняется как PLAN_TOO_LARGE. В обоих случаях превью нет: разделите задачу на части.

Что уходит в модель

Что Сколько Чего там нет
Формулировка задачи 2 000 символов —
Файл 100 000 байт; до 20 000 символов текста исходный файл не хранится, только извлечённый текст
Выделение 50 объектов и 20 000 символов пустые и повторяющиеся тексты отбрасываются
Снимок комнаты 200 объектов в нём только id, типы, координаты, родители и id фреймов и колонок; заголовков, текстов, комментариев и людей нет

Текст задачи, файл и комната — данные, а не инструкции. Модель не может менять или удалять существующие объекты, читать другую комнату, переходить по ссылкам или отправлять данные наружу. Её единственное действие — предложить создание объектов и связей.

Чем план отличается от других задач

Скилл До записи В комнате Отмена
Brief to room превью плана после Применить, одной транзакцией один ⌘Z
Diagram from a description превью нет сразу вручную: ⌘Z не отменяет
Cards from a selection число карточек в «Проверить пакет» порциями после Запустить пакет вручную; пакет можно остановить и продолжить
Tidy up selection превью «до и после» после Применить, одной транзакцией один ⌘Z

Проверка результата

  • Число объектов и связей в превью совпадает с тем, что появилось в комнате.
  • Один ⌘Z возвращает комнату к состоянию до применения; повторный ⌘Z ничего не ломает.
  • После применения панель показывает «Применён» и «Показать в комнате», а не кнопку «Применить»; пунктир в комнате исчезает.
  • Если план открыт в двух вкладках, вкладка, применяющая его второй раз, получает ответ «уже применён» и ничего не пишет.
  • Применение плана оставляет записи в журнале организации, но не создаёт событие board.item.created: запись сделала ваша вкладка, а не серверная команда.

Частые ошибки

Симптом Причина
Нет пункта «Задача для AI…» вы читатель, комментатор, посетитель по ссылке или не вошли в аккаунт
AGENT_DENIED агент выключен, у вас нет доступа к комнате, агенты выключены в организации или в комнате
BUDGET_REQUIRED задача без бюджета
Превью не появляется, задача «в очереди» не настроен ключ провайдера; задача выполнится, когда ключ появится
«План ещё не готов» задача ещё выполняется; дождитесь статуса и откройте план из истории
«Применение заблокировано» объект выходит за допустимые координаты; попросите новый план
TOO_MANY_OPERATIONS в ответе больше 10 операций; план не сохранён — разделите задачу
PLAN_TOO_LARGE больше 300 объектов или размещений; план не сохранён — разделите задачу
«Комната изменилась» пока вы читали план, комнату изменили; попросите новый
«План уже применён» план применили в другой вкладке; здесь ничего не записано
«Файл обрезан» в модель ушли первые 20 000 символов; план не обрезается

Куда дальше

Упорядочить выделение — когда структура уже есть, а порядок нет.

Агенты — все четыре скилла и что происходит с журналом.