Agent Hermes nie odpowiada

Jeden test, który rozwiązuje połowę problemu

Otwórz panel Hermesa i zapytaj agenta o coś banalnego, co nie wymaga narzędzi. To, co się wydarzy dalej, dzieli pięć przyczyn na dwie grupy i oszczędza debugowania niewłaściwej połowy.

• Dostajesz odpowiedź. Instancja działa, a dostawca modelu przyjmuje żądania. Problem leży w wywoływaniu narzędzi albo w konkretnym zadaniu, a nie w konfiguracji.
• Otrzymujesz błąd. Dostawca odrzuca żądanie: nieprawidłowy klucz, puste saldo, limit zapytań albo wycofana nazwa modelu.
• Nic się nie dzieje albo strona się nie ładuje. Albo instancja nie działa, albo Twoja droga do niej jest przerwana. To różne usterki z różnymi naprawami, opisanymi poniżej.

Czy instancja naprawdę działa?

Sprawdź instancję w panelu Flux, zamiast oceniać ją po interfejsie agenta, bo kontener zawieszony w pętli restartów wygląda na przerywanie żywy. Typowe przyczyny to pamięć i długie zadanie, które nigdy się nie zakończyło.

Pamięć to pierwsza rzecz warta sprawdzenia, jeśli wykraczasz poza lekkie użycie. Poziom 4 GB jest wygodny dla osobistego agenta wykonującego zadania zaplanowane i doraźne, ale zużycie RAM napędza równoległość: kilka zadań naraz, długi wieloetapowy przebieg badawczy z dużym zbiorem roboczym albo zadanie pobierające i przetwarzające pliki. Jeśli Twoje użycie się zmieniło i agent zaczął padać, to poziom 8 GB mówi, że jest potrzebny, a nie że to błąd.

Pokrewny wzorzec to agent, który się zawiesza zamiast się wywalać. Pętla agenta czekająca na narzędzie, które nigdy nie odpowie, na przykład na wywołanie sieciowe do usługi, która nie działa, będzie tkwić w tym stanie w nieskończoność i będzie wyglądać identycznie jak martwy agent. Restart instancji go czyści, a historia uruchomień zwykle pokazuje, na którym kroku się zatrzymał.

Klucz dostawcy, saldo i nazwa modelu

Hermes działa na własnym kluczu, więc najczęstsza cisza bierze się u dostawcy AI, a nie w agencie. Cztery awarie dają ten sam objaw, a wszystkie cztery naprawia się po stronie dostawcy:

Wklej klucz ponownie, zamiast go czytać i uznawać, że wygląda dobrze. Spacja na końcu przetrwa wizualne sprawdzenie, ale każde zapytanie się wysypie.

Limity zapytań bardziej uderzają w agentów niż w chatboty

To zasługuje na osobną sekcję, bo agenci są wyjątkowo dobrzy w trafianiu w limity. Asystent czatu wysyła jedno zapytanie na wiadomość człowieka. Agent wysyła zapytanie na każdy krok pętli rozumowania, a wieloetapowe zadanie może wygenerować dziesiątki wywołań w minutę, bez żadnego działania z Twojej strony.

OpenRouter to częsty wybór dla Hermes, a jego darmowy poziom dobrze pokazuje efekt. Warianty darmowe, te, których identyfikator kończy się na :free, są ograniczone do 20 żądań na minutę, a dzienny limit wynosi 50 żądań, jeśli kupiłeś mniej niż $10 kredytów w całym okresie istnienia konta, i wzrasta do 1000 dziennie, gdy już je masz. Agent pracujący nad zadaniem badawczym może wyczerpać 50 dziennych żądań w jednym uruchomieniu, a wtedy zatrzymuje się w połowie zadania bez oczywistego wyjaśnienia.

Jeśli Twój agent kończy krótkie zadania, ale zawsze pada przy długich, to prawie na pewno właśnie dlatego. Rozwiązaniem jest albo płatny wariant modelu, albo zaakceptowanie limitu i utrzymywanie małych zadań. Jednorazowe doładowanie zmienia dzienne minimum, ale nie podnosi limitu na minutę, więc bardzo gadatliwa pętla może nadal trafić w 20 na minutę, bez względu na to, ile wydasz.

