Demo Telegram Bot YandexGPT

Telegram-бот на serverless-стеке Yandex Cloud с использованием YandexGPT для ответов на вопросы пользователей.

Особенности

• Использует библиотеку python-telegram-bot на Python.
• Не поддерживает контекст диалога.
• Поддерживает изменение навыков.

Из чего складывается стоимость использования бота

• Плата за «общение» с моделью YandexGPT (см. тарифы YandexGPT).
• Плата за количество вызовов функции, вычислительные ресурсы, выделенные для выполнения функции, время простоя подготовленных экземпляров и исходящий трафик (см. тарифы Yandex Cloud Functions).
• Плата за количество запросов к созданным API-шлюзам и исходящий трафик (см. тарифы Yandex API Gateway).
• Плата за количество запросов к стандартным очередям и очередям FIFO, а также исходящий трафик (см. тарифы Yandex Message Queue).
• Плата за хранение и запрос секретов (см. тарифы Yandex Lockbox).

1. Зарегистрируйте вашего бота в Telegram и получите токен:

   1. Запустите бота @BotFather и выберите команду /newbot.
   2. Укажите имя вашего бота, например Serverless Echo Telegram Bot. Это имя будут видеть пользователи при общении с ботом.
   3. Укажите имя пользователя бота, например ServerlessHelloTelegramBot. По имени пользователя можно будет найти бота в Telegram. Имя пользователя должно оканчиваться на слово на Bot или _bot.

   При успешной регистрации вы получите приветственное сообщение и токен бота.

2. Создайте сервисный аккаунт и назначьте ему роль admin на каталог.

3. Создайте секрет Yandex Lockbox с ключами для бота и YandexGPT:

   1. В блоке Создание секрета в поле Имя укажите имя секрета, например tg_bot_token.

   2. В блоке Данные секрета:

      1. Выберите Пользовательский тип секрета.
      2. Создайте ключ для бота, в поле Ключ укажите BOT_TOKEN.
      3. В поле Значение укажите полученный ранее токен бота.
      4. Создайте два ключа для YandexGPT, в поле Ключ укажите GPT_FOLDER_ID и GPT_API_KEY.
      5. В поле Значение укажите FOLDER_ID и API_KEY соответственно.

      Как получить API_KEY для YandexGPT см. Аутентификация в API Yandex Foundation Models.

4. В консоли управления перейдите в каталог, в котором хотите развернуть приложение.

5. Выберите сервис Cloud Apps.

6. На панели слева выберите Магазин приложений.

7. Выберите Demo Telegram Bot YandexGPT и нажмите кнопку Использовать.

8. Укажите:

   • Имя приложения.
   • (Опционально) Описание приложения.
   • Сервисный аккаунт с ролью admin на каталог или выберите Автоматически, чтобы нужный сервисный аккаунт создался при установке приложения. От имени этого сервисного аккаунта будут создаваться ресурсы приложения.
   • Идентификатор секрета Yandex Lockbox, который создали ранее.

9. Нажмите кнопку Установить.

10. В появившемся окне Проверка изменений нажмите Подтвердить и дождитесь, пока приложение установится.

11. На странице Обзор в разделе Ресурсы приложения найдите API-шлюз, перейдите на его страницу и скопируйте ссылку на служебный домен.

12. Чтобы настроить связь между функцией и Telegram-ботом, выполните запрос. Вместо <токен_бота> укажите токен Telegram-бота, вместо <домен_API-шлюза> — ссылку на служебный домен API-шлюза:

    • Для Linux/macOS

      curl \
        --request POST \
        --url https://api.telegram.org/bot<токен_бота>/setWebhook?url=https://<домен_API-шлюза>/echo
      

    • Для Windows (cmd)

      curl ^
        --request POST ^
        --url "https://api.telegram.org/bot<токен_бота>/setWebhook?url=https://<домен_API-шлюза>/echo"
      

    • Для Windows (Powershell)

      curl.exe `
        --request POST `
        --url https://api.telegram.org/bot<токен_бота>/setWebhook?url=https://<домен_API-шлюза>/echo
      

    Результат:

    {"ok":true,"result":true,"description":"Webhook was set"}
    

13. Напишите боту в Telegram команду /start и дальше можете задавать ему вопросы.

14. Вы можете удобно продолжить разработку бота склонировав SourceCraft репозиторий cloudapp-tgbot-yandexg и настроив интеграцию с развернутым Cloud App по инструкции из README.md

• Отправка вопросов боту в Telegram и получение ответов на них от YandexGPT.

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.