Einen Hermes-Agenten verbinden
Für alle, die einen Hermes-Agenten auf einem eigenen Rechner betreiben und aus Riff Home mit ihm sprechen möchten. Agenten sind nur für den Chat: Riff schickt nie eine Antwort oder einen Beitrag an einen Agenten, denn die enthalten Text aus dem Web, und ein Agent kann Befehle ausführen.
1. Den API-Server von Hermes einschalten
Füge auf dem Rechner des Agenten diese Zeilen zu ~/.hermes/.env hinzu:
| Zeile | Was sie tut |
|---|---|
API_SERVER_ENABLED=true | Schaltet den API-Server ein, mit dem Riff spricht (Port 8642) |
API_SERVER_KEY= und ein langer Zufallsschlüssel | Der Schlüssel, den Riff sendet. Wer diesen Schlüssel und die Adresse hat, kann deinen Agenten nutzen |
API_SERVER_CORS_ORIGINS=chrome-extension:// und Riffs ID | Lässt diese Kopie von Riff herein (Schritt 3 zeigt die genaue Zeile) |
Füge API_SERVER_HOST=0.0.0.0 nur hinzu, wenn Riff den Agenten über dein Netzwerk erreicht und nicht über einen Tunnel.
2. Das Gateway neu starten
Der API-Server ist Teil des Hermes-Gateways. Führe in einem Terminal auf diesem Rechner hermes gateway restart aus (oder starte es mit hermes gateway).
- Nicht
hermes serve: Das startet das Dashboard, nicht den API-Server. - Starte es in einem normalen Terminal neu. Bittest du den Agenten, sein eigenes Gateway neu zu starten, endet die Sitzung, in der er gerade läuft.
3. In Riff hinzufügen
- Klicke in Riff Home › Models (Modelle) bei Add a model app (Modell-App hinzufügen) auf Add (Hinzufügen).
- App: Hermes agent (Hermes-Agent). Adresse: wo er antwortet, etwa
192.168.1.30:8642oder die deines Tunnels,agent.yourdomain.com. API-Schlüssel: derAPI_SERVER_KEYaus Schritt 1. - Klicke auf Save and connect (Speichern und verbinden) und erlaube die Frage des Browsers zu dieser Adresse.
- Die Karte zeigt Connected (Verbunden) und Chat with this agent (Mit diesem Agenten chatten). Fertig: siehe Mit deinem Agenten chatten.
„Eine Einstellung fehlt“: die Zeile mit der Erweiterungs-ID
Hermes lässt jeden mit dem Schlüssel seine Modellliste lesen, handelt aber nur für Browsererweiterungen, die es kennt. Deshalb kann die Karte den Agenten finden, während jede Chatnachricht abgelehnt wird. Riff prüft das, und die Karte zeigt dann Needs one setting (Eine Einstellung fehlt) mit der genauen Zeile, samt Riffs eigener ID:
API_SERVER_CORS_ORIGINS=chrome-extension:// gefolgt von Riffs ID.
- Kopiere die Zeile von der Karte in
~/.hermes/.env. Steht die Zeile schon da, füge die neue ID nach einem Komma an. - Führe
hermes gateway restartaus. - Klicke auf der Karte auf Connect (Verbinden).
Die ID gehört zu dieser Kopie von Riff in diesem Browser. Riff in einem anderen Browser, oder neu als neue Kopie geladen, hat eine eigene ID und braucht einen eigenen Eintrag.
Von überall erreichbar: ein Tunnel
Ein Tunnel gibt dem Agenten eine https-Adresse, ohne einen Port an deinem Router zu öffnen. Leite mit einem Cloudflare Tunnel einen Hostnamen auf den Port des Agenten auf diesem Rechner. In ~/.cloudflared/config.yml:
hostname: agent.yourdomain.comservice: http://localhost:8642
Füge dann agent.yourdomain.com wie oben in Riff hinzu. Der Agent kann weiter auf localhost lauschen, also brauchst du API_SERVER_HOST nicht. Über einen Tunnel läuft, was du tippst, über Cloudflare zu deinem Rechner.
Den Schlüssel schützen
Bei einem Tunnel ist der Schlüssel das einzige Schloss zwischen dem Internet und einem Agenten, der auf deinem Rechner Befehle ausführen kann.
- Verwende einen langen Zufallsschlüssel und ändere ihn, falls er bekannt geworden sein könnte.
- Riff hält ihn getrennt von deinen übrigen Einstellungen, wo nur Riffs eigene Seiten ihn lesen können. Er ist nie in einer Sicherung oder in Copy agent log (Agenten-Protokoll kopieren).
- Kürze die Liste der Befehle, die der Agent ohne Nachfrage ausführen darf. Riff zeigt die Freigabeanfragen des Agenten Mit deinem Agenten chatten, aber nur für das, wonach der Agent fragt.