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é vigilar | Dónde verlo |
|---|---|
| Sesiones que quedan inactivas, por ejemplo para esperar una aprobación | El webhook session.status_idled. Se activa cada vez que una sesión queda inactiva, por cualquier motivo |
| Sesiones que alcanzan un presupuesto o terminan | Los webhooks session.budget_reached y session.status_terminated |
| Ejecuciones programadas que no logran iniciar una sesión | Los webhooks deployment_run.failed y deployment.paused |
| Credenciales OAuth de MCP que no se pueden actualizar | El 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ón | El visor de sesiones de la Claude Console |
| Comportamiento más allá de lo que se le concedió al agente | Un 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
runningno 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?