Inspeccionar sesiones y hacer seguimiento del uso
Inspecciona una sesión en la Claude Console, consulta su uso de tokens y su costo de lista, y depura comportamientos inesperados del agente.
Usa el visor de sesiones en la Claude Console para inspeccionar lo que hizo un agente en una sesión, sin escribir código. Usa los totales de usage de la sesión para ver lo que consumió ese trabajo.
Inspeccionar una sesión en la Console
El visor de sesiones solo es accesible para Developers y Admins. Para abrirlo, ve a la barra lateral de la Console y selecciona Sessions en Managed Agents. La lista muestra todas las sesiones del espacio de trabajo con su estado, agente, uso de tokens, costo y hora de creación. Selecciona una sesión para abrirla.
El visor de sesiones muestra:
- Minimapa de la línea de tiempo: Una vista general con zoom de la actividad de la sesión a lo largo del tiempo, con un carril por cada hilo en las sesiones multiagente. Selecciona un carril para ver ese hilo, o selecciona una marca para saltar a su evento.
- Transcripción: La conversación agrupada por solicitud al modelo, incluido el pensamiento, las llamadas a herramientas con sus entradas y resultados, y el texto de los mensajes a medida que se transmite. Puedes filtrar los eventos y copiarlos o descargarlos como JSON.
- Inspector: Un panel lateral redimensionable con detalles sobre la sesión, en cinco pestañas.
| Pestaña del Inspector | Qué muestra |
|---|---|
| Session | Los detalles y metadatos de la sesión, su costo acumulado a lo largo del tiempo y el gasto frente al presupuesto de la sesión cuando hay uno establecido. |
| Events | Cada evento sin procesar del hilo actual, en el orden en que el servidor lo envió. Selecciona un evento para ver su JSON. Un mensaje que se transmitió mientras la página estaba abierta también tiene una vista Deltas de sus deltas de eventos. |
| Tools | Las herramientas con las que están configurados los agentes de la sesión, junto con el número de llamadas, los fallos y la duración mediana. Selecciona una herramienta para ver sus llamadas y saltar a una de ellas en la transcripción. |
| Resources | Los archivos, repositorios y almacenes de memoria montados en sus rutas del contenedor, incluidas las memorias de cada almacén y los cambios que esta sesión les hizo. También enumera los archivos que el agente escribió en /mnt/session/outputs y las skills adjuntas a los agentes de la sesión. |
| Threads | Cada hilo con su estado, tamaño de contexto y costo. Selecciona un hilo para ver sus detalles, como el agente, el modelo, el uso de contexto y el costo. |
Agrega ?event={event_id} a la URL de una sesión para abrir la sesión en un evento específico.
Con ant beta:sessions connect, puedes abrir el mismo visor desde la CLI de ant o seguir la sesión en tu terminal. Consulta Conéctate a una sesión de Managed Agents desde tu terminal.
Hacer seguimiento del uso
El objeto de sesión incluye un campo usage con el uso acumulado de la sesión: recuentos de tokens, uso de herramientas del servidor, tiempo activo y el costo de lista registrado. Obtén la sesión después de que quede inactiva para leer los totales más recientes.
{
"id": "sesn_01...",
"status": "idle",
"usage": {
"input_tokens": 5000,
"output_tokens": 3200,
"cache_read_input_tokens": 20000,
"cache_creation": {
"ephemeral_5m_input_tokens": 2000,
"ephemeral_1h_input_tokens": 0
},
"list_cost": {
"amount": "187",
"currency": "USD"
},
"active_seconds": 342.5,
"server_tool_use": {
"web_search_requests": 3,
"web_fetch_requests": 0
}
}
}| Campo | Descripción |
|---|---|
input_tokens | Tokens de entrada no almacenados en caché en todas las llamadas al modelo de la sesión. |
output_tokens | Total de tokens de salida en todas las llamadas al modelo de la sesión. |
cache_read_input_tokens | Tokens leídos de la caché de prompts. |
cache_creation | Tokens de creación de caché, desglosados por tiempo de vida de la caché (ephemeral_5m_input_tokens y ephemeral_1h_input_tokens). |
list_cost | El consumo acumulado de la sesión valorado a las tarifas de lista públicas, como un número entero de centavos en una cadena, con un código de moneda. |
active_seconds | El tiempo acumulado durante el cual la sesión tuvo al menos un hilo en ejecución. La actividad superpuesta de hilos concurrentes se cuenta una sola vez. El costo de tiempo de ejecución de la sesión se calcula sobre esta duración. |
server_tool_use | Recuentos de solicitudes de herramientas ejecutadas por el servidor, para la facturación. Las solicitudes de búsqueda web se incluyen en el costo de lista por solicitud. Las solicitudes de obtención web no tienen cargo por solicitud y no se miden, por lo que web_fetch_requests indica 0. |
Las entradas de caché usan un "TTL" (tiempo de vida) de 5 minutos de forma predeterminada, por lo que los turnos consecutivos dentro de esa ventana se benefician de las lecturas de caché, que reducen el costo por token.
El objeto stats de la sesión tiene su propio active_seconds, que suma el tiempo activo de cada hilo en lugar de contar la actividad superpuesta una sola vez.
Uso por hilo
El usage propio de cada hilo de sesión también incluye list_cost y active_seconds. Las cifras por hilo se redondean de forma independiente y excluyen el costo de tiempo de ejecución de la sesión, por lo que no suman exactamente el list_cost de la sesión. La cifra de la sesión es la autoritativa.
Leer el uso desde el stream
No tienes que consultar la sesión periódicamente para observar estos totales. El evento session.usage incluye la misma instantánea acumulada en el stream de la sesión y en el historial de eventos. La instantánea contiene el objeto usage más el budget de la sesión, que es null cuando la sesión no tiene uno.
El evento se emite en las transiciones a inactivo en lugar de con un temporizador:
- La sesión emite uno inmediatamente antes de pasar a inactiva, sea cual sea el motivo de detención.
- La sesión emite uno cuando un hilo se pausa al alcanzar un presupuesto de sesión.
Aplicar un límite de gasto
Para aplicar un límite de gasto, establece un presupuesto de sesión en lugar de consultar el uso periódicamente y detener la sesión tú mismo. La plataforma valora el consumo de la sesión de forma continua y pausa cada hilo antes de su siguiente solicitud al modelo una vez que el costo de lista alcanza el tope. Consulta Cuando una sesión alcanza su presupuesto para ver cómo se refleja eso en el stream.
Consejos de depuración
- Revisa los eventos de la sesión: La sesión informa los errores mediante eventos
session.error. - Revisa los resultados de las herramientas: Los fallos en la ejecución de herramientas suelen explicar el comportamiento inesperado del agente. La pestaña Tools del Inspector muestra los fallos de cada herramienta.
- Usa indicaciones del sistema: Agrega instrucciones de registro a la indicación del sistema para que el agente resuma lo que hizo y lo que encontró.
- Soluciona problemas de las vistas previas: Si un stream que habilita los deltas de eventos no se comporta como esperas, consulta Solucionar problemas de las vistas previas.
Próximos pasos
Envía eventos, recibe respuestas por streaming e interrumpe o redirige tu sesión a mitad de la ejecución.
Limita el gasto de una sesión con un presupuesto estricto en dólares aplicado a las tarifas de lista públicas.
Was this page helpful?