Claude Platform Docs
Managed AgentsSeguridad

Revisar y supervisar sesiones de agentes

Opcionalmente, revisa los eventos de cada sesión con un trabajo sin conexión. Vigila los webhooks de las sesiones que necesitan atención y consulta qué conserva Managed Agents y durante cuánto tiempo.

Opcionalmente, revisa los eventos de cada sesión con un trabajo sin conexión. Vigila los webhooks de las sesiones que necesitan atención y elimina las sesiones que ya no necesites. Para limitar lo que un agente puede hacer antes de que se ejecute, consulta Protege tu implementación de Managed Agents.

Opcionalmente, haz que un revisor sin conexión lea cada transcripción

Un “offline reviewer” (revisor sin conexión) es un trabajo que ejecutas, separado de las sesiones que revisa, y que lee los eventos de cada sesión después de que se escriben. Las sesiones largas tienen demasiados eventos para que una persona los lea, así que el trabajo hace que Claude los lea. La revisión señala el comportamiento que va más allá de lo que se le concedió al agente. Para obtener un prompt de revisión, los pasos de configuración y código funcional, consulta la receta de revisión de seguridad en el Claude Cookbook.

Supervisa las sesiones y revisa la retención

Suscríbete a los webhooks que te avisan cuando una sesión necesita atención y elimina las sesiones que ya no necesites. Verifica la firma de cada entrega. Consulta Verificar la firma.

Qué vigilarDónde verlo
Sesiones que quedan inactivas, por ejemplo para esperar una aprobaciónEl webhook session.status_idled. Se activa cada vez que una sesión queda inactiva, por cualquier motivo
Sesiones que alcanzan un presupuesto o terminanLos webhooks session.budget_reached y session.status_terminated
Ejecuciones programadas que no logran iniciar una sesiónLos webhooks deployment_run.failed y deployment.paused
Credenciales OAuth de MCP que no se pueden actualizarEl webhook vault_credential.refresh_failed
Llamadas a herramientas que el servidor denegó o pausóevaluated_permission en los eventos agent.tool_use y agent.mcp_tool_use. En una sesión multiagente, lista también los eventos de cada hilo
Lo que hizo un agente en una sesiónEl visor de sesiones de la Claude Console
Comportamiento más allá de lo que se le concedió al agenteUn trabajo de revisión sin conexión opcional que ejecutas y que lee los eventos de cada sesión. Consulta Opcionalmente, haz que un revisor sin conexión lea cada transcripción

Para ver por qué una sesión quedó inactiva, lista sus eventos con types establecido en session.status_idle, order establecido en desc y limit establecido en 1. El evento se llama session.status_idle y el webhook se llama session.status_idled. Si stop_reason.type es requires_action, la sesión te está esperando, y stop_reason.event_ids lista los eventos que está esperando. Para responderlos, consulta Responder a llamadas a herramientas que pausan la sesión. En un sandbox autoalojado, un evento agent.tool_use puede estar esperando a que tu sandbox devuelva el resultado de la herramienta. Con ejecuciones de flujo de trabajo abiertas, una llamada a herramienta puede esperar tu respuesta mientras la sesión permanece en running. Responde a cada llamada cuando llegue su evento. Consulta Mientras una ejecución está abierta.

Una entrega de webhook puede perderse, así que también lista tus sesiones de forma programada y revisa las inactivas.

Consulta Suscribirse a webhooks e Inspeccionar sesiones y hacer seguimiento del uso.

Esta lista muestra qué conserva Managed Agents y durante cuánto tiempo:

  • Historial de la sesión: Se conserva hasta que eliminas la sesión. Archivar una sesión conserva su historial. Para conservar los eventos de una sesión, cópialos a tus propios registros con la API de eventos antes de eliminarla. Una sesión en estado running no se puede eliminar. Consulta Eliminar una sesión.
  • Estado del sandbox: Se conserva durante 30 días después de que se crea el sandbox.
  • Archivos que produce una sesión: Se eliminan con la sesión. Descarga primero los archivos que quieras conservar.
  • Archivos que subiste, almacenes de memoria y vaults: No se eliminan con la sesión. Elimínalos por separado.

Con un sandbox autoalojado, te corresponde a ti conservar o eliminar las copias de las entradas y salidas de herramientas que están en tu propia infraestructura.

Managed Agents actualmente no es elegible para “zero data retention” (retención cero de datos), o ZDR, ni para la cobertura del “Business Associate Agreement” (acuerdo de asociado comercial), o BAA, de HIPAA. Consulta API y retención de datos.

¿Te resultó útil esta página?