Skip to main content

Familles d’événements

  • Démarrage, fin, pause et reprise d’un agent
  • Requête et réponse du modèle
  • Utilisation d’outil et résultat
  • Déclenchement et complétion d’un hook
  • Attente humaine, saisie, pause et interruption
  • Erreurs explicites
Chaque événement comporte un horodatage, un ID de session, un ID d’agent, un type d’événement et un environnement. Les champs spécifiques à l’événement contiennent des données relatives au modèle, à l’outil, à la corrélation, au résultat, au contenu, à la durée ou à l’erreur.

Inspecter un contrat d’événement

  1. Ouvrez Observer → Événements.
  2. Définissez une fenêtre temporelle courte 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 visualiser 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 restreindre les données à une seule exécution d’agent et inspecter les champs d’événement normalisés.Le flux d'événements en direct avec des filtres pour l'environnement, l'agent, la session et le type d'événement.Suivez ensuite l’événement dans sa session. La trace indique ce qui s’est passé immédiatement avant et après, ce qui est indispensable lorsque la charge utile seule est ambiguë.La trace de session liée utilisée pour inspecter l'événement dans son contexte d'exécution.Comparez les ID de corrélation et les horodatages dans les deux vues lorsqu’un événement associé ou une durée est manquant.

Champs réservés du SDK

N’utilisez pas timestamp, session_id, agent_id, type ou environment comme champs personnalisés du SDK Python. Les durées d’événements associés, telles que la durée du résultat d’outil, sont calculées par le SDK et ne peuvent pas être fournies manuellement.

Limites locales

  • L’état de Failproof AI réside sous ~/.failproofai, sauf configuration explicite contraire.
  • failproofai-sdk utilise AGENTEYE_HOME pour son remplacement hérité du répertoire de base.
  • 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 confidentiels.
Utilisez des noms d’environnement stables à faible cardinalité. Les virgules ne sont pas prises en charge dans les étiquettes d’environnement du daemon.

Modifier une étiquette d’environnement

Les étiquettes d’environnement sont assignées par le SDK émetteur ou le daemon Failproof. Après en avoir modifié une, ouvrez Observer → Sessions et utilisez le filtre d’environnement pour confirmer que les nouvelles sessions portent bien la nouvelle valeur. Les sessions existantes conservent leur environnement d’origine.