> ## 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.
# Eventos y configuración
> Referencia del modelo de eventos, entornos, almacenamiento local y límites de configuración.
## Familias de eventos
* Inicio, fin, pausa y reanudación de agente
* Solicitud y respuesta del modelo
* Uso de herramienta y resultado
* Hook activado y completado
* Espera humana, entrada, pausa e interrupción
* Errores explícitos
Cada evento incluye una marca de tiempo, ID de sesión, ID de agente, tipo de evento y entorno. Los campos específicos de cada evento contienen datos de modelo, herramienta, correlación, resultado, contenido, duración o error.
## Inspeccionar un contrato de evento
1. Abre **Observe → Events**.
2. Define una ventana de tiempo corta y filtra por entorno, agente y tipo de evento.
3. Selecciona un evento para inspeccionar sus campos normalizados y el payload en bruto, luego abre su sesión para ver el contexto de ejecución.
4. Si falta la duración de un par, verifica que los eventos de inicio y finalización usen el mismo ID de correlación.
Usa el flujo de Events para reducir los datos a una sola ejecución de agente e inspeccionar los campos de evento normalizados.
Luego sigue el evento hasta su sesión. El trazado muestra qué ocurrió inmediatamente antes y después, lo cual es necesario cuando el payload por sí solo resulta ambiguo.
Compara los IDs de correlación y las marcas de tiempo en ambas vistas cuando falte un evento par o una duración.
Descubre los valores de filtro válidos y luego obtén los payloads completos de los eventos para una sesión:
```bash theme={null}
fp list event_types
fp list envs
fp events --since 1h \
--env production \
--event-type tool_use,tool_result \
--session-id \
--full
```
Usa `fp --json events ... --fields ts,event_type,session_id,payload` para una inspección legible por máquina.
## Campos reservados del SDK
No uses `timestamp`, `session_id`, `agent_id`, `type` ni `environment` como campos personalizados del SDK de Python. Las duraciones de eventos pareados, como la duración del resultado de una herramienta, son calculadas por el SDK y no pueden proporcionarse manualmente.
## Límites locales
* El estado de Failproof AI reside en `~/.failproofai` a menos que se configure explícitamente de otro modo.
* `failproofai-sdk` usa `AGENTEYE_HOME` para su variable de anulación del directorio base heredada.
* Las etiquetas de entorno pueden definirse mediante la configuración del SDK o con `AGENTEYE_ENVIRONMENT`.
* Las credenciales del daemon se almacenan de forma separada de los ajustes no confidenciales.
Usa nombres de entorno estables y de baja cardinalidad. No se admiten comas en las etiquetas de entorno del daemon.
## Cambiar una etiqueta de entorno
Las etiquetas de entorno son asignadas por el SDK emisor o por el daemon de Failproof. Después de cambiar una, abre **Observe → Sessions** y usa el filtro de entorno para confirmar que las nuevas sesiones llevan el nuevo valor. Las sesiones existentes conservan su entorno original.
Para `failproofai-sdk`, configura el entorno en el código o mediante su variable de entorno heredada. Vuelve a ejecutar la configuración del daemon al cambiar ajustes a nivel de máquina.
```bash theme={null}
export AGENTEYE_ENVIRONMENT=production-us-east
failproofai config
failproofai config --status
fp sessions --since 1h --env production-us-east
```