Yuanbao — Тенсентский ИИ-ассистент
понятное руководство, основанное на официальных документах
Представьте, что вы на корпоративе в большой компании, и хотите, чтобы ваш ИИ-ассистент участвовал в каждом разговоре — и в личных чатах, и в групповых обсуждениях. Именно это и делает данная функция: она подключает вашего агента Hermes напрямую к мессенджеру Yuanbao от Tencent, так что ваш ИИ может отправлять и получать сообщения в реальном времени, как полезный коллега.
Что нужно подготовить заранее
Это как с абонементом в спортзал — сначала нужно кое-что иметь:
- Аккаунт Yuanbao с разрешением на создание ботов (если не уверены — уточните у администратора)
- Ваши личные APP_ID и APP_SECRET (что-то вроде логина и пароля для вашего бота)
- Установленные Python-пакеты на вашем компьютере
Выполните эту команду, чтобы установить всё необходимое:
pip install websockets httpx aiofiles
Шаг 1: Создайте своего бота
Сначала скачайте приложение Yuanbao с https://yuanbao.tencent.com/. Когда зайдёте:
- Перейдите в PAI → Мой бот
- Нажмите «Создать нового бота»
- После создания скопируйте ваши APP_ID и APP_SECRET — храните их в безопасности, как ПИН-код от банковской карты!
Шаг 2: Позвольте мастеру сделать всю работу
У Hermes есть волшебный помощник, который всё настроит за вас. Просто введите:
hermes gateway setup
Когда спросит — выберите Yuanbao. Мастер:
- Запросит ваш APP_ID
- Запросит ваш APP_SECRET
- Сохранит всё автоматически
Совет профи: Вам не нужно беспокоиться о WebSocket-URL или доменах API — они уже заполнены умными значениями по умолчанию. Вам нужно указать только эти два ключа.
Шаг 3: Перепроверьте настройки
После завершения работы мастера загляните в файл конфигурации ~/.hermes/.env. Вы должны увидеть что-то вроде:
YUANBAO_APP_ID=your_app_id_here
YUANBAO_APP_SECRET=your_secret_here
YUANBAO_WS_URL=wss://default-websocket-url
YUANBAO_API_DOMAIN=https://default-api-domain
Если всё выглядит правильно — вы готовы к работе!
Что здесь особенного?
Yuanbao — это не просто очередное приложение для чатов, оно создано для серьёзных задач. Оно использует WebSocket (представьте это как постоянно открытую телефонную линию вместо переписки письмами) для мгновенной доставки сообщений. Кроме того, поддерживаются богатые медиаформаты: изображения, файлы и даже голосовые сообщения. Так что ваш ИИ может отправить скриншот, поделиться PDF или переслать голосовое сообщение — совсем как настоящий коллега.
Подводим итоги
Подключение Hermes к Yuanbao — это как выдать вашему ИИ пропуск в компанию: теперь он может участвовать в разговорах, отвечать на вопросы и обмениваться файлами в реальном времени. Вся настройка занимает меньше пяти минут, а мастер берёт на себя всю рутину.
Практический совет для новичков: Начните с простого теста — отправьте сообщение вашему боту в личном чате. Когда это заработает, попробуйте добавить его в группу. Так вы быстро выявите возможные проблемы и обретёте уверенность, прежде чем включать полноценный режим «ИИ-коллеги». Удачной автоматизации!
📖 Официальная документация
Эта статья основана на официальной документации Hermes Agent :Официальные документы › user-guide/messaging/yuanbao