> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sesiones

> Comienza con el registro completo de una ejecución del agente.

Una sesión es el mejor punto de partida cuando un agente se comporta de forma inesperada. Reúne las solicitudes al modelo, las respuestas, las llamadas a herramientas, las interacciones humanas, los errores, las evaluaciones y las decisiones de política que pertenecen a una sola ejecución.

<div style={{ position: "relative", width: "100%", paddingBottom: "56.25%", height: 0, overflow: "hidden", borderRadius: "12px", margin: "1.5rem 0" }}>
  <iframe src="https://www.youtube.com/embed/VWxukZc5k7s?rel=0&playsinline=1" title="Agent tracing with Failproof AI" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture; fullscreen" allowFullScreen style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} />
</div>

Sigue una ejecución del agente desde su objetivo, pasando por las llamadas al modelo y las herramientas, hasta la respuesta final.

## Encontrar una sesión

<Tabs>
  <Tab title="Panel de control">
    1. En la barra lateral de Cloud, ve a **Observe → Sessions**.
    2. Establece la ventana de tiempo y filtra por entorno, estado, agente o ID de sesión.
    3. Añade rangos de puntuación o métricas cuando necesites un subconjunto por calidad, costo, tokens o latencia.
    4. Selecciona una fila para abrir su traza. Usa el control de copia junto al ID de sesión cuando lo compartas.

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/sessions-list.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=f1fb545746143e87b8b5daedabfc5559" alt="La lista de sesiones con una fila por ejecución y filtros de entorno, agente, estado y puntuación de evaluación." width="3200" height="2000" data-path="images/dashboard/sessions-list.png" />
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp sessions --env production --since 24h
    fp sessions --status error,timeout --agent-id checkout-agent
    fp --json sessions --session-id <session-id>
    ```

    Añade `--agents` para expandir ejecuciones multi-agente, `--all` para paginar, o `--fields` para elegir las columnas de salida.
  </Tab>
</Tabs>

## Qué puedes hacer

* Encontrar una ejecución por agente, entorno, tiempo, modelo, tipo de evento o estado de error.
* Seguir la secuencia exacta que produjo un resultado.
* Comparar ejecuciones exitosas y fallidas.
* Abrir la evidencia utilizada por un hallazgo de auditoría o un incidente de alerta.
* Exportar una sesión cuando necesitas un registro sin conexión.

## Un orden de investigación confiable

1. Confirma el objetivo de la sesión y el entorno.
2. Encuentra el primer error o decisión inesperada, no solo el fallo final.
3. Inspecciona el contexto del modelo y la entrada de la herramienta inmediatamente antes.
4. Revisa los reintentos, la latencia y las interrupciones humanas.
5. Revisa las puntuaciones de evaluación y las decisiones de política.

<Card title="Leer una traza" icon="route" href="/es/sessions/read-a-trace">
  Aprende a navegar desde el resumen de la sesión hasta el evento que causó el resultado.
</Card>
