Hermes Agent non risponde

Un test che dimezza il problema

Apri la dashboard di Hermes e chiedi all'agente qualcosa di banale che non richieda strumenti. Quello che succede dopo divide le cinque cause in due gruppi, e ti evita di fare il debug sulla metà sbagliata.

• Ottieni una risposta. L'istanza è in esecuzione e il fornitore del modello accetta richieste. Il problema è nel tool calling o in qualcosa del compito specifico, non nella configurazione.
• Ricevi un errore. Il provider ti sta rifiutando: una chiave non valida, un saldo vuoto, un limite di frequenza o un nome di modello ritirato.
• Non succede nulla, oppure la pagina non si carica. O l'istanza è giù o il tuo percorso verso di essa lo è. Sono guasti diversi con soluzioni diverse, spiegate sotto.

L'istanza è davvero in esecuzione?

Controlla l'istanza nella tua dashboard di Flux invece di giudicare dall'interfaccia dell'agente, perché un container bloccato in un restart loop sembra vivo a intermittenza. Le cause più comuni sono la memoria e un compito di lunga durata che non è mai terminato.

La memoria è quella da controllare per prima se sei andato oltre l'uso leggero. Il piano da 4 GB è adeguato per un agente personale che fa lavori pianificati e occasionali, ma a consumare RAM è la concorrenza: più compiti insieme, una lunga ricerca multi-passaggio che tiene un grande set di lavoro, o un compito che scarica ed elabora file. Se il tuo uso è cambiato e l'agente ha iniziato a morire, è il piano da 8 GB che ti sta dicendo che serve, non un difetto.

Un caso correlato è un agente che si blocca invece di crashare. Un ciclo dell'agente in attesa di uno strumento che non risponde mai, ad esempio una chiamata di rete a un servizio che è giù, resta lì a tempo indeterminato e sembra identico a un agente morto. Riavviare l'istanza lo risolve, e la cronologia delle esecuzioni di solito mostra su quale passaggio si è fermato.

La chiave del provider, il saldo e il nome del modello

Hermes usa la tua chiave, quindi il silenzio più comune nasce dal tuo provider AI e non dall'agente. Quattro guasti producono lo stesso sintomo, e tutti e quattro si risolvono dal lato del provider:

Reincolla la chiave invece di leggerla e decidere che sembra corretta. Uno spazio finale sfugge al controllo visivo e fa fallire ogni richiesta.

I limiti di frequenza colpiscono gli agenti più dei chatbot

Questo merita una sezione a sé perché gli agenti colpiscono i limiti con una facilità insolita. Un assistente chat fa una richiesta per ogni messaggio umano. Un agente fa una richiesta per ogni passaggio del suo ciclo di ragionamento, e un compito multi-passaggio può produrre decine di chiamate in un minuto senza che tu faccia nulla.

OpenRouter è una scelta comune per Hermes e il suo piano gratuito rende l'effetto concreto. I modelli gratuiti, quelli il cui identificatore termina con :free, sono limitati a 20 richieste al minuto, e il limite giornaliero è di 50 richieste se hai acquistato meno di $10 di crediti nella vita dell'account, salendo a 1000 al giorno una volta superata quella soglia. Un agente che lavora su un compito di ricerca può esaurire 50 richieste giornaliere in una sola esecuzione, e a quel punto si ferma a metà del compito senza una spiegazione evidente.

Se il tuo agente completa i compiti brevi e muore sistematicamente su quelli lunghi, quasi certamente è questo il motivo. La soluzione è una variante di modello a pagamento, oppure accettare il limite e tenere i compiti piccoli. Una ricarica una tantum alza il minimo giornaliero, ma non alza il limite al minuto, quindi un loop molto loquace può comunque raggiungere 20 al minuto qualunque sia la cifra spesa.

L'agente parla ma non agisce mai

È un problema che raramente viene diagnosticato correttamente, perché non c'è nessun errore. L'agente risponde con scioltezza, descrive cosa sta per fare, e poi semplicemente non lo fa. Nessuno strumento parte, nessun file compare, niente succede fuori dalla conversazione.

La causa è il modello. Un agente funziona chiedendo al modello di emettere una chiamata a uno strumento in forma strutturata, e non tutti i modelli lo supportano. Se punti Hermes a un modello senza tool calling ottieni un ottimo interlocutore conversazionale a cui è stata silenziosamente tolta la capacità di agire. Non è rotto: non ha le mani.

Verifica che il modello scelto elenchi il tool calling o function calling tra le sue capacità, e preferisci un modello che il provider documenta esplicitamente per l'uso con agenti. È anche il motivo per cui il modello meno caro è spesso un falso risparmio per un agente: quando lo scopo è far eseguire l'agente, la capacità di seguire un protocollo di tool calling in modo affidabile conta molto più del prezzo grezzo per token.

Una versione più sottile dello stesso problema è un modello che supporta il tool calling ma lo fa in modo inaffidabile, producendo chiamate malformate che falliscono in silenzio e vengono ritentate. Se il tuo agente funziona a metà e la cronologia delle esecuzioni è piena di tentativi ripetuti dello stesso passaggio, prova un modello più forte prima di pensare che il problema sia il compito.

Quando l'agente sta bene e tu non riesci a raggiungerlo

Hermes include un mesh Tailscale così l'agente può raggiungere la tua rete privata, e molte persone usano lo stesso mesh per raggiungere la dashboard. Questo crea una modalità di guasto in cui l'agente è perfettamente in salute, i suoi compiti pianificati girano ancora, e tu semplicemente non hai un percorso per raggiungerlo.

Anche le chiavi di autenticazione scadono, e scadono anche le chiavi dei dispositivi, quindi un'istanza non toccata per mesi può uscire dalla tailnet senza che sia successo nulla di grave. Controlla la console di amministrazione di Tailscale: se il dispositivo manca o non è autorizzato, genera una nuova chiave di autenticazione e riconnettilo. Il segnale che indica questa causa è che i lavori pianificati hanno continuato a girare mentre la dashboard era irraggiungibile.

Vale la pena conoscere anche l'immagine speculare. Se l'agente raggiunge la dashboard ma non i tuoi servizi interni, la mesh è attiva per te e non per lui, il che di solito significa che il dispositivo ha perso l'autorizzazione e non che i servizi si sono spostati.

La checklist

1. Chiedi all'agente qualcosa di banale nella dashboard. Una risposta sblocca in un colpo solo l'istanza e il provider.
2. Controlla l'istanza nella tua dashboard di Flux per un restart loop, e controlla la RAM se il tuo carico di lavoro è diventato più pesante.
3. Controlla la dashboard del provider per una chiave non valida, un saldo vuoto, un limite di frequenza o un nome di modello ritirato.
4. Se i compiti lunghi falliscono e quelli brevi riescono, presumi un limite di frequenza e controlla prima di tutto la tua quota giornaliera.
5. Se l'agente parla ma non agisce mai, verifica che il modello selezionato supporti il tool calling.
6. Se la dashboard è irraggiungibile ma i lavori pianificati hanno continuato a girare, controlla in Tailscale se c'è un dispositivo scaduto o una chiave di autenticazione scaduta.

Quasi tutti i casi cadono nei passaggi uno, tre o cinque. Un agente ha più punti di guasto di un assistente chat perché fa di più, e ognuno lascia un'impronta diversa.