Интеграция AI Assistent

Интеграция AI Assistant позволяет подключить AI-провайдеров OpenAI, ProxyAPI или OpenRouter и использовать генерацию текста/изображений в чат-ботах Senler. После установки интеграции в конструкторе появляется шаг AI Assistant, который отправляет запрос в выбранный сервис по API-ключу и сохраняет ответ в переменную шага для дальнейшего использования в сценарии.

Как работает интеграция

Интеграция с AI-моделями добавляется в схему чат-бота Senler как отдельный шаг.

Когда подписчик доходит до этого шага, Senler:

• берёт текст из указанных переменных (например, последнее сообщение пользователя);

• формирует запрос;

• отправляет его выбранному AI-провайдеру (OpenAI, ProxyAPI или OpenRouter) с использованием заранее настроенного API-ключа и модели.

AI-провайдер обрабатывает запрос и возвращает ответ, который Senler сохраняет в переменную шага. Этот ответ можно использовать в следующих шагах бота:

отправить пользователю;

• подставить в шаблон сообщения;

• проверить условия (содержит / не содержит фразу);

• сохранить в поля пользователя и т.д.

Подключение к AI выполняется один раз в настройках интеграции: администратор добавляет API-ключи провайдеров и выбирает модель,

1. Получение API-ключи провайдера

1.1 OpenAI

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

В Senler интеграция с OpenAI используется для того, чтобы чат-бот мог отвечать пользователям с помощью нейросети. Как получить API-ключ OpenAI 1. Откройте https://platform.openai.com/api-keys 2. Нажмите кнопку “Create new secret key”. 3. Укажите любое удобное имя (например: Senler, Chatbot, Production). 4. Нажмите Create.

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

1.2 ProxyAPI

ProxyAPI - это сервис-посредник (прокси), который предоставляет доступ к нейромоделям через единый API-ключ. Он совместим с форматом OpenAI, поэтому его можно использовать в Senler так же, как оригинальный OpenAI API.

Особенности ProxyAPI:

• более доступные тарифы;

• единый API-ключ для разных моделей;

• повышенная стабильность за счёт распределения запросов;

• полностью совместим с OpenAI-протоколом (можно использовать те же настройки).

ProxyAPI подходит, если вы хотите снизить стоимость запросов или использовать альтернативные модели через единую точку подключения.

Шаг 1. Перейдите на сайт ProxyAPI

Откройте официальный сайт: https://proxyapi.ru

Зарегистрируйтесь или войдите в аккаунт.

Шаг 2. Перейдите в раздел API-ключей

После входа:

1. Откройте личный кабинет.

2. Найдите раздел “API ключи / Tokens” (обычно находится в боковом меню).

3. Перейдите в управление ключами.

Шаг 3. Создайте новый API-ключ

1. Нажмите кнопку “Создать ключ” или “Generate API Key”.

2. Укажите название ключа (например: Senler, Chatbot, Prod).

3. Сохраните сгенерированный ключ.

Ключ будет показан только один раз - обязательно скопируйте его сразу.

1.3 OpenRouter

OpenRouter - это универсальная платформа, которая объединяет множество популярных нейромоделей от разных разработчиков и предоставляет к ним единый доступ через один API.

Через OpenRouter доступны модели:

• OpenAI (GPT-4o, GPT-4o mini, и другие)

• Google (Gemini)

• Meta (Llama 3.1)

• Anthropic (Claude 3.5)

• Qwen

• Mistral

• И десятки других

Особенности OpenRouter:

• огромный выбор моделей в одном месте;

• единая схема запросов, совместимая с OpenAI API;

• возможность выбрать модель под задачу (точность, скорость, стоимость);

• гибкая система тарифов (можно пополнять баланс, либо отключать модели).

В Senler OpenRouter работает как альтернативный AI-провайдер, позволяющий использовать широкую линейку моделей. Как получить API-ключ OpenRouter

Чтобы подключить OpenRouter к Senler, нужно создать свой API-ключ в личном кабинете платформы.