Agent rozmawia, ale nigdy nie działa

To błąd, który ludzie rzadko diagnozują poprawnie, bo nic nie zwraca błędu. Agent płynnie odpowiada, opisuje, co zamierza zrobić, a potem po prostu tego nie robi. Nie uruchamia się żadne narzędzie, nie pojawia się żaden plik, nic nie dzieje się poza rozmową.

Przyczyna leży w modelu. Agent działa, prosząc model o wygenerowanie ustrukturyzowanego wywołania narzędzia, a nie każdy model to obsługuje. Wskaż Hermesowi model bez wywoływania narzędzi, a dostaniesz kompetentnego rozmówcę, któremu po cichu odebrano zdolność działania. Nie jest zepsuty, po prostu nie ma rąk.

Sprawdź, czy wybrany model wymienia wywoływanie narzędzi lub funkcji wśród swoich możliwości, i wybieraj model, który dostawca wyraźnie opisuje jako przeznaczony dla agentów. Dlatego najtańszy dostępny model bywa dla agenta fałszywą oszczędnością: zdolność do niezawodnego trzymania się protokołu wywołań narzędzi znacznie bardziej się liczy niż surowa cena za token, skoro cała idea polega na tym, że agent działa.

Łagodniejsza wersja tego samego problemu to model, który obsługuje wywoływanie narzędzi, ale robi to zawodnie, generując błędne wywołania, które cicho zawodzą i są ponawiane. Jeśli agent działa w połowie, a historia uruchomień jest pełna powtarzanych prób tego samego kroku, wypróbuj mocniejszy model, zanim uznasz, że wina leży w zadaniu.

Gdy agent działa, ale nie masz do niego dostępu

Hermes ma wbudowaną siatkę Tailscale, dzięki której agent może dotrzeć do Twojej prywatnej sieci, a wielu ludzi używa tej samej siatki, by dotrzeć do panelu. Stąd bierze się tryb awarii, w którym agent jest w pełni sprawny, jego zaplanowane zadania nadal działają, a Ty po prostu nie masz do niego drogi.

Klucze autoryzacyjne wygasają, a klucze urządzeń też, więc instancja nieruszana przez miesiące może wypaść z tailnetu bez żadnej winy. Sprawdź konsolę administracyjną Tailscale: jeśli urządzenia brakuje lub nie jest autoryzowane, wygeneruj nowy klucz autoryzacyjny i połącz się ponownie. Wskazówką dla tej przyczyny jest to, że zaplanowana praca działała dalej, gdy panel był nieosiągalny.

Odwrotność też warto znać. Jeśli agent może dotrzeć do panelu, ale nie do twoich usług wewnętrznych, mesh działa dla ciebie, a dla niego nie, co zwykle oznacza, że urządzenie straciło autoryzację, a nie że usługi się przeniosły.

Lista kontrolna

1. Zapytaj agenta o coś banalnego w panelu. Odpowiedź potwierdza za jednym razem, że instancja i dostawca działają.
2. Sprawdź instancję w panelu Flux pod kątem pętli restartów, a jeśli obciążenie wzrosło, sprawdź RAM.
3. Sprawdź panel dostawcy pod kątem nieprawidłowego klucza, pustego salda, limitu żądań lub wycofanej nazwy modelu.
4. Jeśli długie zadania się nie udają, a krótkie działają, zakładaj limit zapytań i sprawdź najpierw swój dzienny limit.
5. Jeśli agent rozmawia, ale nigdy nie działa, sprawdź, czy wybrany model obsługuje wywoływanie narzędzi.
6. Jeśli panel jest nieosiągalny, a zaplanowane zadania dalej działają, sprawdź w Tailscale, czy urządzenie lub klucz autoryzacyjny nie wygasły.

Prawie każdy przypadek sprowadza się do kroku pierwszego, trzeciego lub piątego. Agent ma więcej punktów awarii niż asystent czatu, bo robi więcej, a każdy z nich zostawia inny ślad.