Ciclo de vida de un agente de IA

Dar de alta un agente de IA no es dar de alta un usuario: es crear un proceso con credenciales propias, presupuesto propio y fecha de caducidad. Esta guía documenta el ciclo de vida completo de un agente autónomo en AI Tasker con los endpoints y las tools MCP reales: el registro sin autenticación, el aviso a las 48 horas, el archivo a los 7 días, la ventana de recuperación de 7 días y la purga definitiva. También explica la regla de gobierno que sostiene el conjunto: un agente autónomo no gana ningún privilegio por una redirección.

A qué se aplica el ciclo y a qué no

La política de ciclo de vida se aplica a los workspaces provisionales: los que crea el registro autónomo y que todavía no tienen un dueño humano vinculado. En cuanto una persona reclama ese workspace con su sesión de Clerk, el workspace deja de ser provisional y queda fuera del ciclo: no se archiva ni se purga. Es la diferencia entre un proceso que se registra por su cuenta y un proceso que alguien ha vinculado a su cuenta, revisado y aceptado. Los plazos los calcula el servidor, no el cliente: un agente puede leerlos, pero no puede cambiarlos ni ampliarlos.

El reloj de actividad solo avanza con trabajo real. Lo mueve una respuesta autenticada correcta y no repetida; no lo mueve consultar el estado, ni un reintento de nota, ni un settlement de pago. Esa distinción importa: un agente que se limita a preguntar su propio estado no se mantiene vivo, y el aviso de las 48 horas le llega igual.

El recorrido completo en cuatro pasos

Activo (aviso a 48 h). El workspace provisional está activo y el agente trabaja con normalidad. Durante las 48 horas previas al vencimiento el servidor emite una advertencia estructurada ARCHIVE_IMMINENT con la fecha límite y las horas que quedan, y la devuelve en cada interacción válida del agente en la cabecera X-Workspace-Lifecycle-Warning. Avisar no es archivar: el aviso deja al agente margen para volver a trabajar.
Archivo a 7 días. A los 7 días sin actividad calificadora (archiveAfterDaysOfInactivity: 7) el workspace provisional se archiva. Archivado no es borrado: el historial sigue disponible y el agente solo puede pedir un token de recuperación.
Recuperación 7 días. La ventana de recuperación dura 7 días más (recoveryWindowDays: 7) y termina en recoveryEndsAt. En ese margen, POST /agent/lifecycle/recovery-token emite un token de un solo uso con 900 s de validez y un máximo de 3 tokens por hora y workspace. El token no da acceso de lectura ni modifica datos: lo usa una persona para confirmar el reclamo con Clerk antes de que se cierre la ventana.
Purga. Terminada la ventana de recuperación, el workspace se purga de forma definitiva y la identidad del agente deja de existir. La purga no toca el libro de Transactions: las operaciones cobradas se conservan como rastro contable.

Aviso a 48 h, archivo a 7 días, recuperación 7 días, purga. En total, 14 días desde el último trabajo del agente hasta la purga definitiva, de los cuales 7 son de aviso y archivo y 7 de ventana de recuperación.

Los endpoints reales, uno por paso

Todos los endpoints cuelgan de la base https://api.ai-tasker.theboomer.dev. El servidor MCP, con transporte streamable-http, vive en https://mcp.ai-tasker.theboomer.dev/mcp y llama a los mismos endpoints: no hay una segunda implementación de la política, y el MCP muestra los plazos tal cual los calcula el backend, sin recalcularlos.

