Vortholm — документация
Типы задач

Форма типа задачи

Карта формы: пять вкладок — «Основное», «Шаги», «Параметры», «База знаний», «Настройки» — и кнопки в шапке, включая «Сохранить» и «Опубликовать».

Форма открывается по названию из реестра или кнопкой «Создать тип задачи». Она содержит общие параметры, шаги, поля запуска, папки базы знаний и настройки.

Вкладка «Основное»: режим приватности, slug, название и описание типа задачи
Вкладка «Основное»: режим приватности, slug, название и описание типа задачи

Шапка

Слева — название типа (у нового типа вместо него написано «Новый тип задачи») и значки под ним:

ЗначокЧто означает
«Черновик»Тип ещё не опубликован: в каталоге сотрудника его нет
«Опубликован v2»Тип опубликован, показан номер текущей версии
«Черновик: есть несохранённые изменения»В форме есть правки, которых ещё нет на портале

Справа — кнопки, тремя группами.

КнопкаЧто делает
«Copy ID»Копирует внутренний номер типа, показывает окно «ID скопирован»
«Копировать»Делает копию типа и открывает её
«Экспорт»Скачивает файл slug.forge-task.json
«Dry-run»Показывает окно «Предпросмотр промта»: что именно уйдёт в работу на выбранном шаге
«Тестировать»Открывает Тестер — «Прогнать тип задачи по шагам в Тестере»
«Опубликовать»Выпускает новую версию для сотрудников
«🔍 AI Ревью»Отдаёт тип на автоматический разбор
«Сохранить»Сохраняет правки формы

Подробнее: Тестер, AI Ревью, Версии и публикация.

«Сохранить» и «Опубликовать» — не одно и то же

«Сохранить» записывает правки. «Опубликовать» показывает их сотрудникам.

Пока тип — «Черновик», сохранение просто обновляет его. У опубликованного типа каждое сохранение выпускает следующую версию, поэтому номер v в шапке растёт сам, без нажатия «Опубликовать». Это ожидаемо: История версий хранит предыдущие состояния, и к ним можно вернуться.

Переход между вкладками правки не теряет, но и не сохраняет. Пока в шапке горит «Черновик: есть несохранённые изменения», изменений на портале нет — уход со страницы их потеряет.

Пять вкладок

Вкладка «Настройки»: видимость и переключатели возможностей
Вкладка «Настройки»: видимость и переключатели возможностей
ВкладкаПро что онаГде подробно
«Основное»Режим приватности и то, как тип выглядит в каталоге: название, описание, иконка, категория, slugниже на этой странице
«Шаги»Из чего состоит работа: последовательность шагов с промтамиШаги
«Параметры»Форма, которую заполнит сотрудник перед запускомПараметры
«База знаний»Папки с документами, доступные задаче во время работыПапки базы знаний
«Настройки»Видимость, файлы, чат и остальные возможности типаниже на этой странице

Вкладка «Шаги» показывается не всегда: если на «Настройках» включён «Чат-онли тип», она исчезает — у такого типа шагов нет вовсе, и в каталоге у него только кнопка «Запустить чат».

Вкладка «Основное»

Первым стоит «Режим приватности LLM». Он задаёт, как поступать с конфиденциальными данными именно у этого типа. «Наследовать» оставляет решение общей настройке или настройке провайдера; остальные варианты полностью отключают проверку, только записывают находки или заменяют их перед отправкой. Настройка типа имеет самый высокий приоритет. Подробности — в разделе «Защита данных».

Ниже — пять полей, которые описывают тип в каталоге.

«Slug (URL-идентификатор)» — строчная латиница, цифры, дефис и подчёркивание, например commercial_proposal. Входит в адрес страницы запуска.

«Название» — то, что сотрудник прочитает на карточке каталога.

«Описание» — текст под названием. Поддерживает разметку Markdown, подсказка в поле так и говорит: «Описание для пользователей (поддерживается Markdown)».

«Иконка (emoji)» — эмодзи, оно же значок карточки в каталоге.

«Категория» — группа каталога. Пустое значение — «— Без категории —», см. Категории.

Slug у существующего типа лучше не трогать. Портал предупредит об этом сам: «Изменение slug повлияет на URL задачи. Существующие задачи продолжат работать, но ссылки на создание задач со старым slug (…) перестанут работать».

Вкладка «Настройки»

Здесь собраны переключатели возможностей типа. Верхний блок — «Видимость», с четырьмя значениями:

ЗначениеКто увидит тип
«Публичная»Все сотрудники
«Только для администратора»Только администраторы
«Ограниченный доступ»Названные люди из списка «Доступ для пользователей:»
«Отключена»Никто; то же состояние, в которое тип попадает при удалении

При «Ограниченном доступе» под списком стоит предупреждение «Никто не выбран — таск никому не виден», пока вы никого не добавили.

Ниже идут переключатели возможностей — каждый со своей короткой пояснительной строкой:

  • «Чат-онли тип» — «Без шагов, только база знаний + чат. В каталоге — только кнопка «Запустить чат»».
  • «Загрузка файлов» — «Позволяет пользователям прикреплять файлы к задаче», вместе с полями «Максимум файлов», «Максимальный размер файла (МБ)» и «Допустимые типы файлов».
  • «Личная библиотека» и «Максимум папок библиотеки».
  • «Сравнение с предыдущими исполнениями».
  • «Подгрузка файлов из других задач».
  • «Доработка результата» и «Максимум доработок».
  • «Транскрипции» и «Максимум транскрипций».
  • «Предварительный аудит».
  • «Разрешить браузерное управление».
  • Блок «Чат (Chat Mode)».

В самом низу — «Какие файлы показывать пользователю?» с тремя вариантами: «Все файлы (по умолчанию)», «Только выбранные типы», «Всё, кроме выбранных типов». Это отбор итоговых файлов: рабочие черновики шагов можно не показывать.

Вкладка «База знаний» у нового типа

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

Порядок сборки нового типа

Заполните «Основное»: slug, название, описание, иконку, категорию.
Нажмите «Сохранить» — тип появится в реестре как «Черновик».
Опишите форму запуска на вкладке «Параметры».
Соберите работу на вкладке «Шаги»: у каждого шага должны быть выбраны провайдер и модель.
Прикрепите папки на вкладке «База знаний».
Проверьте «Настройки»: видимость, файлы, нужные возможности.
Прогоните тип кнопкой «Тестировать».
Нажмите «Опубликовать» — тип появится в каталоге у сотрудников.

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

«Сохранить» ругается на шаг. У каждого шага обязательны и провайдер, и модель. Без них сохранение останавливается: на вкладке «Шаги» сам собой откроется виноватый шаг с красными подписями «Выберите провайдера» или «Выберите модель». Вкладку портал при этом не переключает — нажав «Сохранить» с другой вкладки, вы не увидите ничего; перейдите на «Шаги».

Окно «Параметр «X»: оставьте хотя бы одну опцию и заполните каждую.». На вкладке «Параметры» у списка или набора флажков остались пустые варианты ответа. Заполните их или удалите лишние.

Вкладки «Шаги» нет. Включён «Чат-онли тип» на вкладке «Настройки».

Сотрудники не видят тип, хотя вы его сохранили. Сохранение не публикует. Проверьте значок в шапке: «Черновик» означает, что типа в каталоге нет.

Правки исчезли. Форма ничего не сохраняет сама. Если при уходе со страницы в шапке горело «Черновик: есть несохранённые изменения», правки не записались.

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