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

Поставить задачу агенту

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

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

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

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

Когда нужно

Нужно разложить бриф в структуру, превратить текст в схему, собрать карточки из выделения или выровнять стикеры — без ручной работы.

Предусловия

  • Агенты включены в организации (администратор: Организация → Агенты) и в комнате (владелец или со-владелец).
  • У вас есть активный агент, созданный вами.
  • У вас есть право редактирования комнаты.
  • Для плана и диаграммы настроен ключ провайдера. Без ключа задача не падает с AI_NOT_CONFIGURED, а остаётся в очереди и выполнится, когда ключ появится. Карточки модель не вызывают, упорядочивание работает и без ключа.
  • Для карточек заранее выделите объекты. Упорядочивание запускается из выделения и без него не открывается.
  • Файл брифа не обязателен; если он нужен — .md, .txt или .csv в UTF-8, не больше 100 000 байт.

Шаги

  1. В организации откройте Агенты и создайте агента. Результат: агент активен.
  2. В комнате откройте Ещё (⋯) → Задача для AI… и выберите агента.
  3. Выберите источник: текст задачи, файл или выделение. Блок Источник показывает, сколько объектов и символов уйдёт в модель; Убрать оставляет задачу без текста объектов, Только выделение делает выделение самой задачей.
  4. Выберите скилл или Авто. По умолчанию стоит Brief to room; «Авто» выбирает скилл по задаче и выделению.
  5. Опишите результат, приложите файл брифа, если он нужен, и задайте бюджет: изменения и деньги. Токены и время сервер берёт по умолчанию. Деньги можно указать дробно: 0.1 — десять центов.
  6. Проверьте раздел Что уйдёт в модель и нажмите Попросить агента.
  7. Дождитесь статуса, который соответствует скиллу, и откройте результат.

Что произойдёт с комнатой

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

План и упорядочивание применяются одной транзакцией после Применить. Диаграмма пишется сразу. Карточки идут пакетом с прогрессом и не отменяются одним ⌘Z.

Подробно:

Где смотреть результат

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

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

  • План. Число объектов и связей в превью совпадает с тем, что появилось в комнате; один ⌘Z возвращает комнату к состоянию до применения.
  • Диаграмма. Фигуры и связи стоят в текущем виде; в «Последних задачах» статус «готово»; в сведениях об объекте указан агент и скилл diagram; ⌘Z ничего не убирает.
  • Карточки. Число карточек совпадает с «Проверить пакет»; в «Заданиях на карточки» статус «применено»; карточка в сведениях называет агента и скилл cards.
  • Упорядочивание. Объекты стоят ровными колонками, размеры и тексты прежние, заблокированные объекты не двигались; один ⌘Z возвращает прежние координаты.
  • Журналы. Редактор видит «Последние задачи» и объекты в комнате. Вкладки «Журнал» в организации и «Доказательный журнал» в организации → Агенты видны только ролям «Администратор» и «Безопасность».

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

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

Куда дальше

Получить план от агента — самый частый сценарий: структура до записи на комнату.

Агенты: принципал и бюджет — почему задача устроена именно так.