№1. Как создать ИИ-Агента с нуля

Гайд для начинающих креаторов

Создайте своего первого ИИ-агента в Нейро42 за 30 минут

Даже если вы никогда не программировали

 

Введение

Привет! Это пошаговая инструкция по созданию вашего первого ИИ-агента в Нейро42.

Что мы будем делать:

В ходе этой инструкции мы создадим простого ИИ-агента, который позволит общаться с нейросетью через НейроЧат. Вы пишете сообщение агенту — он отправляет его в нейросеть — и присылает вам ответ.

Что вы найдете в этой инструкции

  • Как создать инстанс в Нейрокоре
  • Как опубликовать агента в НейроЧат
  • Как получить АПИ (API) ключ
  • Как собрать и запустить агента

Даже если вы вообще не разбираетесь в автоматизации — не переживайте. После этой инструкции вы поймете основы и сможете создавать своих первых ИИ-агентов.

 

Что такое Нейро42?

Нейро42 — это платформа для автоматизации рабочих задач. Она представляет собой инструмент с минимальным кодом. Что это значит? Это значит, что для создания рабочих процессов вам не нужно программирование. Совсем. Вы просто перетаскиваете блоки мышкой и соединяете их между собой — как в конструкторе или в игре.

По сути, вы реально программируете, но только через визуальный интерфейс. Все выглядит максимально просто и удобно. А если вдруг вам не хватит стандартного функционала — можно подключить код, но на начальных этапах это точно не понадобится.


Ключевые понятия (чтобы не было путаницы)

Термин Что это такое простыми словами
Воркфлоу (Workflow) Рабочий процесс. По сути — это набор инструкций, которые Нейро42 выполняет для автоматизации задач. Можете дать ему любое название.
Нода = узел Отдельный блок, который выполняет одно действие. Это вот такие штучки-кубики на рабочей области. Каждый кубик = одна нода.
Триггер То, что запускает рабочий процесс. Например: пришло сообщение в НейроЧат — сработал триггер — запустился процесс.
Учетные данные (Credentials) Данные для подключения к сервисам: токены, АПИ (API) ключи, пароли. Это как «пропуск» для доступа к ОпенАИ (OpenAI) и другим сервисам.
Выполнение = запуск Каждый запуск рабочего процесса. Если что-то сломается — можно посмотреть историю выполнений и найти, где возникла ошибка.

 

💡 Главное: 

Не пугайтесь терминов! По ходу гайда вы увидите всё это на практике, и станет понятно. Сейчас просто запомните: нода = кубик, воркфлоу = цепочка кубиков, триггер = кнопка «старт».

 

 

Что вам понадобится

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

Что нужно Зачем и как получить
Аккаунт в Нейро42 Платформа, где будет жить ваш агент. Регистрация бесплатная, есть пробный период.
НейроЧат Встроенный интерфейс платформы Нейро42, через который будет работать агент. Доступен из личного кабинета.
ИИ-сервис  Нейро42 предоставляет встроенные ЛЛМ (LLM), поэтому тут все будет просто
30 минут времени Не торопитесь, делайте по шагам.

Создание инстанса в Нейрокоре

Инстанс — это ваше личное рабочее пространство. Можете думать о нём как о «комнате», где живут все ваши агенты и автоматизации.

Шаг 1. Откройте сайт и зарегистрируйтесь

Перейдите на сайт Нейро42 (ссылку вам дали при регистрации или она есть в приглашении).

Нажмите «Начать бесплатно» или «Регистрация».

Укажите емаил, телефон, придумайте пароль, подтвердите почту — стандартная процедура.

 

Шаг 2. Создайте новый инстанс

Выберите на данном шаге “Создавать агентов”.

Если вы решили выбрать на шаге ранее “Использовать готовые решения”, вам нужно перейти в раздел “Разработка агентов”

После входа вы попадёте в личный кабинет на создание инстанса.

Придумайте название (например, «myfirstagent») и нажмите на кнопку «Создать инстанс».

Подождите 1-2 минуты — система разворачивает ваше рабочее пространство.

Шаг 3. Создайте АПИ (API) ключ