Шаг 1. Перейдите на сайт OpenRouter

Откройте официальный сайт: https://openrouter.ai

Зарегистрируйтесь или войдите через Google / GitHub / e-mail.

Шаг 2. Откройте раздел API-ключей

В меню личного кабинета:

1. Нажмите на аватар в правом верхнем углу.

2. Выберите пункт “API Keys”. Или перейдите напрямую: https://openrouter.ai/settings/keys

Шаг 3. Создайте новый API-ключ

1. Нажмите “Create Key” или “New Secret Key”.

2. Придумайте название ключа (например: Senler, Bot, Production).

3. Сохраните ключ.

❗ Ключ отображается только один раз - обязательно скопируйте его сразу.

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

2. Инструкция по установке и настройке

Первым делом необходимо установить интеграцию "AI Assistent" в вашем личном кабинете Senler. Для этого:

1. Перейдите в раздел Интеграции.

2. Найдите и установите интеграцию "AI Assistent".

   
3. Вставьте ключ: В блоке "Настройки api ключей" найдите поле вашего провайдера (OpenAI, ProxyAPI или OpenRouter) и вставьте скопированный ранее ключ в соответствующую строку.

   
4. Нажмите кнопку "Далее"

   

• Проверьте соединение: Нажмите кнопку "Проверить" справа от поля ввода.

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

  • Дождитесь появления уведомления "Успешно".

• Сохраните настройки: После успешной проверки обязательно нажмите синюю кнопку "Сохранить" в нижней части окна. Без этого шага настройки не вступят в силу.

После проверки у вас будет уведомление "Успешно" в случае, если ключ указан корректный, или ошибка

Решение возможных проблем

Если при проверке вы получили ошибку, воспользуйтесь таблицей ниже для её устранения:

Ошибка	Что это значит	Как исправить
Код 401 (Invalid API Key)	Ключ не распознан системой или недействителен.	Проверьте, нет ли лишних пробелов до или после ключа. Убедитесь, что ключ скопирован полностью.
Ошибка Anthropic/Claude	Вы пытаетесь использовать модель Claude, но ключ не подходит для этого провайдера.	Убедитесь, что вы вставили ключ именно в то поле, для которого он предназначен (например, ключ от ProxyAPI в поле ProxyAPI).
Ошибка баланса	На счету провайдера (OpenAI/ProxyAPI) закончились средства.	Пополните баланс в личном кабинете провайдера ключа.

Важно: Если вы используете посредников (ProxyAPI или OpenRouter), убедитесь, что в их личном кабинете выбран нужный тариф или модель (например, Claude 3.5 Sonnet), иначе система может выдать ошибку доступа.

3. Подключение интеграции

После того как API-ключи добавлены в настройках проекта, вы можете использовать ИИ в сценариях ваших ботов.

1. Добавление шага "AI Assistent"

1. Откройте редактор нужного чат-бота.

2. Нажмите на иконку "+" в нижней части экрана или кликните правой кнопкой мыши на свободном поле.

3. В появившемся меню выберите пункт AI Assistent.

2. Вход в настройки блока

1. Нажмите на появившийся блок.

2. В правой боковой панели нажмите синюю кнопку "Настроить".

3. Рекомендация: оставьте галочку на пункте "Ожидание выполнения вебхука". Это гарантирует, что бот не отправит следующее (пустое) сообщение до того, как нейросеть сгенерирует ответ.

3. Конфигурация запроса (Модальное окно)

В открывшемся окне последовательно заполните параметры:

• Поставщик: Выберите сервис, ключ которого вы вводили ранее (OpenAI, ProxyAPI или OpenRouter).

Тип:

1. Тип "Chat" (Текст)

Используется для ответов на вопросы, пересказа текстов или создания контента. Здесь вы работаете с текстовыми переменными.

2. Тип "Image" (Изображения)

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

Как настроить

1. В поле Поставщик выберите сервис (OpenAI / ProxyAPI / OpenRouter).

