Что получится
Вы поставите агенту одну задачу и заранее поймёте, что произойдёт с комнатой: план с превью, диаграмма сразу, карточки пакетом или упорядочивание выделения.
Когда нужно
Нужно разложить бриф в структуру, превратить текст в схему, собрать карточки из выделения или выровнять стикеры — без ручной работы.
Предусловия
- Агенты включены в организации (администратор: Организация → Агенты) и в комнате (владелец или со-владелец).
- У вас есть активный агент, созданный вами.
- У вас есть право редактирования комнаты.
- Для плана и диаграммы настроен ключ провайдера. Без ключа задача не падает с
AI_NOT_CONFIGURED, а остаётся в очереди и выполнится, когда ключ появится. Карточки модель не вызывают, упорядочивание работает и без ключа. - Для карточек заранее выделите объекты. Упорядочивание запускается из выделения и без него не открывается.
- Файл брифа не обязателен; если он нужен —
.md,.txtили.csvв UTF-8, не больше 100 000 байт.
Шаги
- В организации откройте Агенты и создайте агента. Результат: агент активен.
- В комнате откройте Ещё (⋯) → Задача для AI… и выберите агента.
- Выберите источник: текст задачи, файл или выделение. Блок Источник показывает, сколько объектов и символов уйдёт в модель; Убрать оставляет задачу без текста объектов, Только выделение делает выделение самой задачей.
- Выберите скилл или Авто. По умолчанию стоит Brief to room; «Авто» выбирает скилл по задаче и выделению.
- Опишите результат, приложите файл брифа, если он нужен, и задайте бюджет: изменения и деньги. Токены и время сервер берёт по умолчанию. Деньги можно указать дробно:
0.1— десять центов. - Проверьте раздел Что уйдёт в модель и нажмите Попросить агента.
- Дождитесь статуса, который соответствует скиллу, и откройте результат.
Что произойдёт с комнатой
| Скилл | Что делает | До записи | Отмена |
|---|---|---|---|
| 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 |
| Задача с ошибкой | продолжить задачу нельзя: прочитайте причину и поставьте задачу заново |
Куда дальше
Получить план от агента — самый частый сценарий: структура до записи на комнату.
Агенты: принципал и бюджет — почему задача устроена именно так.