В Нейро42 у вас есть возможность, как использовать любые сторонние ЛЛМ (LLM), включая развернутые в вашем локальном контуре, так и генерировать ключи к ЛЛМ (LLM), развернутым на российских серверах прямо из платформы (лимиты включены в каждый тариф). Для вашего первого кейса давайте воспользуемся именно этим самым простым и удобным вариантом.

После создания инстанса кликните на кнопку «Создать АПИ (API) ключ».

Кстати, развернув вкладки «Модели и типы» и «Использование АПИ (API) ключей (LLM)» вы можете получить более подробную информацию обо всех ЛЛМ (LLM), к которым можно подключиться. Важно! для каждой ЛЛМ (LLM) не нужно создавать отдельный ключ — доступ ко всем единый.

Для создания ключа нужно сделать всего 3 простых действия:

  1. Дать название на латинице 
  2. Сделать небольшое описание
  3. Определить время действия данного ключа (важно для безопасности данных)

Как только с этим определились, кликайте на «Создать»

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

Пожалуйста обратите внимание, что скопировать созданный ключ можно только 1 раз!

 

💡 Отлично! Теперь у вас есть АПИ (API) ключ к ЛЛМ (LLM)

Совсем скоро он нам понадобится

 

Шаг 4. Откройте инстанс

Когда инстанс готов, появится кнопка «Открыть инстанс».

Нажмите на неё — вы попадете в интерфейс Нейро42.

✅ Готово! 

У вас есть рабочее пространство. Теперь давайте разберёмся с интерфейсом — это важно понять перед созданием агента.

 

 

Знакомство с интерфейсом Нейро42

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

Главные элементы

  1. Рабочая область (Canvas) — это центральная часть экрана, большое пустое пространство. Сюда вы будете перетаскивать ноды (кубики) и соединять их линиями. Это ваш «холст» для рисования автоматизаций.
  2. Кнопка «+» — нажмите её, чтобы добавить новую ноду. Откроется поиск, где можно найти нужный блок по названию.
  3. Боковое меню слева — здесь список ваших воркфлоу (рабочих процессов). Можно создавать новые, переключаться между существующими.
  4. Кнопка «Выполнить воркфлоу» — запускает ваш рабочий процесс для тестирования. Очень важная кнопка — будем часто её нажимать.
  5. Переключатель «Опубликовать» — когда вы готовы запустить агента в постоянную работу (24/7), нужно включить этот переключатель.

Как работают ноды

Каждая нода — это отдельный кубик, который делает что-то одно. Вы соединяете их в цепочку, и данные «текут» от одной ноды к другой. Это как конвейер на заводе: первый станок что-то делает, передаёт детальку следующему, тот обрабатывает и передаёт дальше.

Для нашего агента понадобятся три ноды:

  • Чат Триггер (When chat message received) — получает входящие сообщения из НейроЧата (это наш триггер, точка старта)
  • ИИ Агент — выполняет все вычисления и задачи
  • Опен ИИ (ОpenAI) — отправляет сообщение в ИИ и получает умный ответ
  • Ответ возвращается автоматически через Чат Триггер — отдельная нода отправки не нужна

 

💡 Важно понять: 

Триггеры — это специальные ноды, которые ЗАПУСКАЮТ процесс. Они стоят в самом начале. Без триггера ваш воркфлоу не будет знать, когда ему работать.

 

 

Подготовительный этап

Настройка Чат Триггера

Мы используем встроенный НейроЧат платформы Нейро42. Отдельный мессенджер и токен не нужны — всё настраивается прямо в воркфлоу через ноду Чат Триггер.

Чат Триггер — это нода «When chat message received» (Получение сообщения в чате). Она:

  • принимает сообщение пользователя из НейроЧата
  • передаёт данные в воркфлоу
  • автоматически возвращает ответ агента обратно в чат

 

💡Подробная инструкция по публикации агента в НейроЧат — ТУТ

Создание воркфлоу ИИ-агента

Теперь самое интересное — собираем всё вместе! Создадим цепочку из трёх нод, которая будет:

  1. Получать сообщения из НейроЧата
  2. Отправлять их в ЛЛМ (LLM)
  3. Возвращать умный ответ пользователю в чат

