ИИ-агент в MAX своими руками: как создать бота и подключить модель

Боты в MAX создаются на платформе MAX для партнеров. Подключиться к ней могут юрлица, ИП и самозанятые, резиденты России. Физическое лицо и нерезидент профиль пока не проверят.

Профиль проверяют через Госуслуги. Входить нужно с ролью «Руководитель» или «Администратор»: с ролью сотрудника проверка не пройдет. Если данные ЕГРЮЛ или ЕГРИП устарели, их обновляют в профиле организации, обычно от нескольких минут до 1 часа.

Организация или ИП создает до 5 ботов, самозанятый до 2. Несколько ботов нужны, если у вас несколько филиалов или разные сценарии диалогов.

Для ИИ-агентаИИ-агент ИИ-агент это нейросеть, которая не просто отвечает, а сама выполняет задачу по шагам: ищет данные, пользуется программами и проверяет результат. Подробнее в словаре понадобятся еще две вещи. Первая: сервер с доменом и сертификатом HTTPS, где работает n8n, программа для сборки сценариев автоматизации. Вторая: модель. Ollama запускает открытые моделимодель с открытыми весами Модель с открытыми весами (open-weights model) это нейросеть, файлы параметров которой можно скачать и запустить на своем оборудовании. Подробнее в словаре на вашем компьютере или сервере и распространяется по лицензии MIT.

1. Откройте веб-версию платформы MAX для партнеров и войдите по номеру телефона и коду из СМС. Документация советует корпоративный номер, к которому у вас всегда есть доступ.

2. На экране «Выбор типа профиля» выберите организацию, ИП или самозанятого и пройдите проверку через Госуслуги. Об успешной проверке напишет бот «MAX для бизнеса».

3. В разделе «Чат-ботычат-бот Чат-бот это программа, которая переписывается с человеком в окне чата: на сайте, в мессенджере или в приложении. Подробнее в словаре» нажмите «Создать» и заполните карточку: логотип 500х500 пикселей, название до 59 символов и описание до 200 символов. Никнейм вида idИНН_bot платформа создает сама, поменять его пока нельзя.

4. Снова нажмите «Создать». Бот получит статус «На модерациимодерация контента Модерация контента это проверка сообщений, отзывов, картинок и ответов нейросети на запрещенное и вредное содержимое до или после публикации. Подробнее в словаре», проверка занимает до 48 часов по рабочим дням, и все это время настройки менять нельзя.

5. После проверки статус сменится на «Опубликован», а бот появится в поиске MAX. Если статус «Нужны исправления», причину отказа ищите в карточке бота.

Токентокен Токен это кусочек текста: слово, часть слова или знак, с которыми работает языковая модель. Подробнее в словаре это ключ, по которому программа управляет ботом от вашего имени. Вебхук это адрес на вашем сервере, куда MAX сам присылает каждое новое сообщение. Второй способ, Long Polling, когда программа сама опрашивает MAX, документация разрешает только для разработки и тестов.

1. На платформе в разделе «Чат-боты» выберите бота, нажмите «⋮» и «Настройки». Справа от поля «Токен доступа» нажмите значок копирования. Токен никому не передавайте: с ним посторонний управляет ботом. При утечке токен обновляют там же.

2. В n8n создайте сценарий с узлом «Webhook» и в поле «HTTP Method» выберите POST. В поле «Respond» выберите «Immediately» (ответить сразу): MAX ждет ответа HTTP 200 не дольше 30 секунд, а модель может думать дольше.

3. Придумайте секрет, длинную случайную строку. В узле «Webhook» в поле «Authentication» выберите «Header auth» и в учетных данных укажите имя заголовка X-Max-Bot-Api-Secret и этот секрет. Так n8n примет только запросы от MAX.

4. Опубликуйте сценарий и скопируйте «Production URL» узла. Отправьте запрос POST на https://platform-api2.max.ru/subscriptions с заголовком Authorization, в котором стоит токен, и телом из трех полей: «url» с адресом вебхука, «update_types» со значением message_created и «secret» с вашим секретом.

Адрес вебхука должен работать по HTTPS на порту 443 с сертификатом доверенного центра или сертификатом Минцифры, самоподписанный не подойдет. Если сервер не отвечает 8 часов, MAX отписывает бота от вебхука.

1. После узла «Webhook» поставьте узел «AI Agent». В параметре «Prompt» выберите «Define below» (задать ниже) и в поле «Prompt (User Message)» подставьте текст сообщения клиента из события message_created.

2. В опциях узла добавьте «System Message» и напишите правила: от чьего имени агент отвечает, о чем можно говорить, что передавать менеджеру. Это системный промпт, инструкция агенту на каждый разговор.

3. Подключите к узлу модель. Для открытой модели это узел «Ollama Chat Modelчат-модель Чат-модель это языковая модель, дообученная вести диалог: она понимает роли собеседников, следует инструкциям и отвечает на реплики, а не просто продолжает текст. Подробнее в словаре»: в его учетных данных поле «Base URL» по умолчанию равно http://localhost:11434. Если n8n и Ollama стоят в разных контейнерах, укажите адрес, доступный из контейнера n8n.

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

5. Последним поставьте узел «HTTP Request»: метод POST, адрес https://platform-api2.max.ru/messages с параметром user_id отправителя, заголовок Authorization с токеном. Включите «Send Body», в «Body Content Type» выберите JSON и передайте поле «text» с ответом модели.

У ответа два ограничения MAX: текст до 4000 символов и не больше двух сообщений в секунду в один диалог. Длинный ответ модели режьте на части или просите ее отвечать короче.

1. Напишите боту в MAX десять типовых вопросов клиентов. Ответы смотрите на вкладке «Executions» сценария в n8n: там видно, что пришло от MAX и что ответила модель.

2. Исправьте инструкцию там, где агент обещает лишнее или придумывает цены, и задайте те же вопросы снова. Как составить набор вопросов и по каким метрикам принимать агента, мы разобрали в статье о тестировании агента.

Клиенты пишут в MAX имена, телефоны и адреса, а это персональные данные. По 152-ФЗ сбор и хранение данных граждан РФ ведутся в базах на территории России, а перед передачей за рубеж оператор с 1 марта 2023 года уведомляет Роскомнадзор.

Поэтому n8n и модель держите на сервере в России, а зарубежную облачную модельоблачная модель Облачная модель это нейросеть, которая работает на серверах поставщика, а вы пользуетесь ею через сайт, приложение или API и платите за объем запросов. Подробнее в словаре к таким диалогам не подключайте. Как мы храним данные клиентов, описано на странице о безопасности данных.

Сборка выше отвечает на вопросы, но не помнит клиента между сообщениями и не пишет в CRM. Память диалога, запись сделки, передача человеку в тот же чат и один агент на MAX, Telegram и сайт требуют программирования и проверки на реальных диалогах.

Такого агента мы подключаем под ключ: пилот за 14 дней от 150 000 ₽ с метрикой в договоре. Что агент делает в MAX, описано на странице ИИ-агента для MAX, а сборку для Telegram своими руками мы разобрали отдельно.

n8n распространяется по лицензии Sustainable Use License (fair-code): ставить на свой сервер и менять можно, перепродавать как облачный сервис нельзя. Для агента своей компании этого достаточно.