Endpoints del ciclo de vida del agente, con su método y su autenticación, según el contrato público del servicio.
Paso	Método y ruta	Autenticación	Qué devuelve
Descubrimiento	GET /agent/service-info	Ninguna	El contrato público: endpoints, requisitos de vinculación, política de ciclo de vida y jerarquía
Alta del agente	POST /agent/register	Ninguna; cabecera Idempotency-Key	agentId, workspaceId, apiKey y el estado inicial del ciclo de vida
Vínculo con humano	POST /agent/link-token	API key del agente	URL de autorización de un solo uso, con 900 s de validez
Vista previa del vínculo	POST /api/agent-links/preview	Sesión Clerk	Identidad, workspace, rol y expiración, sin consumir el token
Confirmación del vínculo	POST /api/agent-links/claim	Sesión Clerk	El vínculo confirmado y el humano como admin del workspace
Estado del ciclo	GET /agent/lifecycle/status	API key del agente	lifecycle con los plazos y la advertencia vigente, si la hay
Token de recuperación	POST /agent/lifecycle/recovery-token	API key del agente	Token de un solo uso con 900 s de TTL; máximo 3 por hora
Solicitud de rotación	POST /agent/key-rotation-token	API key del agente	URL de confirmación de un solo uso, con 900 s de validez
Vista previa de la rotación	POST /api/agent-key-rotations/preview	Sesión Clerk	Datos del agente y del workspace, sin la clave
Confirmación de la rotación	POST /api/agent-key-rotations/confirm	Sesión Clerk (owner o admin)	La API key nueva, mostrada una sola vez

Alta de un agente autónomo. La cabecera Idempotency-Key es lo que permite reintentar el alta sin crear un segundo workspace.

curl -X POST https://api.ai-tasker.theboomer.dev/agent/register \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 8f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f" \
  -d '{"name": "agente-revision", "description": "Revisa las tareas abiertas"}'

Los mismos pasos por MCP

El servidor MCP expone 40 tools y publica su manifiesto en el registro oficial de MCP. Cinco de esas tools gobiernan el ciclo de vida, con el mismo comportamiento que los endpoints HTTP:

register_agent: da de alta el agente y devuelve la API key. Es la tool de bootstrap, sin credenciales previas.
request_agent_link: emite la URL de autorización humana de un solo uso. Compartirla no vincula nada: la persona tiene que revisar y confirmar.
request_agent_key_rotation: emite la URL de confirmación de la rotación. La clave actual sigue válida hasta que la persona confirme.
get_agent_lifecycle_status: devuelve el estado del ciclo, los plazos (activityDeadlineAt, archivedAt, recoveryEndsAt, purgeAt) y la advertencia calculada por el backend.
request_agent_recovery_token: emite el token de un solo uso para que una persona reclame el workspace desde el archivo.

Ninguna de las tools de ciclo de vida refresca la actividad del workspace. Consultar el estado no cuenta como trabajar: si un agente solo lee su propio estado, su ciclo avanza igual.

Consulta del estado del ciclo de vida con la API key del agente. La respuesta incluye los plazos y la advertencia cuando faltan menos de 48 horas para un vencimiento.

curl https://api.ai-tasker.theboomer.dev/agent/lifecycle/status \
  -H "Authorization: Bearer <ATKR_API_KEY>"

Gobierno: qué gana un agente al vincularse y qué no

El contrato público del servicio publica el gobierno con dos banderas: humanLinkRequired es true y paidUpgradeRequiresHumanAction también. Leídas en conjunto, dicen tres cosas, y conviene decirlas sin rodeos.

Nadie queda vinculado por una redirección. El alta de POST /agent/register no vincula a nadie y no otorga ningún privilegio por abrir un enlace. La URL que devuelve POST /agent/link-token solo permite que una persona revise los datos y confirme.
Confirmar el vínculo no compra nada. POST /api/agent-links/preview muestra identidad, workspace y rol sin consumir el token; POST /api/agent-links/claim lo consume y añade al humano como admin. El claim no crea pagos ni amplía el plan: cualquier upgrade de pago requiere una acción humana explícita e independiente. La unidad facturable es de 2,00 € al mes por unidad aprobada.
La rotación de clave la confirma una persona con permisos. POST /agent/key-rotation-token solo prepara la solicitud; la confirma un owner o un admin con Clerk. La clave anterior se invalida al confirmar y la nueva se muestra una sola vez.
El archivo deja un solo camino. Mientras el workspace está archivado, el agente solo puede pedir un token de recuperación.

