Как опубликовать ИИ-Агента в НейроЧат (единый интерфейс)

Что такое чат в Нейро42 и как он работает

Чат в Нейро42 — это универсальный пользовательский интерфейс, через который:

• выбираются доступные агенты,
• отправляются текстовые сообщения,
• прикрепляются файлы,
• получаются ответы от агента.

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

Так, например, с точки зрения клиента, когда нет системы, куда встраивается Агент, а мессенджеры неудобны, НейроЧат может быть эффективным решением, где клиент будет делать запрос и получать ответ Агента. 

Фактически, чат — это фронтенд-слой, а ваш воркфлоу — это бэкенд-логика.

Связующим звеном между ними выступает Чат Триггер (Chat Trigger).

Архитектурно процесс выглядит так:

Пользователь → НейроЧат → Чат Триггер → Воркфлоу → ИИ-Агент → Чат-модель → Ответ → Чат

Публикация агента — это процесс подключения вашего воркфлоу к этому интерфейсу.

 

Пошаговая инструкция публикации

Чтобы опубликовать агента и сделать его доступным в НейроЧате, в нем должен быть ряд обязательных элементов и настроек вне зависимости от сложности вашего решения. Поэтому на примере самого базового Агента давайте рассмотрим необходимые шаги:

1. Создайте воркфлоу

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

2. Добавьте триггер

В созданном воркфлоу добавьте триггер «Получение сообщения в чате» (When chat message received).

Этот триггер:

• принимает сообщение пользователя,
• принимает вложения,
• передает данные в воркфлоу,
• формирует точку входа для чата.

Без него агент не сможет взаимодействовать с НейроЧатом.

 

3. Настройте триггер

Настройте параметры в триггере следующим образом:

Сделать чат общедоступным (Make Chat Publicly Available) — включен
(делает endpoint доступным для Нейро42)

Аутентификация (Authentication) — Отсутствует (None)
(авторизация будет управляться со стороны Нейро42)

Режим ответа (Response Mode) —

• Когда завершится последний узел (When Last Node Finishes) — для обычного режима
• Потоковая передача (Streaming) — если агент поддерживает потоковую генерацию

*Если вам нужен режим ответа Use Responces Node, в самом конце инструкции есть информация о настройке.

*Что такое Потоковая передача (Streaming) и когда ее использовать

Streaming позволяет получать ответ модели по мере генерации, а не ждать завершения всего ответа.

Вместо одного полного ответа API возвращает поток частичных токенов, которые можно сразу отображать пользователю или обрабатывать в реальном времени.

Когда использовать Streaming

Streaming полезен в следующих случаях:

1. Чат-интерфейсы

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

2. Длинные ответы

Если модель генерирует длинный текст (например, анализ, код или подробное объяснение), streaming снижает perceived latency — пользователь начинает видеть ответ раньше.

3. Real-time интерфейсы

Streaming хорошо подходит для:

• AI ассистентов
  
• copilots
  
• live-аналитики
  
• генерации кода
  

4. Pipeline-обработка

Иногда токены можно обрабатывать по мере генерации, например:

• парсить JSON постепенно
  
• извлекать ключевые данные
  
• запускать downstream-процессы
  

Когда Streaming не нужен

Streaming не всегда является лучшим вариантом.

Не используйте его если:

1. Нужен только финальный JSON

Например:

• structured output
  
• tool calling
  
• строгое JSON API
  

В этих случаях проще дождаться полного ответа.

2. Простые короткие ответы

Если ответ модели короткий (1–2 предложения), streaming не даёт заметных преимуществ.

3. Batch-обработка

При backend-обработке большого количества запросов (batch jobs, pipelines) streaming обычно усложняет архитектуру без реальной пользы.

4. Когда требуется атомарный результат

Например:

• генерация конфигураций
  
• формирование SQL
  
• ответы API
  

В этих случаях важно получить полностью сформированный результат.

 

Важно: Если потоковая передача полезна, то ее нужно включать:

• в триггере (Режим ответа = Потоковая передача (Response Mode = Streaming)),
• в ноде ИИ-агента (Включить Потоковую передачу (Enable Streaming)),
• в настройках публикации агента в Нейро42.

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

 

4. Подключите ноду ИИ-агента

Следующей нодой добавьте ИИ-агента.

В настройках укажите:

• Источник запроса (сообщение пользователя) → Подключенный узел запуска чата (Source for Prompt (User Message) → Connected Chat Trigger Node)

Это означает, что входное сообщение пользователя будет передано в промпт агента.

Обратите внимание: если вы создаете агента, который поддерживает стриминговый режим, вам необходимо включить опцию Включить Потоковую передачу (Enable Streaming).

 

5. Подключите ноду чат-модели

Далее следует добавить ноду чат-модели, которая будет обрабатывать входящие сообщения и формулировать ответы (например, ноду ОпенИИ (OpenAI)).

В ходе ее настройки:

• Подключите свои учетные данные. Узнать, как получить АПИ (API) ключ к встроенным ИИ моделям можно в Гиде. 
• Выберите модель из списка.

На этом этапе у вас уже есть базовый чат-агент.

 

6. Опубликуйте воркфлоу

Данных настроек достаточно для публикации самого простого агента. Поэтому после выполнения настройки:

1. Протестируйте выполнение.
2. Убедитесь, что агент отвечает.
3. Опубликуйте воркфлоу.

7. Скопируйте URL вашего чата

После публикации зайдите еще раз в Чат-Триггер и скопируйте ЮРЛ (URL), который будет отображаться в соответствующем разделе.

Этот ЮРЛ (URL) понадобится вам для подключения и отображения агента в НейроЧате.

8. Создайте агента в НейроЧат

После этого перейдите в личный кабинет Нейро42, в раздел «Разработка агентов».

Сейчас нужна вкладка «Публикация агента в НейроЧат».

Нажмите кнопку «Создать агента».

Заполните поля:

Название

Идентификатор (как и название, это уникально значение нужно придумать самому)

Описание

Вставьте ранее скопированный ЮРЛ (URL)

Также необходимо:

• включить настройку «Доступен в чате Нейро42»;
• включить или выключить Стриминг — в зависимости от того, поддерживает ли его ваш агент. Пожалуйста обратите внимание, что если режимы Потоковой передачи не совпадут, возможна некорректная работа.

После сохранения агент появится на странице списка агентов.

9. Разверните агента 

Развертывание определяет, кто сможет пользоваться агентом.

Варианты:

1. Развернуть только для себя

Агент будет доступен только вашему аккаунту.

Используется для:

• тестирования,
• внутренней отладки,
• пилотных сценариев.

2. Развернуть для организации

Агент станет доступен всем пользователям вашей организации.

Что такое «пользователь организации»?

В Нейро42 есть вкладка «Пользователи», где можно:

• добавлять сотрудников,
• назначать им роли,
• управлять доступами.

Если агент развернут для организации:

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

Это удобно для:

• корпоративных ассистентов,
• бухгалтерских агентов,
• HR-ботов,
• внутренних AI-инструментов.

 

Готово. После развертывания агент становится доступен для использования в интерфейсе чата.

Пользователь:

1. Открывает новый чат.
2. Выбирает нужного агента.
3. Отправляет сообщение.
4. Получает ответ (обычный или потоковый).

 

Частые ошибки

1. Включена Потоковая передача (Streaming) в агенте, но не в триггере.
2. Несовпадение режима Потоковая передача (Streaming) между воркфлоу и НейроЧатом.
3. Не опубликован воркфлоу.
4. Не выполнено развертывание после создания агента.

 

Use Responces Node

В настройках вы можете увидеть также еще один режим работы Use Responces Node, однако, в текущей версии платформы режим Use Responses Node для Чат Триггера не поддерживается и находится в разработке. Подключение workflow к внешнему чату возможно только в двух режимах, как было описано выше (Когда завершится последний узел (When Last Node Finishes), Потоковая передача (Streaming)).

Как вернуть ответ без Responses Node (Альтернатива Responses Node)

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

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

Как выглядит пример вашего рабочего процесса с нодой Respond to Chat:

Как выглядит рекомендуемый нами вариант:

Поскольку Edit Fields является последней нодой в ветке, система интерпретирует её результат как финальный ответ и отправляет его в чат.

Важно учитывать

1. Ответ будет отправлен только если нода является последней в ветке.
2. После Edit Fields не должно быть других нод, иначе ответ в чат будет сформирован позже.
3. В ноде необходимо явно сформировать поле, которое используется системой как текст ответа.