Hermes Agent reageert niet

Eén test die het probleem halveert

Open het Hermes-dashboard en vraag de agent iets banaals dat geen tools nodig heeft. Wat er daarna gebeurt, verdeelt de vijf oorzaken in twee groepen, en bespaart je het debuggen van de verkeerde helft.

• Je krijgt een antwoord. De instantie draait en de modelprovider accepteert verzoeken. Je probleem zit in toolaanroepen of iets in de specifieke taak, niet in de opzet.
• Je krijgt een foutmelding. De provider weigert je: een ongeldige sleutel, een leeg saldo, een rate limit of een uitgefaseerde modelnaam.
• Er gebeurt helemaal niets, of de pagina laadt niet. Ofwel de instantie is down, ofwel je route ernaartoe is dat. Dat zijn verschillende storingen met verschillende oplossingen, die hieronder worden behandeld.

Draait de instance echt?

Controleer de instantie in je Flux-dashboard in plaats van op basis van de agent-UI te oordelen, want een container die in een restartlus vastzit, lijkt met tussenpozen levend. De gebruikelijke oorzaken zijn geheugen en een langlopende taak die nooit is beëindigd.

Geheugen is het eerste om te controleren als je verder gaat dan licht gebruik. De tier van 4 GB is comfortabel voor een persoonlijke agent die geplande en ad-hocwerk doet, maar gelijktijdigheid is wat RAM opslokt: meerdere taken tegelijk, een lange onderzoeksrun met een grote werkset, of een taak die bestanden downloadt en verwerkt. Als je gebruik van vorm veranderde en de agent begon te stuklopen, dan vertelt de tier van 8 GB je dat hij nodig is in plaats van dat er een defect is.

Een verwant patroon is een agent die blijft hangen in plaats van crasht. Een agentlus die wacht op een tool die nooit terugkomt, bijvoorbeeld een netwerkaanroep naar een dienst die down is, blijft oneindig hangen en lijkt precies op een dode agent. Een herstart van de instantie lost het op, en de run-geschiedenis laat meestal zien bij welke stap hij bleef hangen.

De providersleutel, het saldo en de modelnaam

Hermes werkt met je eigen sleutel, dus het meest voorkomende stilvallen komt van je AI-provider en niet van de agent. Vier storingen geven hetzelfde symptoom, en alle vier worden aan de kant van de provider opgelost:

Plak de sleutel opnieuw in in plaats van hem te lezen en te besluiten dat hij er goed uitziet. Een spatie aan het eind overleeft een visuele controle en laat elk verzoek mislukken.

Rate limits raken agents harder dan chatbots

Dit verdient een eigen sectie, omdat agents ongewoon goed zijn in het raken van limieten. Een chatassistent doet één verzoek per bericht van een mens. Een agent doet een verzoek per stap van zijn redeerlus, en een taak met meerdere stappen kan in een minuut tientallen aanroepen opleveren zonder dat je ook maar iets doet.

OpenRouter is een gangbare keuze voor Hermes en het gratis niveau maakt het effect concreet. Gratis modelvarianten, die een identifier hebben die eindigt op :free, zijn beperkt tot 20 verzoeken per minuut, en het dagelijkse tegoed is 50 verzoeken als je in de levensduur van het account minder dan $10 aan credits hebt gekocht, en loopt op naar 1000 per dag zodra je dat wel hebt. Een agent die een onderzoekstaak afwerkt kan 50 dagelijkse verzoeken in één run opmaken, waarna hij midden in de taak stopt zonder duidelijke reden.

Als je agent korte taken voltooit maar bij lange taken consequent stopt, ligt dit vrijwel zeker daaraan. De oplossing is ofwel een betaalde modelvariant, ofwel accepteren dat er een plafond is en taken klein houden. Een eenmalige opwaardering verhoogt de dagelijkse ondergrens, maar verhoogt de limiet van 20 per minuut niet, dus een zeer praatzame lus kan die limiet nog steeds raken, ongeacht wat je hebt uitgegeven.

