Events और configuration

​

Event families

• Agent start, end, pause, और resume
• Model request और response
• Tool use और result
• Hook triggered और completed
• Human wait, input, pause, और interrupt
• Explicit errors

​

एक event contract को inspect करें

• Dashboard
• CLI

1. Observe → Events को खोलें।
2. एक छोटी time window सेट करें और environment, agent, और event type के आधार पर filter करें।
3. एक event को select करें इसके normalized fields और raw payload को inspect करने के लिए, फिर अपने session को खोलें execution context को देखने के लिए।
4. अगर एक paired duration missing है, तो verify करें कि start और completion events एक ही correlation ID का use कर रहे हैं।

Events stream को use करें data को एक agent run तक narrow करने के लिए और normalized event fields को inspect करें।फिर event को अपने session में follow करें। Trace दिखाता है कि इससे तुरंत पहले और बाद में क्या हुआ, जो जरूरी है जब payload अकेले ambiguous हो।Correlation IDs और timestamps को दोनों views में compare करें जब एक paired event या duration missing हो।

Valid filter values को discover करें, फिर एक session के लिए full event payloads को fetch करें:

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

Machine-readable inspection के लिए fp --json events ... --fields ts,event_type,session_id,payload को use करें।

​

Reserved SDK fields

​

Local boundaries

• Failproof AI state ~/.failproofai के तहत रहता है जब तक explicitly अन्यथा configure न किया जाए।
• failproofai-sdk हमेशा ~/.failproofai/custom-agents के तहत spool करता है। FAILPROOFAI_HOME उस home को relocate करता है; custom-agents segment हमेशा appended होता है, इसलिए spool को इसके बाहर रखा नहीं जा सकता। केवल SDK का अपना configure(base_dir=...) कहीं और लिखता है। AGENTEYE_HOME को पुराने agenteye-collector द्वारा पढ़ा जाता है यह चुनने के लिए कि क्या देखना है, और अब यह प्रभावित नहीं करता है कि SDK कहां लिखता है।
• Environment labels को SDK configuration या AGENTEYE_ENVIRONMENT के माध्यम से set किया जा सकता है।
• Daemon credentials को non-secret settings से अलग store किया जाता है।

​

एक environment label को change करें

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