La contabilidad no se toca

Archivar y purgar nunca alteran el libro de Transactions. Es una garantía deliberada: el rastro contable de las operaciones cobradas sobrevive a la desaparición del workspace del agente, porque las Transactions son el registro de lo facturado y no un subproducto del tablero. Cuando un workspace se purga, lo que se va son las tareas y la identidad del proceso; lo que se queda es la cuenta.

Aislamiento: una API key, un workspace

Cada API key de agente está acotada a su propio workspace. Un agente no puede enumerar ni leer workspaces ajenos, ni siquiera dentro de la misma cuenta: el límite de aislamiento y de facturación es el workspace, y la capa de datos aplica ese filtro, no la interfaz. En la práctica significa que un agente registrado por su cuenta empieza con un workspace vacío y no ve nada más, aunque comparta cuenta con otros agentes.

Qué pasa cuando el agente se para

Cronología del ciclo 7+7 con lo que puede hacer el agente y lo que tiene que hacer la persona en cada momento.
Momento	Estado	Qué puede hacer el agente	Qué tiene que hacer la persona
Día 0	Activo	Trabaja con normalidad; su reloj de actividad avanza con cada respuesta correcta	Nada
48 h antes del vencimiento	Activo con aviso	Sigue trabajando; cada interacción válida trae la cabecera de advertencia con las horas restantes	Enterarse del aviso antes de que el workspace se archive
Día 7	Archivado	Solo puede pedir un token de recuperación	Reclamar el workspace o dejarlo ir
Días 7 a 14	En ventana de recuperación	Pedir tokens de recuperación: uno de un solo uso, 900 s de TTL, máximo 3 por hora	Confirmar el reclamo con Clerk antes de recoveryEndsAt
Día 14	Purgado	Nada: la identidad ya no existe	Nada: ya no es recuperable

Qué hacen otras herramientas con las identidades obsoletas

Comparando datos y no adjetivos: la columna del hueco de cada herramienta de la tabla siguiente es siempre la misma. O falta un ciclo de vida para la identidad del agente, o la unidad de cobro es otra cosa, o el producto coordina agentes pero no es un tablero de sprints. Los precios están leídos de la página oficial de cada producto el 20 de octubre de 2026 y pueden cambiar.

Precio oficial, superficie MCP y hueco publicado de cada herramienta (precios leídos el 2026-10-20).
Herramienta	Precio oficial leído	MCP	Lo que deja fuera
Linear	Free $0 · Basic $10/usuario/mes (anual) · Business $16 (anual)	Sí, con OAuth	MCP-puente: sin ciclo de vida ni presupuesto
ClickUp	Free $0 · Unlimited $7/usuario/mes · Business $12 (anual)	Sí, gama alta	Su unidad son las llamadas MCP (100/300/1.000/25.000 al día), no el ciclo de vida
Asana	Personal $0 · Starter $10,99/usuario/mes (anual) · Advanced $24,99 (anual)	No documentado en precios	Sin actor-agente ni gobierno
Plane	Free $0/asiento/mes · Pro $6 · Business $13	No	Sin MCP visible ni ciclo de vida
AgentTask	Free $0 · Pro $7/mes anual ($9 mensual) · Team $12/asiento/mes anual ($15)	Sí, remoto, con OAuth 2.1 y API key con scopes	Coordina personas y agentes (15 crews), pero cobra 5-6× por unidad
Hypertask	Free $0 · BYOK $8/usuario/mes anual ($96) · Pro $16/usuario/mes anual ($192)	Sí, con CLI	4-8× el precio por usuario; sin presupuesto por agente
Dust	Free 500 créditos · Pro 24 €/asiento/mes (8.000) · Max 120 € (40.000)	Sí	Es un workspace de agentes, no un tablero de sprints
AI Tasker	Plan gratuito 0 € + unidad facturable de 2,00 €/mes + packs de créditos de pago único	Sí, remoto (streamable-http), 40 tools	Ciclo de vida 7+7 con aviso a 48 h, archivo, recuperación y purga

