Yuanbao — Assistente AI di Tencent

Immagina di essere a una grande festa aziendale e di volere che il tuo assistente AI partecipi a ogni conversazione, sia nei chat uno-a-uno che nelle discussioni di gruppo. È esattamente ciò che fa questa funzionalità: collega il tuo agente Hermes direttamente alla piattaforma di messaggistica Yuanbao di Tencent, così il tuo AI può inviare e ricevere messaggi in tempo reale, proprio come un collega disponibile.

Cosa Ti Serve Prima di Iniziare

Pensala come all’iscrizione in palestra: ti servono alcune cose prima:

• Un account Yuanbao con il permesso di creare bot (chiedi al tuo amministratore se non sei sicuro)
• Il tuo APP_ID e APP_SECRET personali (come nome utente e password per il tuo bot)
• I pacchetti Python installati sul tuo computer

Esegui questo comando per installare tutto:

pip install websockets httpx aiofiles

Passo 1: Crea il Tuo Bot

Per prima cosa, scarica l’app Yuanbao da https://yuanbao.tencent.com/. Una volta dentro:

1. Vai su PAI → Il Mio Bot
2. Clicca su “Crea Nuovo Bot”
3. Dopo averlo creato, copia il tuo APP_ID e APP_SECRET—conservali al sicuro, come il PIN del bancomat!

Passo 2: Lascia che la Procedura Guidata Faccia il Lavoro

Hermes ha un assistente magico che configura tutto per te. Basta digitare:

hermes gateway setup

Quando ti chiede, seleziona Yuanbao. La procedura guidata:

• Ti chiederà il tuo APP_ID
• Ti chiederà il tuo APP_SECRET
• Salverà tutto automaticamente

Consiglio da pro: Non devi preoccuparti degli URL WebSocket o dei domini API—sono già precompilati con impostazioni intelligenti. Devi solo fornire quelle due chiavi.

Passo 3: Ricontrolla le Tue Impostazioni

Dopo che la procedura guidata finisce, guarda il tuo file di configurazione in ~/.hermes/.env. Dovresti vedere qualcosa del genere:

YUANBAO_APP_ID=il_tuo_app_id_qui
YUANBAO_APP_SECRET=il_tuo_secret_qui
YUANBAO_WS_URL=wss://default-websocket-url
YUANBAO_API_DOMAIN=https://default-api-domain

Se tutto sembra a posto, sei pronto per partire!

Cosa Rende Questo Speciale?

Yuanbao non è una semplice app di chat—è pensata per un uso professionale serio. Usa WebSocket (pensalo come una linea telefonica sempre aperta invece di scambiarsi lettere) per la consegna istantanea dei messaggi. Inoltre, supporta contenuti multimediali: immagini, file e persino messaggi vocali. Quindi il tuo AI può inviare uno screenshot, condividere un PDF o inoltrare una nota vocale, proprio come un vero compagno di squadra.

Per Concludere

Collegare Hermes a Yuanbao è come dare al tuo AI un badge aziendale: ora può partecipare alle conversazioni, rispondere alle domande e condividere file in tempo reale. L’intera configurazione richiede meno di cinque minuti e la procedura guidata gestisce le parti noiose.

Consiglio pratico per i principianti: Inizia con un test semplice—invia un messaggio al tuo bot in una chat uno-a-uno prima. Una volta che funziona, prova ad aggiungerlo a un gruppo. In questo modo, individuerai subito eventuali problemi di configurazione e acquisirai sicurezza prima di passare alla modalità “collega AI” completa. Buona automazione!

---