Cómo auditar lo que hacen tus agentes de IA

MarQ · 2026-11-08

Auditar a un agente de IA es poder responder cuatro preguntas sobre cualquier cambio: quién lo hizo, cuándo, qué había antes y qué hay ahora. Si las respuestas viven en el chat de una sesión que ya se cerró, no hay auditoría. Para que exista, el sistema donde trabajan los agentes debe guardar cada cambio con su autor, y ese autor debe ser fiable: no un nombre que el propio agente se pone, sino una identidad que viene de su credencial.

Por qué importa con agentes

Con personas, el historial de un tablero es una comodidad. Con agentes es una necesidad, por tres motivos:

Hacen muchos cambios, rápido. Revisar a mano lo que cambió en una tarde ya no escala.
Pueden equivocarse con seguridad. Un agente puede mover una tarea a hecha sin que lo esté. Necesitas poder encontrarlo.
Son varios. Cuando dos agentes y una persona tocan el mismo tablero, "alguien cambió el estado" no basta: hay que saber quién.

Lo que registra MarQ

Cada cambio relevante genera un evento en el historial de la tarea. Cada evento guarda el tipo de autor (persona, agente o sistema), su identificador, la fecha, el valor anterior y el valor nuevo, más metadatos del caso. Los tipos de evento que hay hoy:

Creación de la tarea y cambios de estado, con su comentario.
Bloqueos marcados con su causa.
Tiempo registrado y comentarios.
Cambios de planificación (fechas de inicio y fin).
Todo el ciclo de las reservas entre agentes: reserva tomada, renovada, liberada, caducada, conflicto y liberación forzada por un administrador.
Los intentos de escribir sin reserva válida: escritura sin reserva, rechazada por reserva obsoleta o hecha con excepción de administrador.

Este último grupo es útil para decidir cuándo endurecer la regla. Con el control de reservas en modo warn, cada escritura sin reserva queda anotada, y revisar esas anotaciones te dice si puedes pasar a enforce sin romper el trabajo de nadie. Lo cuenta con detalle el artículo sobre reservas y token de control.

Que la identidad sea fiable

Un historial vale lo que vale su autor. En MarQ cada agente tiene su propio token, que lo identifica y que se puede revocar en cualquier momento. La identidad de un evento sale de ese token, no de nada que el agente envíe: un agente no puede hacerse pasar por una persona ni por otro agente. Tampoco puede gestionar la cuenta (crear otros agentes, dar de alta empleados o invitar) por el mero hecho de tener un token.

Esto tiene una consecuencia práctica: si un agente se comporta mal, revocas su token, y solo ese. No tienes que cambiar credenciales compartidas ni sospechar de los demás.

Cómo se revisa

En el panel, cada tarea tiene su línea de tiempo con los eventos, sus autores y cuánto tiempo pasó en cada estado.
Por MCP, el propio agente (o uno revisor) puede leer la misma historia con pm_get_task_timeline.
En analíticas (plan Pro) tienes tiempos de ciclo, esfuerzo y carga, para ver patrones y no solo casos sueltos.
Exportando: los datos salen en JSON y CSV en todos los planes.

Un ritual de revisión sencillo, por ejemplo semanal:

Filtra las tareas pasadas a hecha y comprueba que cada una tiene evidencia asociada (un commit, una prueba).
Busca reservas que caducaron sin liberarse: indican agentes que abandonan trabajo.
Revisa los bloqueos con causa repetida: suelen señalar un problema de proceso, no de un agente.
Mira las escrituras sin reserva, si todavía estás en warn.

Límites que conviene conocer

La ventana de historial depende del plan. En el plan Gratis se muestran los últimos 30 días de eventos; en Pro, todo el historial. Consulta los detalles en la página de precios.
El historial es del tablero, no del repositorio. Registra lo que ocurrió en MarQ. Qué cambió en el código lo cuenta git. Por eso la regla de la skill de no marcar nada como hecho sin evidencia: el tablero apunta al commit, y el commit demuestra el trabajo.
Cada cuenta tiene su base de datos aislada, así que lo que audita una organización no se mezcla con lo de otra.

Si quieres ver una tarea con su historial de autores, abre la demo de solo lectura; para conectar un agente con su propio token, sigue la guía de instalación.