Hermes Agent no responde

Una prueba que reduce el problema a la mitad

Abre el panel de Hermes y pregúntale al agente algo trivial que no necesite herramientas. Lo que ocurra a continuación divide las cinco causas en dos grupos y te evita depurar la mitad equivocada.

• Obtienes una respuesta. La instancia está en ejecución y el proveedor del modelo acepta solicitudes. Tu problema es la llamada a herramientas o algo de la tarea concreta, no la configuración.
• Obtienes un error. El proveedor te rechaza: una clave no válida, un saldo vacío, un límite de uso o un nombre de modelo retirado.
• No pasa nada en absoluto, o la página no carga. O la instancia está caída o lo está tu ruta hasta ella. Son fallos distintos con soluciones distintas, que se explican más abajo.

¿Está la instancia realmente en ejecución?

Revisa la instancia en tu panel de Flux en lugar de juzgar por la interfaz del agente, porque un contenedor atascado en un bucle de reinicios parece estar vivo de forma intermitente. Las causas habituales son la memoria y una tarea de larga duración que nunca terminó.

La memoria es lo primero que conviene revisar si pasaste de un uso ligero. El nivel de 4 GB es cómodo para un agente personal con trabajo programado y puntual, pero la concurrencia es lo que consume RAM: varias tareas a la vez, una ejecución de investigación larga de varios pasos con un conjunto de trabajo grande, o una tarea que descarga y procesa archivos. Si tu uso cambió de forma y el agente empezó a caerse, es el nivel de 8 GB diciéndote que lo necesitas, no un defecto.

Un patrón relacionado es un agente que se cuelga en lugar de fallar. Un bucle de agente que espera una herramienta que nunca responde, por ejemplo una llamada de red a un servicio caído, se quedará ahí indefinidamente y parecerá idéntico a un agente muerto. Reiniciar la instancia lo soluciona, y el historial de ejecuciones suele mostrar en qué paso se detuvo.

La clave del proveedor, el saldo y el nombre del modelo

Hermes funciona con tu propia clave, así que el silencio más común se origina en tu proveedor de IA y no en el agente. Cuatro fallos producen el mismo síntoma y los cuatro se arreglan en el lado del proveedor:

Vuelve a pegar la clave en lugar de leerla y decidir que parece correcta. Un espacio al final pasa una revisión visual y falla en todas las solicitudes.

Los límites de uso muerden más a los agentes que a los chatbots

Esto merece su propia sección porque los agentes son especialmente buenos alcanzando límites. Un asistente de chat hace una solicitud por mensaje humano. Un agente hace una solicitud por cada paso de su bucle de razonamiento, y una tarea de varios pasos puede producir decenas de llamadas en un minuto sin que hagas nada.

OpenRouter es una opción habitual para Hermes y su nivel gratuito hace tangible el efecto. Las variantes gratuitas de modelos, aquellas cuyo identificador termina en :free, están limitadas a 20 solicitudes por minuto, y la cuota diaria es de 50 solicitudes si has comprado menos de $10 en créditos a lo largo de la vida de la cuenta, subiendo a 1000 al día una vez que lo has hecho. Un agente que trabaja en una tarea de investigación puede agotar 50 solicitudes diarias en una sola ejecución, momento en el que se detiene a mitad de tarea sin ninguna explicación evidente.

Si tu agente completa tareas cortas y muere sistemáticamente en las largas, casi seguro es por esto. La solución es una variante de pago del modelo, o aceptar el límite y mantener las tareas pequeñas. Una recarga puntual es lo que mueve el mínimo diario; no eleva el tope por minuto, así que un bucle muy activo puede seguir alcanzando 20 por minuto sin importar lo que hayas gastado.

El agente habla pero nunca actúa

Este es el fallo que la gente rara vez diagnostica bien, porque nada da error. El agente responde con fluidez, describe lo que va a hacer y simplemente no lo hace. No se ejecuta ninguna herramienta, no aparece ningún archivo, no ocurre nada fuera de la conversación.

La causa es el modelo. Un agente funciona pidiendo al modelo que emita una llamada a herramienta estructurada, y no todos los modelos lo admiten. Apunta Hermes a un modelo sin llamada a herramientas y obtendrás un interlocutor conversacional competente al que se le ha quitado en silencio la capacidad de actuar. No está roto; no tiene manos.

Comprueba que el modelo que seleccionaste enumera la llamada a herramientas o funciones entre sus capacidades, y prefiere un modelo que el proveedor documente explícitamente para uso con agentes. Por eso mismo el modelo más barato disponible suele ser una falsa economía para un agente: la capacidad de seguir con fiabilidad un protocolo de llamada a herramientas importa mucho más que el precio bruto por token cuando el objetivo es precisamente que el agente ejecute.

Una versión más suave del mismo problema es un modelo que admite llamada a herramientas pero lo hace de forma poco fiable, produciendo llamadas mal formadas que fallan en silencio y se reintentan. Si tu agente funciona a medias y el historial de ejecuciones está lleno de intentos repetidos del mismo paso, prueba un modelo más potente antes de suponer que la tarea es la culpable.

Cuando el agente está bien y no puedes llegar a él

Hermes incluye una malla de Tailscale para que el agente pueda llegar a tu red privada, y muchas personas usan esa misma malla para acceder al panel. Eso crea un modo de fallo en el que el agente está perfectamente sano, sus tareas programadas siguen ejecutándose y simplemente no tienes ruta hasta él.

Las claves de autenticación caducan, y las claves de dispositivo también, así que una instancia sin tocar durante meses puede salirse del tailnet sin que haya ido mal nada. Revisa la consola de administración de Tailscale: si el dispositivo falta o no está autorizado, genera una nueva clave de autenticación y vuelve a conectar. La señal de esta causa es que el trabajo programado seguía ocurriendo mientras el panel era inaccesible.

También conviene conocer la imagen especular. Si el agente puede acceder al panel pero no a tus servicios internos, la malla está activa para ti y caída para él, lo que normalmente significa que el dispositivo perdió su autorización y no que los servicios se hayan movido.

La lista de comprobación

1. Pregúntale algo trivial al agente en el panel. Una respuesta descarta la instancia y el proveedor de un solo golpe.
2. Revisa la instancia en tu panel de Flux por si hay un bucle de reinicios, y revisa la RAM si tu carga de trabajo se volvió más pesada.
3. Revisa el panel del proveedor por una clave no válida, un saldo vacío, un límite de uso o un nombre de modelo retirado.
4. Si las tareas largas fallan y las cortas funcionan, supón un límite de uso y comprueba tu cuota diaria antes que nada.
5. Si el agente habla pero nunca actúa, confirma que el modelo seleccionado admite llamada a herramientas.
6. Si el panel no es accesible pero las tareas programadas siguen ejecutándose, revisa en Tailscale si hay un dispositivo o una clave de autenticación caducados.

Casi todos los casos acaban en los pasos uno, tres o cinco. Un agente tiene más puntos de fallo que un asistente de chat porque hace más cosas, y cada uno deja una huella distinta.