Events und Konfiguration

​

Event-Familien

• Agent-Start, -Ende, -Pause und -Wiederaufnahme
• Modellanfrage und -antwort
• Tool-Nutzung und Ergebnis
• Hook ausgelöst und abgeschlossen
• Menschliches Warten, Eingabe, Pause und Unterbrechung
• Explizite Fehler

​

Einen Event-Vertrag untersuchen

• Dashboard
• CLI

1. Öffne Observe → Events.
2. Lege ein kurzes Zeitfenster fest und filtere nach Umgebung, Agent und Event-Typ.
3. Wähle ein Event aus, um dessen normalisierte Felder und den Rohinhalt zu inspizieren, und öffne anschließend die zugehörige Session, um den Ausführungskontext einzusehen.
4. Falls eine zugehörige Dauer fehlt, überprüfe, ob Start- und Abschluss-Event dieselbe Korrelations-ID verwenden.

Nutze den Events-Stream, um die Daten auf einen einzelnen Agent-Lauf einzugrenzen und die normalisierten Event-Felder zu untersuchen.Folge anschließend dem Event in seine Session. Der Trace zeigt, was unmittelbar davor und danach geschah – das ist notwendig, wenn der Inhalt allein mehrdeutig ist.Vergleiche Korrelations-IDs und Zeitstempel in beiden Ansichten, wenn ein zugehöriges Event oder eine Dauer fehlt.

Ermittle gültige Filterwerte und rufe dann vollständige Event-Inhalte für eine Session ab:

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

Verwende fp --json events ... --fields ts,event_type,session_id,payload für maschinenlesbare Untersuchungen.

​

Reservierte SDK-Felder

​

Lokale Grenzen

• Der Failproof AI-Zustand liegt unter ~/.failproofai, sofern nicht explizit anders konfiguriert.
• failproofai-sdk schreibt stets unter ~/.failproofai/custom-agents. FAILPROOFAI_HOME verschiebt dieses Verzeichnis; das Segment custom-agents wird immer angehängt, sodass der Spool-Bereich nicht außerhalb davon platziert werden kann. Nur das SDK-eigene configure(base_dir=...) schreibt an einen anderen Ort. AGENTEYE_HOME wird vom älteren agenteye-collector ausgelesen, um zu bestimmen, was überwacht wird, und hat keinen Einfluss mehr darauf, wohin das SDK schreibt.
• Umgebungsbezeichnungen können über die SDK-Konfiguration oder AGENTEYE_ENVIRONMENT gesetzt werden.
• Daemon-Anmeldedaten werden getrennt von nicht-geheimen Einstellungen gespeichert.

​

Eine Umgebungsbezeichnung ändern

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