2. В поле Тип выберите Image (Генерация изображения).

3. В поле Модель выберите нужную модель генерации изображений.

4. В поле Prompt опишите, какое изображение нужно создать.

5. Укажите переменную в поле Сохранить ответ в пользовательскую переменную (например, ai_image), чтобы использовать результат дальше в сценарии.

✅ Рекомендация: пишите промпт максимально конкретно - стиль, фон, объекты, формат, детали.

⚠️ Важно: некоторые модели могут требовать определённого формата запроса. Если генерация не запускается, попробуйте начать текст промпта с Generate: или сменить модель.

Особенность некоторых моделей (например, Nano Banana): могут требовать определённого формата prompt. Если генерация не запускается - попробуйте начать запрос с слова Generate: или сменить модель.

1. Тип "Assistant"(Продвинутый помощник)

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

   Как настроить

   1. В поле Тип выберите Assistant (Расширенные возможности общения).

   2. В поле Ассистент выберите нужного ассистента из списка.

   3. При необходимости включите Хранилище истории, чтобы бот учитывал предыдущие сообщения.

   4. При необходимости настройте Инструмент ассистента и доступ к переменным.

   5. Укажите переменную в поле Сохранить ответ в пользовательскую переменную (например, ai_answer).

   

Модель: Выберите конкретную нейросеть из списка (например, Google: Gemini 2.0 Flash).

Инструкции (Промпты):

Чтобы управление ответом было более точным, можно использовать два типа инструкций:

• System (Инструкция) - задаёт роль и стиль работы бота. Пользователь этого текста не видит. Пример: Ты помощник по подбору туров. Отвечай кратко и по делу.

• User (Вопрос) - сюда передаётся запрос пользователя. Рекомендуется использовать переменные, например последнее сообщение пользователя.

✅ Пример:

• System: Ты консультант. Отвечай дружелюбно и по шагам.

• User: %last_message%

Память бота (История сообщений)

Чтобы AI мог вести осмысленный диалог и учитывать предыдущие сообщения:

1. Включите чекбокс Сохранять историю сообщений.

2. Укажите Хранилище истории - пользовательскую переменную, где будет храниться переписка (например, ai_history).

3. Если нужно начать диалог заново, включите опцию Очистить историю сообщений у текущего пользователя.

✅ Рекомендуется использовать историю сообщений для чат-ботов поддержки, консультантов и сценариев с уточняющими вопросами.

Вывод ответа пользователю

Чтобы ответ от AI отображался в чате:

1. В поле Сохранить ответ в пользовательскую переменную укажите переменную, куда будет записываться результат (например, ai_answer).

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

3. После шага AI Assistant добавьте шаг Сообщение и вставьте переменную с ответом:

%ai_answer%

Далее нужно задать пользовательскую переменную, в которой будет содержаться вопрос для AI:

А вот тут нужно задать переменную, в которую будет фиксироваться ответ от AI:

Название её также может быть произвольным, главное - зафиксировать её в настройке интеграции и в самом боте

Вот так эта переменная может выглядеть в схеме бота:

То есть мы выводим её в качестве ответа пользователю на его запрос в AI

Рекомендуемая схема переменных (универсальный шаблон)

Чтобы не путаться, можно использовать стандарт:

• ai_question - вопрос пользователя (что отправляем в AI)

• ai_answer - ответ AI (что показываем пользователю)

• ai_history - история сообщений (если включена память)

✅ Пример в сценарии:

1. Сообщение → “Введите ваш вопрос”

2. Действие → сохранить ввод в ai_question

3. AI Assistant → User: %ai_question% → сохранить в ai_answer

4. Сообщение → %ai_answer%

Важные нюансы

• В настройках шага доступен параметр Максимальное количество токенов (в Senler до 4096) - он ограничивает длину ответа, который получит пользователь.

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

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

Подробную видеоинструкцию по подключению и настройке интеграции с AI: https://vk.com/video-139157852_456239236