Интеграция 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. Сохраните ключ.

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

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) закончились средства.	Пополните баланс в личном кабинете провайдера ключа.

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: или сменить модель.

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

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

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

1. В поле Тип выберите Assistant (Расширенные возможности общения).
2. В поле Ассистент выберите нужного ассистента из списка.
3. При необходимости включите Хранилище истории, чтобы бот учитывал предыдущие сообщения.
4. При необходимости настройте Инструмент ассистента и доступ к переменным.
5. Укажите переменную в поле Сохранить ответ в пользовательскую переменную (например, ai_answer).

4. Тип «Responses» (Responses API)

Тип Responses предназначен для сложных текстовых сценариев: диалогов с историей, работы с файлами, выполнения кода и управления переменными Senler.

Responses работает через новый API OpenAI и заменяет тип Assistant. Создавать отдельного ассистента в OpenAI не требуется — модель, инструкции и инструменты настраиваются непосредственно в шаге Senler.

Тип Responses доступен для OpenAI и совместимых провайдеров. При выборе OpenRouter этот тип недоступен.

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

1. В поле Поставщик выберите OpenAI или другого поддерживаемого провайдера.

   1. В поле Тип выберите Responses (Responses API).

      

   2. Выберите модель.

   3. Заполните инструкции:

      • System (Инструкция) - задаёт роль, правила и стиль ответа. В данном поле можно использовать переменные Senler, например {%ai_question%};

      • Сообщение для модели User - содержит запрос пользователя. Здесь можно использовать переменные Senler, например {%ai_question%}.

        

   4. В поле Сохранить ответ в пользовательскую переменную укажите переменную, в которую будет записан результат, например %ai_answer%.

   5. При необходимости включите сохранение истории сообщений и выберите хранилище истории.

   6. Выберите инструмент и настройте дополнительные параметры.

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

Инструменты Responses:

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

1. Автоматический выбор

   Модель самостоятельно определяет, нужно ли использовать доступные инструменты. Если работа с файлами и переменными не требуется, дополнительные идентификаторы можно не указывать.

   

2. Чтение прикреплённых файлов (File Search)

   File Search позволяет модели отвечать на вопросы с учётом документов, добавленных в векторное хранилище OpenAI.

   Перед настройкой шага:

   1. Откройте раздел OpenAI Storage.
      1. Создайте Vector Store.
      2. Добавьте в него необходимые файлы.
      3. Скопируйте идентификатор хранилища вида vs_....
      4. Вставьте его в поле Vector Store IDs в Senler.

   Для File Search необходимо указать хотя бы один Vector Store ID. Если поле оставить пустым, Senler не позволит сохранить настройки.

   Senler не загружает файлы и не создаёт векторные хранилища. Они должны быть подготовлены заранее в OpenAI Storage.

   

3. Выполнение кода на стороне openai (Code Interpreter)

   Code Interpreter позволяет модели выполнять код, анализировать таблицы, документы и другие загруженные файлы.

   Для настройки:

   1. Загрузите файл в OpenAI Storage.
   2. Скопируйте его идентификатор вида file_....
   3. Вставьте идентификатор в поле File IDs в Senler.
   4. В поле User сформулируйте задачу, которую необходимо выполнить с файлом.

   Для Code Interpreter необходимо указать хотя бы один File ID. Без него настройки шага сохранить нельзя.

   

4. Вызов функций (Functions)

   Functions позволяют AI работать с переменными Senler.

   Можно отдельно разрешить:

   • работу с пользовательскими переменными;
   • работу с глобальными переменными.

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

   В System-инструкции рекомендуется явно описать:

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

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

   Работа с историей сообщений

   

Чтобы Responses учитывал предыдущие сообщения пользователя:

1. Включите Сохранять историю сообщений.
2. Выберите хранилище истории.
3. Используйте одно и то же хранилище во всех шагах, которые должны продолжать диалог.

При следующем запуске шага модель учтёт предыдущие вопросы и ответы этого пользователя.

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

Работа с идентификаторами файлов

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

Если ID указан неверно, ресурс удалён или недоступен текущему API-ключу, запрос завершится ошибкой:

• vector_store unavailable — недоступно векторное хранилище;
• file unavailable — недоступен файл.

В этом случае проверьте ID, выбранный проект OpenAI и API-ключ интеграции.

Модель:

Выберите конкретную нейросеть из списка (например, 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_question - вопрос пользователя (что отправляем в AI)
• ai_answer - ответ AI (что показываем пользователю)
• ai_history - история сообщений (если включена память)

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

1. Сообщение → “Введите ваш вопрос”
2. Действие → сохранить ввод в ai_question
3. AI Assistant → User: %ai_question% → сохранить в ai_answer
4. Сообщение → %ai_answer%

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

• В настройках шага доступен параметр Максимальное количество токенов (в Senler до 4096) - он ограничивает длину ответа, который получит пользователь.
• Реальные лимиты и качество ответа зависят от выбранной модели и провайдера.
• По умолчанию может быть включено автоматическое сокращение текста, если запрос превышает лимит. При необходимости вы можете отключить эту опцию в дополнительных настройках.