Перейти к основному содержимому

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

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

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

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

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

Холст​

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

Холст конструктора процессов

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

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

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

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

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

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

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

На панели управления в правом верхнем углу находятся основные команды: сохранить, тестировать, опубликовать.

Панель управления конструктора процессов

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

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

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

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

  • Добавлять на холст: просто перетащите блок из боковой панели.

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

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

  • Редактировать: нажмите на блок, чтобы открыть его настройки.

  • Удалять: выберите блок и нажмите , а затем Удалить.

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

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

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

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

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

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

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

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

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

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

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

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

Журнал выполнения​

Если при тестировании процесс выдает ошибку или отвечает слишком долго, его можно проверить. Нажмите в левом нижнем углу холста — на вкладке Выполнение вы увидите записи о работе процесса.

Панель с логами процесса
примечание

Здесь появляются записи только из тестового виджета. Запросы из реальных каналов сюда не попадают — полные системные логи по всем подключениям собираются на соседней вкладке Логи.

На вкладке Выполнение вы можете:

  • Просматривать ход выполнения: в журнале отображается последовательность всех блоков, а также длительность их выполнения. Вы также можете использовать функции Log, чтобы добавлять свои записи в журнал и отслеживать значения переменных.
  • Изучать детали каждого шага: нажмите на блок в журнале, чтобы открыть детали. Справа вы увидите общую информацию о блоке, входящие и исходящие данные, а также ошибки.
  • Быстро находить блоки на холсте: нажмите в правом верхнем углу панели и включите Автофокус на блоке. Теперь при выборе записи в журнале холст будет сам фокусироваться на нужном блоке.

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

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