Часть 1: Добавляем Чат Триггер

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

В боковом меню Нейро42 нажмите на +, и затем на Воркфлоу — «Workflow» → Создать — «Create in».

Или просто нажмите “Создайте первого агента”.

Шаг 2. Добавьте ноду Телеграм Триггер

Нажмите кнопку «+» на рабочей области.

В поиске введите «чат» или «Chat».

ВАЖНО: Выберите именно ноду «Получение сообщения в чате» — When chat message received, которая будет слушать сообщения пользователей в НейроЧате.

Триггер — это точка старта, она будет «слушать» входящие сообщения.

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

Кликните на появившуюся ноду — откроется панель настроек.

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

  • Сделать чат общедоступным (Make Chat Publicly Available) — включить
  • Аутентификация (Authentication) — Отсутствует (None)
  • Режим ответа (Response Mode) — Когда завершится последний узел (When Last Node Finishes)

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

Часть 2: Добавляем ИИ-Агента и Чат Модель

Шаг 4. Добавьте ноду ИИ-Агент

Наведите курсор на правый край ноды Чат Триггер — появится маленький «+».

Нажмите на него.

В появившемся меню вы сразу увидите раздел «ИИ» — «Создайте автономных агентов, резюмируйте или ищите документы». Нажмите на него.

 

Выберите «ИИ-Агент» — «AI Agent».

 

Далее, закройте ноду по крестику в верхей части для возврата в Рабочую область.

Шаг 5. Подключите Чат Модель — OpenAI (OpenAI)

У ноды ИИ-Агент снизу есть слот для подключения чат-модели. Нажмите на «+» снизу ноды.

В поиске введите OpenAI— «OpenAI».

Выберите OpenAI — «OpenAI» → Чат Модель — «Chat Model».

В открывшейся панели нажмите «Учетные данные для подключения» и нажмите «Создать новые учетные данные».

В поле АПИ Ключ — «API Key» вставьте ваш АПИ-ключ ОпенАИ.

А также вставьте Базовый ЮРЛ — «Base URL», который можно взять в личном кабинете

Нажмите «Сохранить».

 

Шаг 6. Настройте параметры

В поле «Модель» выберите одну из текстовых моделей из списка. Напоминаем, что полный список доступных моделей можно увидеть в личной кабинете на этапе открытия инстанса.

А также обязательно выключите использование АПИ ответов — Use Responses API

 

Тестирование агента

Прежде чем запускать агента в работу, нужно его протестировать. Вдруг даже по инструкции что-то настроено неправильно?

Шаг 1. Запустите тестовый режим

В новой версии платформы воркфлоу сохраняется автоматически — кнопку «Сохранить» нажимать не нужно.

Вместо кнопки «Выполнить воркфлоу» теперь используется кнопка «Открыть чат». Нажмите на неё.

Шаг 2. Отправьте сообщение боту

Чат откроется прямо внутри воркфлоу. Напишите любое сообщение, например: «Привет! Как дела?»

 

Шаг 3. Проверьте результат

Вы увидите, как данные «прошли» через все ноды — они просветятся.

 

Каждая нода покажет, какие данные она получила и что отправила дальше.

 

Агент ответит прямо в этом же чате — например: «Привет! Все отлично, спасибо! Как у тебя дела?» Так мы проверяем, что всё работает.

 

Что делать, если не работает 

Проблема Как исправить
Агент не отвечает Убедитесь, что настройка Make Chat Publicly Available включена в ноде Чат Триггер.
Нода подсвечивается красным Кликните на неё — внизу появится описание ошибки. Прочитайте его, обычно там написано, что не так.

 

💡 Где смотреть историю запусков: 

Нажмите кнопку «Выполнения» в боковом меню. Там видны все запуски воркфлоу — успешные и с ошибками. Можно открыть любой и посмотреть, на каком этапе что пошло не так.

 

Публикуем агента в НейроЧат

