Połącz agenta Hermes
Dla każdego, kto uruchamia agenta Hermes na własnym komputerze i chce z nim rozmawiać z Riff Home. Agenci służą tylko do czatu: Riff nigdy nie wysyła agentowi odpowiedzi ani posta, bo zawierają tekst z sieci, a agent może wykonywać polecenia.
1. Włącz serwer API Hermesa
Na komputerze agenta dodaj te linie do ~/.hermes/.env:
| Linia | Co robi |
|---|---|
API_SERVER_ENABLED=true | Włącza serwer API, z którym rozmawia Riff (port 8642) |
API_SERVER_KEY= i długi, losowy klucz | Klucz, który wyśle Riff. Każdy, kto ma ten klucz i adres, może używać Twojego agenta |
API_SERVER_CORS_ORIGINS=chrome-extension:// i identyfikator Riffa | Wpuszcza tę kopię Riffa (krok 3 pokazuje dokładną linię) |
Dodaj API_SERVER_HOST=0.0.0.0 tylko wtedy, gdy Riff łączy się z agentem przez Twoją sieć, a nie przez tunel.
2. Uruchom ponownie gateway
Serwer API jest częścią gatewaya Hermesa. W terminalu na tamtym komputerze uruchom hermes gateway restart (albo uruchom go poleceniem hermes gateway).
- Nie
hermes serve: to uruchamia panel, a nie serwer API. - Uruchamiaj go ponownie ze zwykłego terminala. Jeśli poprosisz agenta o ponowne uruchomienie własnego gatewaya, zakończy się sesja, w której działa.
3. Dodaj go w Riffie
- W Riff Home › Models (Modele) kliknij Add (Dodaj) w Add a model app (Dodaj aplikację z modelami).
- Aplikacja: Hermes agent (Agent Hermes). Adres: gdzie odpowiada, np.
192.168.1.30:8642lub adres Twojego tuneluagent.yourdomain.com. Klucz API:API_SERVER_KEYz kroku 1. - Kliknij Save and connect (Zapisz i połącz) i zezwól na pytanie przeglądarki o ten adres.
- Karta pokazuje Connected (Połączono) i Chat with this agent (Czatuj z tym agentem). Gotowe: zobacz Czatuj ze swoim agentem.
„Brakuje jednego ustawienia”: linia z identyfikatorem rozszerzenia
Hermes pozwala każdemu z kluczem odczytać listę modeli, ale działa tylko dla rozszerzeń przeglądarki, które zna. Dlatego karta może znaleźć agenta, a każda wiadomość czatu i tak zostanie odrzucona. Riff to sprawdza i wtedy karta pokazuje Needs one setting (Brakuje jednego ustawienia) z dokładną linią, razem z identyfikatorem Riffa:
API_SERVER_CORS_ORIGINS=chrome-extension://, a po nim identyfikator Riffa.
- Skopiuj linię z karty do
~/.hermes/.env. Jeśli ta linia już tam jest, dopisz nowy identyfikator po przecinku. - Uruchom
hermes gateway restart. - Kliknij Connect (Połącz) na karcie.
Identyfikator należy do tej kopii Riffa w tej przeglądarce. Riff w innej przeglądarce albo wczytany ponownie jako nowa kopia ma własny identyfikator i potrzebuje własnego wpisu.
Dostęp z dowolnego miejsca: tunel
Tunel daje agentowi adres https bez otwierania portu na routerze. W Cloudflare Tunnel skieruj nazwę hosta na port agenta na tamtym komputerze. W ~/.cloudflared/config.yml:
hostname: agent.yourdomain.comservice: http://localhost:8642
Potem dodaj agent.yourdomain.com w Riffie jak wyżej. Agent może dalej nasłuchiwać na localhost, więc nie potrzebujesz API_SERVER_HOST. Przez tunel to, co wpisujesz, idzie przez Cloudflare do Twojego komputera.
Chroń klucz
Przy tunelu klucz to jedyny zamek między internetem a agentem, który może wykonywać polecenia na Twoim komputerze.
- Używaj długiego, losowego klucza i zmień go, jeśli mógł wyciec.
- Riff trzyma go oddzielnie od reszty ustawień, tam, gdzie mogą go czytać tylko strony Riffa. Nigdy nie trafia do kopii zapasowej ani do Copy agent log (Kopiuj dziennik agenta).
- Skróć listę poleceń, które agent może wykonywać bez pytania. Riff pokazuje prośby agenta o zgodę Czatuj ze swoim agentem, ale tylko o to, o co agent pyta.