Événements et configuration

​

Familles d’événements

• Démarrage, fin, pause et reprise d’un agent
• Requête et réponse du modèle
• Utilisation d’un outil et résultat
• Hook déclenché et terminé
• Attente humaine, saisie, pause et interruption
• Erreurs explicites

​

Inspecter un contrat d’événement

• Tableau de bord
• CLI

1. Ouvrez Observer → Événements.
2. Définissez une courte fenêtre temporelle et filtrez par environnement, agent et type d’événement.
3. Sélectionnez un événement pour inspecter ses champs normalisés et sa charge utile brute, puis ouvrez sa session pour voir le contexte d’exécution.
4. Si une durée associée est manquante, vérifiez que les événements de début et de fin utilisent le même ID de corrélation.

Utilisez le flux d’événements pour réduire les données à une seule exécution d’agent et inspecter les champs d’événements normalisés.Ensuite, suivez l’événement jusqu’à sa session. La trace montre ce qui s’est passé immédiatement avant et après, ce qui est nécessaire lorsque la charge utile seule est ambiguë.Comparez les ID de corrélation et les horodatages entre les deux vues lorsqu’un événement associé ou une durée est manquant.

Identifiez les valeurs de filtre valides, puis récupérez les charges utiles complètes des événements pour une session :

fp list event_types
fp list envs
fp events --since 1h \
  --env production \
  --event-type tool_use,tool_result \
  --session-id <session-id> \
  --full

Utilisez fp --json events ... --fields ts,event_type,session_id,payload pour une inspection lisible par machine.

​

Champs SDK réservés

​

Limites locales

• L’état de Failproof AI est stocké sous ~/.failproofai, sauf configuration explicite contraire.
• failproofai-sdk écrit toujours dans ~/.failproofai/custom-agents. FAILPROOFAI_HOME déplace ce répertoire de base ; le segment custom-agents est toujours ajouté, il est donc impossible de placer le spool en dehors de celui-ci. Seul le configure(base_dir=...) du SDK écrit ailleurs. AGENTEYE_HOME est lu par l’ancien agenteye-collector pour choisir ce qu’il surveille et n’affecte plus l’emplacement d’écriture du SDK.
• Les étiquettes d’environnement peuvent être définies via la configuration du SDK ou AGENTEYE_ENVIRONMENT.
• Les identifiants du daemon sont stockés séparément des paramètres non sensibles.

​

Modifier une étiquette d’environnement

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