Yuanbao — Asistente de IA de Tencent
guía fácil de entender basada en documentos oficiales
Imagina que estás en una fiesta de empresa y quieres que tu asistente de IA participe en todas las conversaciones, tanto en chats uno a uno como en discusiones de grupo. Eso es exactamente lo que hace esta función: conecta tu agente Hermes directamente a la plataforma de mensajería Yuanbao de Tencent, para que tu IA pueda enviar y recibir mensajes en tiempo real, como un compañero servicial.
Qué Necesitas Antes de Empezar
Piénsalo como sacar un abono de gimnasio: necesitas algunas cosas primero:
- Una cuenta de Yuanbao con permiso para crear bots (pregunta a tu administrador si no estás seguro)
- Tu APP_ID y APP_SECRET personales (como un nombre de usuario y contraseña para tu bot)
- Paquetes de Python instalados en tu ordenador
Ejecuta este comando para instalar todo:
pip install websockets httpx aiofiles
Paso 1: Crea tu Bot
Primero, descarga la aplicación Yuanbao desde https://yuanbao.tencent.com/. Una vez dentro:
- Ve a PAI → Mi Bot
- Haz clic en “Crear Nuevo Bot”
- Después de crearlo, copia tu APP_ID y APP_SECRET — guárdalos bien, ¡como tu PIN del cajero!
Paso 2: Deja que el Asistente Haga el Trabajo
Hermes tiene un asistente mágico que configura todo por ti. Solo escribe:
hermes gateway setup
Cuando te pregunte, selecciona Yuanbao. El asistente:
- Te pedirá tu APP_ID
- Te pedirá tu APP_SECRET
- Guardará todo automáticamente
Consejo profesional: No te preocupes por las URLs de WebSocket o los dominios de API — vienen preconfigurados con valores inteligentes por defecto. Solo necesitas proporcionar esas dos claves.
Paso 3: Verifica tu Configuración
Después de que el asistente termine, mira tu archivo de configuración en ~/.hermes/.env. Deberías ver algo como:
YUANBAO_APP_ID=tu_app_id_aqui
YUANBAO_APP_SECRET=tu_secreto_aqui
YUANBAO_WS_URL=wss://url-websocket-por-defecto
YUANBAO_API_DOMAIN=https://dominio-api-por-defecto
Si todo se ve bien, ¡estás listo para empezar!
¿Qué Hace Esto Especial?
Yuanbao no es una aplicación de chat cualquiera — está diseñada para negocios serios. Usa WebSocket (piensa en ello como una línea telefónica permanentemente abierta en lugar de enviar cartas de un lado a otro) para la entrega instantánea de mensajes. Además, soporta multimedia enriquecida: imágenes, archivos e incluso mensajes de voz. Así que tu IA puede enviar una captura de pantalla, compartir un PDF o reenviar una nota de voz, igual que un compañero real.
Para Terminar
Conectar Hermes a Yuanbao es como darle a tu IA una credencial de empresa — ahora puede unirse a conversaciones, responder preguntas y compartir archivos en tiempo real. Toda la configuración lleva menos de cinco minutos, y el asistente se encarga de las partes aburridas.
Consejo práctico para principiantes: Empieza con una prueba simple — envía un mensaje a tu bot en un chat uno a uno primero. Una vez que funcione, intenta añadirlo a un grupo. Así detectarás cualquier problema de configuración a tiempo y ganarás confianza antes de activar el modo “compañero de IA” completo. ¡Feliz automatización!
📖 Documentación oficial
Este artículo se basa en la documentación oficial de Hermes Agent :Docs oficiales › user-guide/messaging/yuanbao