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