Vortholm — документация
AI Builder

Ревью существующего типа

Как отправить уже готовый тип задачи на проверку AI и что делать с его правками.

AI Ревью проверяет существующий тип задачи целиком и вносит предложенные правки. Проверку можно запустить без комментария или указать, что требуется изменить.

Используйте ревью, если шаги дают нестабильный результат, промты сформулированы неточно или параметры не совпадают с подстановками в шагах.

Откуда запускается

Кнопка «🔍 AI Ревью» стоит в карточке типа задачи, рядом с «Сохранить». Это основной вход.

Такая же кнопка есть в Тестере: там она называет номер шага, который открыт на экране, и комментарий в ней уже начат с этого шага. Проверяет AI всё равно тип задачи целиком, а не один шаг — портал предупреждает об этом прямо в окне.

Третий вход — в самом билдере: на этапе «Готовая задача» под карточкой есть «AI Ревью». Она запускает проверку сразу, без окна и без комментария.

Запустить с комментарием

Нажмите «🔍 AI Ревью». Откроется окно «AI Ревью TaskType».

Опишите требуемые изменения. Поле можно оставить пустым для автоматического ревью.

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

Нажмите «✨ Улучшить», чтобы AI переписал ваш комментарий, и затем «Запустить ревью».

Если вы написали комментарий сами и не нажали «Улучшить», портал переспросит окном «Вы не улучшили комментарий»: «Рекомендуем нажать «Улучшить» — качество ревью зависит от качества формулировки. Можно запустить и как есть.» Выбор за вами: «Улучшить сейчас» или «Запустить как есть».

Окно «AI Ревью TaskType»: поле для комментария, приложенные файлы и кнопка «Запустить ревью»
Окно «AI Ревью TaskType»: поле для комментария, приложенные файлы и кнопка «Запустить ревью»

Перед самой проверкой AI может задать уточняющие вопросы — они откроются в том же окне. Если вопросы получить не удалось, портал покажет ошибку и кнопку «Продолжить без вопросов»: ревью пойдёт дальше без них.

Пока идёт и когда закончится

В окне появится полоса выполнения и подпись «AI выполняет ревью...». Окно можно закрыть, проверка от этого не остановится.

Когда всё готово, в окне будет «✅ Ревью завершено» и блок «Изменения:» с кратким перечнем правок. Ссылка «Открыть в AI Builder →» ведёт в сессию, где та же работа видна подробно. В списке сессий она называется «Ревью:» и дальше название типа задачи.

Что проверяет AI

Если комментария не было, AI идёт по своему чеклисту:

  • Промпты шагов — конкретны ли инструкции, нет ли расплывчатых формулировок, не переписано ли в промпт то, что и так лежит в базе знаний.
  • Параметры — каждая подстановка в промпте имеет свой параметр, каждый параметр где-то используется, типы полей выбраны по смыслу.
  • Настройки шагов — запас по времени и по числу итераций, разумность разбиения на шаги, выбор модели под требования шага.
  • Что шаг должен записать на выходе.
  • Работа с базой знаний — подключены ли нужные папки и правильно ли они используются.
  • Общая конфигурация типа задачи.
  • Форма результата — для типов, которые выдают документ: сходятся ли обещанные разделы с тем, что собирают шаги, и есть ли проверочный шаг в конце.

Разобрать правки

В сессии билдера появится карточка с блоком «Что изменил AI» — рассказ самого AI о том, что он поменял и почему. Длинный текст свёрнут, «Развернуть» открывает его целиком.

Результат ревью: блок «Что изменил AI» и свёрнутая итоговая конфигурация
Результат ревью: блок «Что изменил AI» и свёрнутая итоговая конфигурация

Если в той же сессии уже была предыдущая версия конфигурации — например, вы запускали ревью второй раз, — вместо этого блока портал покажет «Что изменилось в конфигурации» с числом правок и переключателем: «Разница» — построчное сравнение с предыдущей версией, «Комментарий AI» — тот же рассказ.

Ниже сворачивается «Итоговая конфигурация» — тип задачи целиком после правок.

Если замечаний не нашлось, AI ничего не меняет: тип задачи остаётся ровно таким, каким был, а в карточке не будет ни списка правок, ни новой конфигурации.

Ревью, которое внесло правки, переводит тип задачи обратно в черновик — даже если он был опубликован. Сотрудники перестанут видеть его в каталоге, пока вы не нажмёте «Опубликовать» ещё раз. Проверьте правки и опубликуйте: Готовый тип задачи.

Если что-то пошло не так

«Не найден исходный тип задачи для ревью — начните ревью заново через «AI Ревью» в карточке типа задачи.» Сессия ревью потеряла связь с типом задачи — чаще всего потому, что тип был удалён или ревью запускали из старой вкладки. Откройте карточку типа задачи и нажмите «🔍 AI Ревью» заново.

Правки AI вам не нравятся. Ничего страшного не произошло: до публикации это черновик. Поправьте руками в карточке типа задачи или откатитесь к последней опубликованной версии через «История версий» — см. Готовый тип задачи.

Нужна ещё одна итерация. В сессии билдера рядом с «AI Ревью» есть «Доработать» — там вы пишете, что поменять, своими словами. В сессии, начатой с чистого листа, разницу подсказывает и сам портал: «Доработать — вы пишете комментарий. AI Ревью — AI перепроверяет сам, без вашего участия.» В сессии, открытой из готового типа задачи, этой строки нет.

На этой странице