De agent praat maar doet niets

Dit is de fout die mensen zelden goed diagnosticeren, omdat er niets foutmeldt. De agent antwoordt vloeiend, beschrijft wat hij gaat doen en doet het vervolgens gewoon niet. Er draait geen tool, er verschijnt geen bestand, er gebeurt niets buiten het gesprek.

De oorzaak is het model. Een agent werkt doordat hij het model vraagt een gestructureerde tool-aanroep te genereren, en niet elk model ondersteunt dat. Wijs Hermes naar een model zonder tool-aanroepen en je krijgt een bekwame gesprekspartner die stilletjes is ontdaan van het vermogen om te handelen. Het is niet kapot; het heeft geen handen.

Controleer of het gekozen model tool- of functieaanroepen in zijn mogelijkheden vermeldt, en geef de voorkeur aan een model dat de provider expliciet documenteert voor agentgebruik. Daarom is het goedkoopste beschikbare model voor een agent vaak een schijnbesparing: het betrouwbaar volgen van een tool-aanroepprotocol telt veel zwaarder dan de prijs per token, omdat het hele doel is dat de agent handelt.

Een mildere versie van hetzelfde probleem is een model dat tool-aanroepen ondersteunt maar dat onbetrouwbaar doet, waardoor foutieve aanroepen ontstaan die stilletjes mislukken en opnieuw worden geprobeerd. Als je agent half werkt en de runhistorie vol herhaalde pogingen voor dezelfde stap staat, probeer dan eerst een sterker model voordat je de taak de schuld geeft.

Wanneer de agent in orde is maar je hem niet kunt bereiken

Hermes wordt geleverd met een Tailscale-mesh, zodat de agent je privénetwerk kan bereiken, en veel mensen gebruiken dezelfde mesh om het dashboard te bereiken. Dat creëert een faalscenario waarbij de agent prima gezond is, zijn geplande taken nog steeds draaien, en jij simpelweg geen route naar hem hebt.

Authenticatiesleutels verlopen, en apparaatsleutels verlopen ook, dus een instance die maanden ongebruikt blijft, kan van het tailnet vallen zonder dat er iets misging. Controleer de Tailscale-beheerconsole: ontbreekt het apparaat of is het niet geautoriseerd, genereer dan een nieuwe authenticatiesleutel en verbind opnieuw. Het teken van deze oorzaak is dat geplande taken bleven draaien terwijl het dashboard onbereikbaar was.

Het omgekeerde is ook goed om te weten. Als de agent het dashboard kan bereiken maar je interne diensten niet, dan is het mesh voor jou omhoog en voor de agent omlaag, wat meestal betekent dat het apparaat zijn autorisatie is kwijtgeraakt en niet dat de diensten zijn verhuisd.

De checklist

1. Vraag de agent in het dashboard iets banaals. Een antwoord maakt in één stap duidelijk dat de instance en de provider in orde zijn.
2. Controleer de instance in je Flux-dashboard op een herstartlus, en controleer het RAM als je werkbelasting zwaarder is geworden.
3. Controleer het dashboard van de provider op een ongeldige sleutel, een leeg saldo, een ratelimiet of een uitgefaseerde modelnaam.
4. Als lange taken mislukken en korte slagen, ga dan uit van een rate limit en controleer eerst je dagelijkse limiet.
5. Als de agent praat maar nooit handelt, controleer dan of het gekozen model tool-aanroepen ondersteunt.
6. Als het dashboard onbereikbaar is maar geplande taken gewoon bleven draaien, controleer dan Tailscale op een verlopen apparaat of authenticatiesleutel.

Bijna elk geval komt uit bij stap één, drie of vijf. Een agent heeft meer storingspunten dan een chatassistent omdat hij meer doet, en elk punt laat een ander spoor achter.