Monitorea un agente de IA o un job de LLM programados
Cada vez más jobs programados llaman a un modelo de IA: un resumen nocturno de los tickets de ayer, un agente que clasifica el correo entrante, un script que pide a un modelo que categorice filas nuevas. Se ejecutan sin supervisión, así que cuando uno deja de funcionar nadie lo nota hasta que alguien pregunta dónde está el informe.
Por qué los jobs de IA fallan en silencio
Un job de IA es un script programado normal con un paso frágil en medio: una llamada a la API de un modelo. Ese paso falla de formas que un programador de tareas no puede ver:
- La API está ocupada o alcanzaste un límite. Los proveedores de modelos devuelven errores como “rate limit” (429) u “overloaded” (529, en la API de Claude). Muchos scripts capturan el error, lo anotan en el log y terminan con normalidad.
- Se acabó la cuota o el crédito. Tanto la documentación de la API de OpenAI como la de Claude dicen que estos errores siguen fallando hasta que añades crédito o subes el límite; reintentar no sirve. Un job que reintenta en silencio puede fallar cada noche durante semanas.
- La respuesta está vacía. Un desarrollador describe un agente que devolvía el código de salida 0 con una respuesta vacía cuando se le acabó la cuota, así que todo lo que lo rodeaba trataba la ejecución como un éxito (DEV Community, 2026).
- El job nunca arrancó. Una clave de API que falta en el entorno del programador, otro shell, una máquina suspendida: SD Times lo llama el caso más común, “tus agentes no están fallando, no se están ejecutando” (2026).
Las herramientas de trazas y el panel del proveedor muestran las llamadas que ocurrieron. Ninguno te dice nada de la ejecución que no ocurrió, ni de la ejecución que “funcionó” y no produjo nada.
Deja que el job informe de su propia ejecución
Añade unas pocas líneas al script: un ping cuando empieza, un ping cuando termina y un ping de fallo con el mensaje de error cuando falla la llamada al modelo (o cualquier otra cosa). TaskBeacon conoce el horario, así que también se da cuenta cuando no llega ningún ping.
# --- TaskBeacon: top of the script (standard library only) ---
import json, traceback, urllib.request
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
# --- your code here ---
df = [1, 2, 3] # example data: replace with your own (e.g. pandas.read_csv)
except Exception as e:
# the error and the last 20 lines of the traceback go with the failure
tb_ping("/fail", {"error": f"{type(e).__name__}: {e}"[:200],
"log": "\n".join(traceback.format_exc().splitlines()[-20:])[-4000:]})
raise
# --- TaskBeacon: end of the script ---
tb_ping("", {"rows": len(df)})En la app, la pestaña Code (código) de tu job te da este código con la dirección propia del job en lugar de your-job-id, y puedes desmarcar las partes que no necesites.
Después añade un número que diga que el job hizo su tarea, por ejemplo cuántos elementos resumió o clasificó, o la longitud de la respuesta. Una regla sobre ese número convierte una ejecución que terminó sin nada en Odd data (datos raros): consulta alerta ante una respuesta vacía o demasiado corta.
¿Prefieres no editar el script tú mismo? En la pestaña Code (código) de tu job, haz clic en Copy prompt for your AI (copiar el prompt para tu IA). Copia un mensaje listo con las líneas de tu propio job; pégalo en ChatGPT, Claude o Copilot, añade tu script al final, y el asistente te devuelve el script con los pings en su sitio. Lee el resultado antes de ejecutarlo.
Qué obtienes
- Failed (fallido) con el texto del error, cuando la llamada a la API falla y el script lo informa.
- Missed (no ejecutado) cuando el job no se ejecutó a su hora, incluidas las noches en que nunca arrancó.
- Late (retrasado) cuando una ejecución se queda colgada, por ejemplo en una llamada al modelo que nunca responde.
- Odd data cuando terminó pero el número que envías es 0 o está muy por debajo de lo habitual.
Sin TaskBeacon
Haz que el job falle de forma visible: no te tragues los errores de la API, termina con un código distinto de cero cuando falle la llamada al modelo o la respuesta esté vacía, y deja que las alertas del propio programador lo notifiquen. Configura una alerta de gasto en el proveedor para que se note una cuota agotada. Para las ejecuciones que nunca arrancan sigues necesitando algo fuera del job que sepa cuándo debería haberse ejecutado, que es la parte que un script no puede hacer por sí mismo.
¿Conectaste Claude o ChatGPT a TaskBeacon? Pregúntale “¿qué falló anoche y por qué?” y te responde a partir de tus jobs. Cómo funciona.
Relacionado
En la documentación: Tu propio número · Estados · Python.
- Recibe una alerta cuando un job de IA devuelve una respuesta vacía o demasiado cortaUn código de salida 0 con una respuesta vacía sigue siendo una ejecución fallida.
- Descubre cuándo un job programado no se ejecutó en absolutoUna ejecución que nunca ocurrió no deja ningún error del que avisar.
- Recibe una alerta cuando un cron job o un script programado de Python fallacron informa la salida, no el éxito ni el fallo; el Programador de tareas muestra 0x1 a nadie.
- Pregunta a Claude o ChatGPT qué falló anocheUna pregunta cubre todos los jobs en todas las máquinas.
Todos los casos de uso · Preguntas frecuentes
Empezar con TaskBeacon es gratis, por ahora con todas las funciones abiertas y sin tarjeta de crédito. Crea un job, pega el código y el primer ping aparece en la página del job.
Empieza gratis Ver demo en vivoFuentes
- Documentación de la API de Claude: errores HTTP (429 rate_limit_error, 529 overloaded_error) (sin fecha; revisado el 12 de noviembre de 2026)
- OpenAI API docs: Error codes (límites de 429 y cuota) (sin fecha; revisado el 12 de noviembre de 2026)
- SD Times: Your agents aren't failing, they're not running (2026-08-03)
- DEV Community: The model worked, the cron job almost killed my AI agent (2026-05-21)
Página revisada contra sus fuentes el 9 de noviembre de 2026. Los menús y límites de otros productos cambian; si algo aquí ya no coincide, escribe a support@taskbeacon.io.