Интеграция c BotHub

В этой инструкции мы научимся интегрироваться с сервисом BotHub

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

Важно! При регистрации по нашей партнерской ссылке вы получите 100 000 Caps. Это местная валюта для запросов.

Интересно? Тогда идем скорее в Автопилот.

План инструкции:

• Создание ключа
• Настройки интеграции
• Термины и модели
• Команда «Получить ответ от бота»
• Настройки хостинга для хранения истории

Создание ключа

1. Создать аккаунт на сайте
2. Cоздать ключ API (платно, но достаточно минимального тарифа)
3. Перейти по ссылке
4. Нажать «Добавить ключ» и следуя указаниям получить ключ
5. Сохранить ключ в интеграции сервиса

В примере секретный ключ будет

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM0ZWFmMTMxLTcxMTctNGZiNS1iYWQzLTgzNzljNjg5OWRhZSIsImlzRGV2ZWxvcGVyIjp0cnVlLCJpYXQiOjE3NDQ2MzUyMjQsImV4cCI6MjA2MDIxMTIyNH0.2JQHICrmIPEKkaVTruyagn93_un7mBbCqAiAPdB_j6M

Настройки интеграции

Тут на самом деле просто. Открываем настройки нужного сообщества проматываем до раздела BotHub

В АП, в списке подключенных сообществ найдите нужное и откройте его «Настройки» нажав на соответствующую белую кнопку в карточке сообщества.

В настройках на первой вкладке Интеграции найдите раздел Bot Hub и там:

• вставьте ключ в первое поле

Все! Если вы не будете использовать скрипт для хранения истории на своем хостинге этого достаточно, чтобы заработали действия «Сгенерировать сообщение для Bot Hub», «Добавить сообщение в историю переписки», «Сгенерировать изображение для Bot Hub»
Если вы будете сохранять истории на своем хостинге, то рекомендуется настроить хостинг по этой инструкции.

• После развертки скрипта вставляете URL хостинга в первое поле
• и пароль к истории во второе поле

Термины и модели

Токены - так сервис OpenAI назвали валюту, которая расходуется при запросах. Она имеет бинарный размерный порядок, где разные типы символов означают разное количество токенов.

Примерно 1000 токенов равняется 1500 кириллическим символам.

Температура — другими словами — похожесть.

Чем ниже температура — тем ответы будут более похожими друг на друга. Чем выше температура — тем больше они будут отличаться

Температура редко используется и нужна очень редко.

Как минимум, для использования температуры необходимо иметь возможность запоминания предыдущих ответов. Но это примерно от 2 до 10 раз увеличивает расход токенов.

Типы моделей:

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

OpenAI предлагает несколько моделей GPT, каждая из которых подходит для разных задач. Разбираемся, чем они отличаются! 👇

GPT-4o («Omni») — самая мощная и быстрая модель OpenAI на сегодня.

✅ Ключевые особенности:

• Значительно быстрее предыдущих версий GPT-4
• Лучшая производительность в обработке текста, кода, изображений и аудио
• Более точные и естественные ответы
• Оптимизирована для сложных вычислений и многозадачности

🔹 Идеально подходит для:

• Разработки ИИ-продуктов
• Продвинутых чат-ботов и ассистентов
• Обработки сложных запросов и аналитики

GPT-4o-mini — упрощенная и более доступная версия GPT-4o.

✅ Ключевые особенности:

• Более быстрая и экономичная, чем GPT-4o
• Хорошая точность, но с упрощенной архитектурой
• Оптимизирована для быстрого взаимодействия и повседневных задач

🔹 Идеально подходит для:

• Чатов и диалоговых систем
• Легких ИИ-приложений
• Базовой генерации текста с хорошим качеством

GPT-4-turbo — более доступная и оптимизированная версия GPT-4, созданная для быстрого выполнения задач.

✅ Ключевые особенности:

• Чуть менее мощная, чем GPT-4o, но значительно дешевле
• Поддерживает долгие контексты
• Хороший баланс между скоростью и качеством

🔹 Идеально подходит для:

• Автоматизации процессов
• Средне-сложных вычислений и анализа
• Оптимизации затрат при высоком качестве ответа

GPT-3.5-turbo — самая экономичная модель в линейке, подходящая для простых задач.

✅ Ключевые особенности:

• Самая дешевая модель с приемлемым качеством
• Быстрая работа с текстом
• Меньше возможностей по сравнению с GPT-4o, но все еще мощная

🔹 Идеально подходит для:

• Простых чат-ботов и поддержки
• Генерации коротких текстов
• Проектов с ограниченным бюджетом

💡 Какую модель выбрать?

• Если важна максимальная мощность → GPT-4o
• Если нужен компромисс цена/качество → GPT-4-turbo
• Если нужна скорость и экономичность → GPT-4o-mini
• Если нужен минимальный бюджет → GPT-3.5-turbo

Команда «Получить ответ от бота»

Важно! Пример универсальной команды с реакцией и на комментарии и в личные сообщения.

События:

1) Написал сообщение с текстом, подходящим под регулярное выражение ^Создай запрос:

