Événements et configuration

​

Familles d’événements

• Démarrage, fin, pause et reprise d’agent
• Requête et réponse du modèle
• Utilisation et résultat d’outil
• Déclenchement et achèvement de hook
• Attente humaine, saisie, pause et interruption
• Erreurs explicites

​

Inspecter un contrat d’événement

• Tableau de bord
• CLI

1. Ouvrez Observe → Events.
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 appariée est manquante, vérifiez que les événements de début et de fin utilisent le même identifiant de corrélation.

Utilisez le flux Events pour restreindre les données à une seule exécution d’agent et inspecter les champs d’événement normalisés.Suivez ensuite l’événement dans sa session. La trace montre ce qui s’est passé juste avant et après, ce qui est nécessaire lorsque la charge utile seule est ambiguë.Comparez les identifiants de corrélation et les horodatages dans les deux vues lorsqu’un événement apparié ou une durée est manquant.

Découvrez 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 réservés du SDK

​

Limites locales

• L’état de Failproof AI réside sous ~/.failproofai sauf configuration explicite contraire.
• failproofai-sdk spooule toujours sous ~/.failproofai/custom-agents. FAILPROOFAI_HOME déplace ce répertoire home ; le segment custom-agents est toujours ajouté, de sorte que le spool ne peut pas être placé en dehors de celui-ci. Seul le propre 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’endroit où le SDK écrit.
• Les labels d’environnement peuvent être définis via la configuration du SDK ou AGENTEYE_ENVIRONMENT.
• Les identifiants du daemon sont stockés séparément des paramètres non secrets.

​

Modifier un label d’environnement

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