В отличие от Telegram-версии, отдельная нода отправки ответа не нужна — Чат Триггер возвращает ответ автоматически. Вместо этого нужно опубликовать воркфлоу и подключить его к НейроЧату.

Подробная инструкция по публикации — в разделе «Публикация агента в НейроЧат» в конце этого ТУТ

✅ Воркфлоу готов! У вас получилась цепочка: Чат Триггер → ИИ-Агент (с подключённой OpenAI Chat Model). Данные «текут» слева направо: пришло сообщение → обработалось ИИ → ушел ответ.

 

Запуск агента в работу

Тестирование прошло успешно? Отлично! Теперь запустим агента в постоянную работу — он будет отвечать 24/7, даже когда вы закроете браузер.

Шаг 1. Активируйте воркфлоу

Нажмите на кнопку «Опубликовать» справа вверху.

Появится мини-окно публикации воркфлоу. Укажите название версии и при необходимости опишите изменения.

Нажмите кнопку «Опубликовать» в этом окне.

Появится уведомление «Воркфлоу опубликован» — всё готово!

Теперь ИИ агент работает постоянно — не нужно держать браузер открытым.

 

Шаг 2. Проверьте, что все работает

Если вы уже опубликовали агента по инструкции то нужна финальная проверка.
Закройте вкладку с Нейро42.

Перейдите в НейроЧат и отправьте агенту новое сообщение.

Агент должен ответить — значит, все настроено правильно!

 

 

🎉 Поздравляем!

Вы создали своего первого ИИ-агента!


Теперь он работает автоматически и отвечает всем, кто напишет агенту в НейроЧате.

Публикация агента в НейроЧат

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

Подробная пошаговая инструкция со всеми настройками доступна по ссылке:

📖  Инструкция: Публикация агента в НейроЧат

 

Краткая схема — как всё связано:

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

 

Основные шаги публикации:

  1. Скопировать URL из ноды Чат Триггер (появляется после публикации воркфлоу)
  2. Перейти в личный кабинет → раздел «Разработка агентов» → вкладка «Публикация агента в НейроЧат»
  3. Создать агента: указать название, идентификатор, описание, вставить URL
  4. Включить «Доступен в чате Нейро42»
  5. Развернуть агента — для себя или для всей организации

 

⚠️ Частые ошибки: несовпадение режима Streaming между триггером, нодой агента и настройками НейроЧата → агент не отвечает. Убедитесь, что режим одинаков везде.

 

Что делать дальше

Вы сделали первый шаг — и это самое сложное! Теперь несколько идей, как развиваться дальше:

 

Улучшите агента

  • Добавьте память — чтобы агент помнил контекст разговора (сейчас каждое сообщение для него как новое)
  • Подключите базу знаний — загрузите документы, по которым агент будет отвечать
  • Настройте доступ для команды — опубликуйте агента для организации в разделе «Разработка агентов»

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

 

Изучите другие ноды

В Нейро42 сотни разных нод — для работы с Гугл Таблица (Google Sheets), отправки емайл (email), подключения к СРМ (CRM) и многого другого. Вот несколько полезных:

 

  • Если (IF) — условия (если X, то делай Y, иначе Z)
  • Переключение (Switch) — направление по разным путям в зависимости от условий
  • Настроить / Отредактировать Поля (Set / Edit Fields) — преобразование данных (очень часто используется)
  • ХТТП Запрос (HTTP Request) — подключение к любому сервису с АПИ (API)

 

Практикуйтесь!

Самый важный совет: можете не просто копировать готовые шаблоны, а пытаться собирать воркфлоу с нуля. Придумайте свой проект — бота для записи на прием, автоматизацию рассылки, что угодно — и попробуйте его реализовать. Именно так набирается опыт.

Предупреждение о применении иностранного языка

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

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

Данная мера принята для минимизации рисков неправильного толкования ключевых понятий и предотвращения негативных последствий, связанных с некорректностью переводов сложных технических терминов и выражений.

Мы обращаем внимание на тот факт, что наличие иностранного языка в данной документации обусловлено профессиональной необходимостью и соответствует установленным нормам и правилам использования специализированной литературы и документации в Российской Федерации.

Свяжитесь с нами

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