Когда нужно
Нужно быстро превратить текст в схему или разложить выделение в карточки, не делая это вручную.
Предусловия
- Агенты включены в организации: это делает администратор.
- У вас есть право редактирования на доске.
- Настроен ключ провайдера: иначе задача завершится ошибкой
AI_NOT_CONFIGURED. - Для скилла карточки заранее выделите объекты: без выделения задача не создаст карточки.
- Одна задача обрабатывает до 500 объектов порциями по 50.
Шаги
- В организации откройте Агенты и создайте агента. Результат: агент активен.
- На доске откройте AI-агенты и выберите агента.
- Поставьте задачу: выберите скилл Схема по описанию или Карточки из выделения, опишите результат и задайте бюджет. Результат: задача в очереди.
- Дождитесь выполнения. Результат: статус «готово», на доске появились объекты.
- Если задача большая, откройте change set: видно прогресс, можно остановить и возобновить.
- Для скилла Схема проверьте журнал: строка с задачей, токенами и стоимостью. Скилл Карточки работает без модели и в журнал не пишет; его след — аудит записи агента.
Проверка
- Объекты на доске соответствуют описанию.
- Для скилла Схема в журнале есть запись о задаче, и цепочка проверяется.
- Для скилла Карточки в аудите есть запись о записи агента.
- Если у доски настроен вебхук, пришло событие о созданных объектах.
Частые ошибки
| Симптом | Причина |
|---|---|
AGENT_DENIED |
у владельца нет прав, агенты выключены или скилл не разрешён |
BUDGET_REQUIRED |
задача без бюджета |
| Задача висит в очереди | исчерпан лимит одновременных задач |
| Карточки не создаются | не выделены объекты или их больше 500 |
Куда дальше
Агенты: принципал и бюджет — почему задача устроена именно так.