Collega un agente Hermes
Per chi fa girare un agente Hermes su un proprio computer e vuole parlarci da Riff Home. Gli agenti servono solo per la Chat: Riff non invia mai a un agente una risposta o un post, perché contengono testo preso dal web e un agente può eseguire comandi.
1. Attiva il server API di Hermes
Sul computer dell’agente, aggiungi queste righe a ~/.hermes/.env:
| Riga | Cosa fa |
|---|---|
API_SERVER_ENABLED=true | Attiva il server API con cui parla Riff (porta 8642) |
API_SERVER_KEY= e una chiave lunga e casuale | La chiave che invierà Riff. Chiunque abbia questa chiave e l’indirizzo può usare il tuo agente |
API_SERVER_CORS_ORIGINS=chrome-extension:// e l’ID di Riff | Fa entrare questa copia di Riff (il passaggio 3 mostra la riga esatta) |
Aggiungi API_SERVER_HOST=0.0.0.0 solo se Riff raggiunge l’agente attraverso la tua rete e non tramite un tunnel.
2. Riavvia il gateway
Il server API fa parte del gateway di Hermes. Da un terminale su quel computer, esegui hermes gateway restart (o avvialo con hermes gateway).
- Non
hermes serve: quello avvia la dashboard, non il server API. - Riavvialo da un terminale normale. Se chiedi all’agente di riavviare il proprio gateway, la sessione in cui sta lavorando si chiude.
3. Aggiungilo in Riff
- In Riff Home › Models (Modelli), fai clic su Add (Aggiungi) in Add a model app (Aggiungi un’app di modelli).
- App: Hermes agent (Agente Hermes). Indirizzo: dove risponde, come
192.168.1.30:8642o quello del tuo tunnel,agent.yourdomain.com. Chiave API: laAPI_SERVER_KEYdel passaggio 1. - Fai clic su Save and connect (Salva e collega) e consenti la richiesta del browser per quell’indirizzo.
- La scheda mostra Connected (Collegato) e Chat with this agent (Chatta con questo agente). Fatto: vedi Chatta con il tuo agente.
“Serve un’impostazione”: la riga con l’ID dell’estensione
Hermes lascia leggere l’elenco dei modelli a chiunque abbia la chiave, ma agisce solo per le estensioni del browser che conosce. Per questo la scheda può trovare l’agente mentre ogni messaggio della chat viene rifiutato. Riff lo controlla, e la scheda mostra allora Needs one setting (Serve un’impostazione) con la riga esatta, compreso l’ID di Riff:
API_SERVER_CORS_ORIGINS=chrome-extension:// seguito dall’ID di Riff.
- Copia la riga dalla scheda in
~/.hermes/.env. Se la riga c’è già, aggiungi il nuovo ID dopo una virgola. - Esegui
hermes gateway restart. - Fai clic su Connect (Collega) nella scheda.
L’ID appartiene a questa copia di Riff in questo browser. Riff in un altro browser, o ricaricato come nuova copia, ha un suo ID e ha bisogno di una sua voce.
Raggiungilo da ovunque: un tunnel
Un tunnel dà all’agente un indirizzo https senza aprire porte sul router. Con un Cloudflare Tunnel, indirizza un nome host alla porta dell’agente su quel computer. In ~/.cloudflared/config.yml:
hostname: agent.yourdomain.comservice: http://localhost:8642
Poi aggiungi agent.yourdomain.com in Riff come sopra. L’agente può restare in ascolto su localhost, quindi non ti serve API_SERVER_HOST. Con un tunnel, ciò che scrivi passa da Cloudflare fino al tuo computer.
Proteggi la chiave
Con un tunnel, la chiave è l’unica serratura tra internet e un agente che può eseguire comandi sul tuo computer.
- Usa una chiave lunga e casuale, e cambiala se potrebbe essere trapelata.
- Riff la tiene separata dalle altre impostazioni, dove solo le pagine di Riff possono leggerla. Non finisce mai in un backup né in Copy agent log (Copia il registro dell’agente).
- Riduci l’elenco dei comandi che l’agente può eseguire senza chiedere. Riff mostra le richieste di approvazione dell’agente Chatta con il tuo agente, ma solo per ciò che l’agente chiede.