Przejdź do treści
PL
Dodaj do Chrome

Połącz agenta Hermes

PoradnikNowość

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.

Dodaj agenta, wpisz do jego .env linię z karty, uruchom ponownie gateway i gotowe.

1. Włącz serwer API Hermesa

Na komputerze agenta dodaj te linie do ~/.hermes/.env:

LiniaCo robi
API_SERVER_ENABLED=trueWłącza serwer API, z którym rozmawia Riff (port 8642)
API_SERVER_KEY= i długi, losowy kluczKlucz, 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 RiffaWpuszcza 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

  1. W Riff Home › Models (Modele) kliknij Add (Dodaj) w Add a model app (Dodaj aplikację z modelami).
  2. Aplikacja: Hermes agent (Agent Hermes). Adres: gdzie odpowiada, np. 192.168.1.30:8642 lub adres Twojego tunelu agent.yourdomain.com. Klucz API: API_SERVER_KEY z kroku 1.
  3. Kliknij Save and connect (Zapisz i połącz) i zezwól na pytanie przeglądarki o ten adres.
  4. 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.

  1. Skopiuj linię z karty do ~/.hermes/.env. Jeśli ta linia już tam jest, dopisz nowy identyfikator po przecinku.
  2. Uruchom hermes gateway restart.
  3. 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.com
  • service: 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.