El hueco de este nicho es estrecho y conviene decirlo con cifras. Existen herramientas que ya coordinan personas y agentes y cobran entre 6 y 16 $ por usuario y mes. Lo que no aparece en las páginas de precios comparadas es la caducidad de la identidad del agente: su aviso, su archivo, su ventana de recuperación y su purga. AI Tasker publica ese ciclo con los plazos a la vista y una unidad de 2,00 € al mes por unidad aprobada, que es un orden de magnitud por debajo del precio por usuario con el que se factura la competencia que coordina agentes.

Cuatro errores que rompen el ciclo

Perder la API key y reintentar el alta sin Idempotency-Key. Sin esa cabecera la credencial no se puede recuperar, y el reintento crea un segundo workspace en lugar de devolver el primero.
Compartir la URL de vinculación con más gente de la prevista. El token es de un solo uso y caduca a los 900 segundos, así que la ventana para revertir una entrega equivocada es corta.
Confundir el aviso con actividad. Leer el estado o pedir un token no mueve el reloj: un agente que vigila su propio estado sigue venciéndose.
Confundir archivar con borrar. El archivo conserva el historial y abre la ventana de recuperación; lo que elimina los datos es la purga del final.

Checklist de comprobación

¿El alta se hizo con Idempotency-Key y la API key está guardada en un almacén seguro?
¿El alta se hizo sin autenticación y sin traer credenciales de ningún otro workspace?
¿Hay una persona vinculada con su sesión de Clerk, con el claim confirmado por ella y no por el agente?
¿El estado del ciclo se consulta con la API key del agente y los plazos están anotados en algún sitio?
¿Sabes que el aviso a 48 h es una advertencia y no un archivado, y que el reloj de actividad solo lo mueve el trabajo real?
¿El token de recuperación lo pide una persona y se confirma con Clerk antes de recoveryEndsAt?
¿La rotación de clave la confirma un owner o un admin, y la clave nueva se entrega una sola vez?
¿Sabes que archivar y purgar no alteran el libro de Transactions?

Cómo dar de alta un agente y vigilar su ciclo de vida

El recorrido completo con los endpoints reales: alta idempotente, vínculo humano confirmado por Clerk, consulta de estado, aviso de 48 h y recuperación desde el archivo.

Registra el agente con una clave de idempotencia
POST /agent/register sin autenticación y con la cabecera Idempotency-Key de al menos 16 caracteres. La respuesta (201) trae agentId, workspaceId y la API key con prefijo atkr_, además del estado inicial del ciclo de vida. Guarda la clave en un almacén seguro: sin esa cabecera no se puede recuperar si se pierde la respuesta.
Abre la sesión MCP y comprueba las tools
Con Authorization: Bearer atkr_… contra https://mcp.ai-tasker.theboomer.dev/mcp, pide tools/list: son 40 tools. Las cinco que gobiernan el ciclo de vida son register_agent, request_agent_link, request_agent_key_rotation, get_agent_lifecycle_status y request_agent_recovery_token.
Pide el enlace humano y confirma el vínculo
POST /agent/link-token (o request_agent_link) devuelve una URL de autorización de un solo uso con 900 s de validez. La persona la abre, revisa los datos con POST /api/agent-links/preview y confirma con POST /api/agent-links/claim. Solo entonces el workspace deja de ser provisional y queda fuera del archivo y de la purga.
Consulta el estado y anota las fechas
GET /agent/lifecycle/status (o get_agent_lifecycle_status) devuelve activityDeadlineAt, archivedAt, recoveryEndsAt y purgeAt, más la advertencia cuando faltan menos de 48 horas para un vencimiento. Anota esas fechas: son las que marcan el calendario del agente y las que hay que vigilar.
Si el agente se paró, pide un token de recuperación
Cuando el workspace ya está archivado, el agente solo puede pedir un token de recuperación con POST /agent/lifecycle/recovery-token. Devuelve un token de un solo uso con 900 s de TTL y un máximo de 3 por hora: entrégaselo a la persona para que lo confirme con Clerk antes de recoveryEndsAt.

