Eventos y configuración

​

Familias de eventos

• Inicio, fin, pausa y reanudación del agente
• Solicitud y respuesta del modelo
• Uso de herramientas y resultados
• Hook activado y completado
• Espera humana, entrada, pausa e interrupción
• Errores explícitos

​

Inspeccionar un contrato de evento

• Dashboard
• CLI

1. Abre Observe → Events.
2. Establece 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 sin procesar, luego abre su sesión para ver el contexto de ejecución.
4. Si falta una duración emparejada, verifica que los eventos de inicio y finalización usen el mismo ID de correlación.

Usa el flujo de Events para acotar los datos a una ejecución de agente e inspeccionar los campos del evento normalizados.Luego sigue el evento hasta su sesión. La traza 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 emparejado 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:

fp list event_types
fp list envs
fp events --since 1h \
  --env production \
  --event-type tool_use,tool_result \
  --session-id <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

​

Límites locales

• El estado de Failproof AI reside en ~/.failproofai a menos que se configure explícitamente de otra manera.
• failproofai-sdk siempre almacena en ~/.failproofai/custom-agents. FAILPROOFAI_HOME reubica ese directorio raíz; el segmento custom-agents siempre se añade al final, por lo que el almacenamiento no puede ubicarse fuera de él. Solo el propio configure(base_dir=...) del SDK escribe en otra ubicación. AGENTEYE_HOME es leído por el agenteye-collector más antiguo para determinar qué observar, y ya no afecta dónde escribe el SDK.
• Las etiquetas de entorno pueden establecerse a través de la configuración del SDK o de AGENTEYE_ENVIRONMENT.
• Las credenciales del daemon se almacenan por separado de los ajustes no confidenciales.

​

Cambiar una etiqueta de entorno

export AGENTEYE_ENVIRONMENT=production-us-east
failproofai config
failproofai config --status
fp sessions --since 1h --env production-us-east