Рабочие процессы

Рабочие процессы (Workflows) -- это визуальные конвейеры, которые позволяют собрать сложную AI-логику из отдельных блоков без написания кода. Вы соединяете ноды на холсте визуального редактора, настраиваете каждую из них, запускаете процесс и наблюдаете, как данные проходят по цепочке от старта к финишу.

Ключевые понятия

Ноды (узлы)

Нода -- минимальный строительный блок рабочего процесса. Каждая нода выполняет одну операцию: вызов AI-агента, HTTP-запрос, запуск JavaScript-функции, ветвление по условию и т.д.

Платформа предоставляет следующие типы нод:

Тип	Назначение
Старт	Точка входа; задает входные переменные
Агент	Вызов AI-агента с инструментами, памятью и подагентами
LLM	Простой вызов языковой модели без агентного цикла
Сообщение	Вывод текста с подстановкой переменных
Функция	Запуск пользовательской JavaScript-функции
HTTP	Выполнение HTTP-запроса к внешнему API
If/Else	Условное ветвление
For	Цикл while с условием
ForEach	Обработка каждого элемента массива
Подтверждение	Пауза с ожиданием одобрения пользователя
База знаний	Семантический поиск по загруженным документам (RAG)
Модерация	Проверка контента на безопасность (Guardrails)
Изображение	Генерация изображений через OpenAI
MCP	Подключение внешних инструментов через MCP-сервер
Конец	Точка выхода; определяет итоговый результат
Заметка	Визуальный стикер для комментариев (не выполняется)

Связи (edges)

Связи соединяют выход одной ноды со входом другой и определяют порядок выполнения. Некоторые ноды имеют несколько выходов:

• If/Else -- выходы «Если» и «Иначе»
• Guardrails -- выходы «Пройдено» и «Не пройдено»
• Подтверждение -- выходы «Одобрить», «Отклонить» и «Тайм-аут»
• Функция -- выходы «Успех» и «Ошибка»
• For (While) -- выходы «Продолжить» и «Прервать»

Вы можете дать связи текстовое название двойным кликом по ней -- это помогает читать сложные схемы.

Переменные и состояние

Во время выполнения рабочий процесс поддерживает общее состояние (state), в котором хранятся:

• input -- входные данные, переданные при запуске
• lastOutput -- результат последней выполненной ноды
• Именованные переменные -- результат каждой ноды доступен по ее ID

Для ссылки на переменные используется синтаксис {{имя_переменной}}:

{{input}}              -- входные данные
{{lastOutput}}         -- результат предыдущей ноды
{{node_3}}             -- результат ноды с ID node_3
{{input.name}}         -- поле name из входных данных

Версии

Платформа автоматически сохраняет историю версий рабочего процесса (до 10 последних). Вы можете просмотреть список версий на панели инструментов и восстановить любую предыдущую версию.

Типы рабочих процессов

• Pipeline -- стандартный многоузловой рабочий процесс, который вы собираете в визуальном редакторе.
• Single -- автоматически сгенерированный процесс из одного агентского узла. Создается при публикации отдельного агента.

Подробнее

Рабочие процессы можно публиковать для доступа через API.

Жизненный цикл выполнения

1. Queued -- запрос на выполнение поставлен в очередь
2. Running -- процесс выполняется, ноды обрабатываются последовательно согласно связям
3. Completed -- все ноды отработали успешно
4. Failed -- произошла ошибка, которую не удалось обработать
5. Cancelled -- пользователь остановил выполнение вручную

Потоки (Threads)

При запуске процесса можно указать ThreadId. Все запуски с одним ThreadId объединяются в одну сессию -- это позволяет агентам использовать историю диалога между запусками.

Подробнее

Узнайте больше о запуске и тестировании процессов в визуальном редакторе, а также об анализе выполнений через трассировку.

Обработка ошибок

На уровне рабочего процесса можно настроить глобальный обработчик ошибок через меню «Настройки» > «Обработчик ошибок». Система классифицирует ошибки на три категории:

• Повторяемые (retryable) -- таймауты, rate limit, сетевые ошибки. Автоматически повторяются по выбранной стратегии.
• Исправляемые (correctable) -- ошибки валидации, парсинга JSON, формата вывода. Модель получает описание ошибки и пытается исправить ответ.
• Фатальные (fatal) -- ошибки аутентификации, отсутствие ресурса, ошибки конфигурации. Приводят к немедленной остановке.

Конфигурация повторов

Стратегии повторных попыток: exponential (экспоненциальная задержка), fixed (фиксированная задержка), immediate (без задержки). Максимум до 10 повторов на ноду.

Подробнее

Подробное руководство по диагностике проблем, классификации ошибок и настройке повторных попыток смотрите в разделе Отладка выполнений.