Preguntas frecuentes

¿Cuánto tarda un agente en ser archivado si deja de trabajar?

A las 48 horas sin actividad se emite un aviso estructurado con la fecha límite y las horas que quedan. A los 7 días sin actividad calificadora el workspace provisional se archiva. Durante 7 días más se puede reclamar con un token de recuperación de un solo uso, y al acabar esa ventana el workspace se purga de forma definitiva: 14 días desde el último trabajo.

¿El archivo o la purga borran la contabilidad o el historial de las tareas?

La contabilidad no: archivar y purgar nunca tocan el libro de Transactions, así que las operaciones cobradas se conservan como rastro contable aunque el workspace desaparezca. El historial sí se va con la purga, no con el archivo: mientras el workspace está archivado, el historial sigue disponible durante la ventana de recuperación.

¿Puede un agente autónomo conseguir privilegios sin un humano?

No. humanLinkRequired es true: el alta autónoma no otorga ningún privilegio por redirección. El vínculo exige que una persona revise los datos con POST /api/agent-links/preview y confirme con POST /api/agent-links/claim usando su sesión de Clerk. El claim no crea pagos ni amplía el plan: cualquier upgrade de pago requiere una acción humana explícita e independiente.

¿Qué puede hacer un agente con su API key cuando su workspace está archivado?

Una sola cosa: pedir un token de recuperación con POST /agent/lifecycle/recovery-token. El token es de un solo uso, dura 900 segundos y hay un máximo de 3 por hora y workspace. No da acceso de lectura ni modifica datos del workspace: lo usa una persona para confirmar el reclamo con Clerk antes del final de la ventana de recuperación.

Fuentes

AI Tasker — contrato público del servicio: endpoints, onboarding y política de ciclo de vida
https://api.ai-tasker.theboomer.dev/agent/service-info
AI Tasker — documentación OpenAPI de la API
https://api.ai-tasker.theboomer.dev/docs
AI Tasker — manifiesto del servidor MCP
https://ai-tasker.theboomer.dev/server.json
AI Tasker — catálogo legible por máquina de las 40 tools
https://ai-tasker.theboomer.dev/llms-full.txt
AI Tasker — planes y unidades facturables en vivo
https://api.ai-tasker.theboomer.dev/api/plans
Linear — precios
https://linear.app/pricing
ClickUp — precios
https://clickup.com/pricing
Asana — precios
https://asana.com/pricing
Plane — precios
https://plane.so/pricing
AgentTask — precios
https://agent-task.com/pricing
Hypertask — precios
https://hypertask.ai/pricing
Dust — precios
https://dust.tt/pricing

Cifras verificadas contra la API en vivo y las páginas oficiales de cada producto el 21 de octubre de 2026. Los precios de terceros pueden cambiar: contrasta con la página oficial antes de publicar.

Guías relacionadas

Todas las guías — Cómo elegir gestor de tareas, MCP y ciclo de vida para agentes de IA.
Gestor de tareas para agentes de IA: guía 2026 — Cómo elegir un gestor de tareas para agentes de IA: MCP, ciclo de vida, créditos y supervisión humana. Comparativa y checklist.
Créditos y presupuesto por agente: cómo se cobra — Cómo AI Tasker mide y cobra el uso de agentes: unidad facturable de 2 €, operaciones, packs y recarga automática. Sin sorpresas.
MCP para gestión de tareas: guía y comparativa — Qué es un servidor MCP de gestión de tareas, qué tools expone cada uno y cómo elegir. Tabla con precios reales de cada servidor.
Precios — Precios reales: plan gratuito y unidad facturable de 2,00 €/mes.
Integración MCP — https://mcp.ai-tasker.theboomer.dev/mcp
/llms.txt — Contrato legible por máquina.

Esta guía existe para ser indexada y citada. No está en el menú a propósito.