ВАЖНО! Для переключения переключатель с содержащим на подходящим под регулярку и вводим нужный текст. Если какие -то условия, например «Сотрудник Аккаунта» у вас были в других командах, то выбирайте их из каталога, нажатием на «Найти в каталоге»

По желанию добавляем условия:

1) «Сотрудник аккаунта, чтобы команду мог запустить только Администратор сообщества, либо тот, у кого есть разрешение.» Тогда команду сможет добавлять только Администратор.

2) Переменная %is_conv%равна 0— чтобы команда срабатывала, если подписчик написал в сообщения сообщества.

Опционально через «Добавить секцию» (для комментариев)

События:

1) Событие «Написал комментарий» под постом с ID вставить пост и текстом, подходящим под регулярное выражение ^Создай запрос:

По желанию добавляем условия:

1) «Выполнена команда» № 0 ровно 0 раз, чтобы команду могли запустить только один раз

Опционально через «Добавить секцию» (для ответа от администратора)

События:

Важно! Событие: «Получил сообщение» от админа не работает по умолчанию. Как настроить посмотрите в инструкции.

1) Событие «Получил сообщение от администратора» с текстом, подходящим под регулярное выражение ^Создай запрос:

Действия:

1) Добавляем временную переменную %prompt%

со значением:

{reg}%content%~~Создай запрос:~~0~~{/reg}

которая найдет из регулярного выражения введенный совет. Рассмотрим ее подробнее:

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

2) Для отправки запроса используем действие «Сгенерировать сообщение для Bot Hub» с нужными параметрами:

рассмотрим подробнее:

• модель - указывается одно значение на выбор. gpt-4o, gpt-4o-mini,gpt-4-turbo, gpt-3.5-turbo, либо любая другая модель. По умолчанию: gpt-3.5-turbo
• текст со значением %prompt% - здесь указывается сообщение от пользователя

• истории у нас не передается поэтому там пусто. Поддерживаются переменные Автопилота
• откуда брать историю. Из JSON или с сервера (при настроенном хостинге)

Дополнительные параметры по типу max_tokens передавайте по желанию:

• max_tokens — максимальное количество токенов для запроса/ответа бота. 1000 токенов примерно 1500 кириллическим символам.

3) Во временной переменной %error% формируем текст при ошибке от бота. Например, через функцию {rand}

{rand}Я устал|Нет настроения отвечать{/rand}

4) Для того, чтобы сохранить текст ответа от бота во временной переменной %text%, пишем:

%openai_answer% 

5) Во временной переменной %ok% формируем текст при ответе от бота. Например, просто передаем текст.

%text%

6) Условная переменная %text% cо значением:

• %ok%
если %text% подходит под регулярку точка
• ИЛИ: %error%

То есть, есть адекватный ответ от бота мы выдаем его, а нет, выдаем ошибку.

7) Отправляем сообщение с текстом:

%text%

8) Опционально: действием: «Отправить сообщение» отправляем сообщение сотруднику с текстом:

Промт:%prompt%
Ответ бота:%text%

9) Действие: «Прервать/продолжить выполнение команды» с переключателем продолжено, если Событие 1914801 есть среди текущих (то есть запускается в комментариях)

10) Опционально пишем комментарий действием «Написать комментарий в VK» с текстом:

%text%

Важно! Для ответного комментария не забудьте нажать Еще→ сюда вставить переменную %object_id% или кликнуть по сноске справа рядом

«Ответить» на комментарий с ID:

Сохранение историй на хостинге

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

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

Да, в полях, как и в хостинге можно удалять старые сообщения, но для вашего удобства я сделал вам удобное решение.

Требования для работы скрипта:

• Хостинг или VPS (бесплатный не подойдет, там есть ограничения)
• желательно попроще (потому что для текущей версии требуется Apache). Ну или можете сами подправить под PHP-FPM
• Возможность загружать исполняемые PHP скрипты в отдельную папку.
• Навык смотреть видео и понимать технические инструкции :)
• Желательно иметь хотя бы базовое понимание понятия запроса на сервер.

Важно! Если у вас MacOS, то файл .htaccess он не отображает (об этом говорится в первом видео). В таком случае нужно создать этот файл на хостинге и сохранить со следующим текстом:

<FilesMatch "\.json$"> Order Allow,Deny Deny from all</FilesMatch>

Открываем conig.ini

и меняем необходимые параметры, пароль и ID сообщества в котором будет работать действие

password=123

allowed_clubs=123456,7890

Алгоритм установки:

• Скачиваем по этой ссылке скрипт: https://disk.yandex.kz/d/kBrLcBW1LER6kw
• Создаем поддомен на сайте, или просто готовим отдельную папку.
• Открываем файловый менеджер хостинга и там: загружаем скрипт, и распаковываем при помощи архиватора в подготовленную директорию.
• Там же обычно можно подредактировать конфигурацию.
• Но можно и на компе распаковать, поправить и по одному файлу загрузить.

Полезные ссылки:

• Приобрести домен по дешевке: namecheap.com

• Удобный и недорогой хостинг: fornex

После настройки можно сохранять истории на сервере.

На этом все. Тестируем.

Все отлично! Сегодня мы научились интегрировать нейросеть с автопилотом. Творческих успехов.

Оценить / обсудить статью можно в комментариях к этому посту.