Yuanbao — Assistente de IA da Tencent | Easy Understand Hermes Agent

Imagine que você está em uma festa grande da empresa e quer que seu assistente de IA participe de todas as conversas — tanto nos chats individuais quanto nas discussões em grupo. É exatamente isso que este recurso faz: ele conecta seu agente Hermes diretamente à plataforma de mensagens Yuanbao da Tencent, para que sua IA possa enviar e receber mensagens em tempo real, como um colega prestativo.

O Que Você Precisa Antes de Começar

Pense nisso como conseguir uma mensalidade de academia — você precisa de algumas coisas primeiro:

Uma conta Yuanbao com permissão para criar bots (pergunte ao seu administrador se não tiver certeza)
Seu APP_ID e APP_SECRET pessoais (como um nome de usuário e senha para o seu bot)
Pacotes Python instalados no seu computador

Execute este comando para instalar tudo:

pip install websockets httpx aiofiles

Passo 1: Crie Seu Bot

Primeiro, baixe o aplicativo Yuanbao em https://yuanbao.tencent.com/. Depois de entrar:

Vá em PAI → Meu Bot
Clique em “Criar Novo Bot”
Após criá-lo, copie seu APP_ID e APP_SECRET — guarde-os com segurança, como se fossem o PIN do seu cartão!

Passo 2: Deixe o Assistente Fazer o Trabalho

O Hermes tem um assistente mágico que configura tudo para você. Basta digitar:

hermes gateway setup

Quando ele perguntar, selecione Yuanbao. O assistente vai:

Pedir seu APP_ID
Pedir seu APP_SECRET
Salvar tudo automaticamente

Dica de profissional: Você não precisa se preocupar com URLs de WebSocket ou domínios de API — eles já vêm preenchidos com padrões inteligentes. Você só precisa fornecer essas duas chaves.

Passo 3: Verifique Suas Configurações

Depois que o assistente terminar, olhe seu arquivo de configuração em ~/.hermes/.env. Você deve ver algo assim:

YUANBAO_APP_ID=seu_app_id_aqui
YUANBAO_APP_SECRET=seu_segredo_aqui
YUANBAO_WS_URL=wss://url-websocket-padrao
YUANBAO_API_DOMAIN=https://dominio-api-padrao

Se tudo estiver certo, você está pronto para começar!

O Que Torna Isso Especial?

O Yuanbao não é apenas mais um aplicativo de chat — ele é feito para negócios sérios. Ele usa WebSocket (pense nisso como uma linha telefônica permanentemente aberta, em vez de enviar cartas de um lado para o outro) para entrega instantânea de mensagens. Além disso, ele suporta mídia rica: imagens, arquivos e até mensagens de voz. Então sua IA pode enviar uma captura de tela, compartilhar um PDF ou encaminhar uma nota de voz, exatamente como um colega de verdade.

Concluindo

Conectar o Hermes ao Yuanbao é como dar um crachá de empresa para sua IA — ela agora pode entrar em conversas, responder perguntas e compartilhar arquivos em tempo real. Toda a configuração leva menos de cinco minutos, e o assistente cuida das partes chatas.

Dica prática para iniciantes: Comece com um teste simples — envie uma mensagem para seu bot em um chat individual primeiro. Quando funcionar, tente adicioná-lo a um grupo. Assim, você identifica qualquer problema de configuração cedo e ganha confiança antes de ativar o modo “colega de IA” completo. Boa automação!