Обзор конструктора процессов

Конструктор процессов в Agent Platform — это визуальный low-code инструмент, разработанный с фокусом на простоту использования. Благодаря интуитивному drag-and-drop интерфейсу, он не требует глубоких технических знаний. Это делает конструктор доступным даже для менее подготовленных пользователей.

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

После создания проекта AI-приложения вы увидите интерфейс с основными компонентами: холст, список блоков и панель управления.

Компоненты интерфейса

Холст

Холст — это основное рабочее пространство, на котором вы выстраиваете процесс, размещая и соединяя функциональные блоки.

Список блоков

На панели слева находится список функциональных блоков. Блоки — это компоненты вашего процесса, которые принимают, обрабатывают и передают данные между различными частями вашего AI-приложения.

Чтобы развернуть список блоков, нажмите в левом верхнем углу холста.

Основные категории блоков:

• Триггеры: запускают процесс в ответ на определенные события. Вы можете настроить запуск по вебхуку, при получении сообщения ассистентом или с определенной периодичностью (планировщик). Подробнее в разделе Триггеры.
• Агенты: позволяют интегрировать и использовать возможности различных AI-моделей от множества провайдеров, таких как OpenAI, Anthropic, Google и других. Подробнее в разделе Агент.
• Функции: предоставляют функции для обработки данных. Вы можете выбрать из доступных встроенных функций, создать свои собственные или подключить MCP-серверы, которые предоставляют функции нужных сервисов.
• Код и условия: позволяют добавлять пользовательский JavaScript-код и логические условия для сложной обработки данных.

Панель управления

Панель управления в правом верхнем углу позволяет:

• просматривать ошибки;
• управлять версиями;
• тестировать процесс;
• публиковать процесс.

Основные сценарии

Работа с блоками

В конструкторе можно работать как с отдельными блоками, так и с группами блоков.

Отдельные блоки

С блоками можно выполнять следующие действия:

• Добавлять на холст:

  • Перетащите один блок из боковой панели.
  • Перетащите коллекцию функций, если хотите добавить сразу все ее функции на холст.

• Редактировать. Откройте настройки блока одним из способов:

  • Выберите блок и нажмите .
  • Дважды нажмите на блок.
  • Нажмите на блок правой кнопкой мыши и выберите Редактировать.

• Перемещать: перетащите блок в нужное место на холсте.

• Удалять. Используйте один из способов:

  • Выберите блок и нажмите .
  • Выберите блок и нажмите Delete или Backspace.
  • Нажмите на блок правой кнопкой мыши и выберите Удалить.

Группы блоков

Группы блоков помогают быстрее перестраивать процесс: вы можете выделить несколько блоков и выполнить действие сразу со всей группой.

Чтобы выбрать несколько блоков, зажмите Shift и выделите их на холсте.

С группой блоков можно выполнять следующие действия:

• Перемещать: перетащите выделенную группу в нужное место на холсте.

• Удалять. Используйте один из способов:

  • Нажмите Delete или Backspace.
  • Нажмите на выделенную группу правой кнопкой мыши и выберите Удалить.

Связи между блоками

Связи устанавливают порядок выполнения блоков. Чтобы связать блоки между собой, наведите курсор на маленький кружок блока-источника и перетащите линию к кружку блока-приёмника.

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

Чтобы удалить связь, нажмите на нее, а затем Delete или Backspace. Перетаскивать связи между блоками нельзя.

Тестирование процесса

Чтобы протестировать процесс, нажмите Тестировать на панели управления. Откроется окно тестирования, где вы можете ввести сообщение для ассистента и увидеть, как ваш процесс обрабатывает запрос.

Настройка «Отправлять /start»

По умолчанию тестовый виджет не отправляет команду /start автоматически — диалог начинается с пустого экрана. Чтобы виджет автоматически запускал процесс при открытии:

1. Нажмите в заголовке виджета.
2. Включите опцию Отправлять /start при запуске виджета.

Настройка применится при следующем запуске теста: при открытии виджета, по кнопке «Новая сессия» или «Начать тест заново» . Ассистент сразу начнет диалог с приветствия.

к сведению

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

Тестирование вебхука и планировщика

Если в качестве триггера вы использовали вебхук или планировщик:

• Для вебхука: скопируйте URL для запуска триггера из блока Вебхук и вставьте его в адресную строку браузера.
• Для планировщика: укажите ближайшее время в настройках блока Планировщик и дождитесь наступления этого времени.

Как только триггер сработает, рабочий процесс начнет выполняться, и вы увидите результаты в окне тестирования.

Панель выполнения процесса

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

Сохранение и версии

Работа с версиями зависит от того, как хранится ваш проект: внутри платформы или во внешнем Git-репозитории.

предупреждение

Вы можете выбрать способ хранения только при создании проекта. Изменить его позже нельзя.

Внутри платформы

По умолчанию проект хранится внутри платформы.

• Чтобы сохранить текущее состояние проекта, нажмите → Сохранить в правом верхнем углу.

• Чтобы посмотреть список сохраненных версий, нажмите → История версий. Вы можете:

  • сравнить текущее состояние с любой из предыдущих версий;
  • восстановить один или несколько файлов из старой версии.

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

В Git-репозитории

Если вам нужна совместная работа над проектом, прозрачная история изменений или интеграция с CI/CD, подключите его к Git-репозиторию. Git дает прозрачный процесс работы с изменениями: pull и push, историю версий и разрешение конфликтов в специальном редакторе.

Подробнее о работе и настройках смотрите в статье Подключение Git-репозитория.

Публикация процесса

Чтобы сделать процесс доступным для внешнего использования, например в каналах:

1. Сохраните текущую версию процесса:

   1. Нажмите → Сохранить или Commit & push.
   2. Введите описание изменений и подтвердите сохранение.

2. Нажмите Опубликовать.