Eventi e configurazione

​

Famiglie di eventi

• Inizio, fine, pausa e ripresa dell’agente
• Richiesta e risposta del modello
• Uso dello strumento e risultato
• Hook attivato e completato
• Attesa umana, input, pausa e interrupt
• Errori espliciti

​

Ispeziona un contratto di evento

• Dashboard
• CLI

1. Apri Observe → Events.
2. Imposta una finestra temporale breve e filtra per ambiente, agente e tipo di evento.
3. Seleziona un evento per ispezionare i suoi campi normalizzati e il payload grezzo, quindi apri la sua sessione per visualizzare il contesto di esecuzione.
4. Se manca una durata accoppiata, verifica che gli eventi di inizio e completamento utilizzino lo stesso ID di correlazione.

Utilizza il flusso Events per restringere i dati a un’esecuzione di un agente e ispezionare i campi dell’evento normalizzati.Quindi segui l’evento nella sua sessione. La traccia mostra cosa è accaduto immediatamente prima e dopo, il che è necessario quando il payload da solo è ambiguo.Confronta gli ID di correlazione e i timestamp in entrambe le viste quando manca un evento accoppiato o una durata.

Scopri i valori di filtro validi, quindi recupera i payload degli eventi completi per una sessione:

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

Utilizza fp --json events ... --fields ts,event_type,session_id,payload per l’ispezione leggibile da macchina.

​

Campi SDK riservati

​

Confini locali

• Lo stato di Failproof AI risiede in ~/.failproofai a meno che non sia configurato diversamente.
• failproofai-sdk esegue sempre lo spool in ~/.failproofai/custom-agents. FAILPROOFAI_HOME sposta quella home; il segmento custom-agents viene sempre aggiunto, quindi lo spool non può essere posizionato al di fuori di esso. Solo l’SDK stesso configure(base_dir=...) scrive altrove. AGENTEYE_HOME viene letto dal vecchio agenteye-collector per scegliere cosa monitorare e non influisce più su dove scrive l’SDK.
• Le etichette dell’ambiente possono essere impostate tramite la configurazione SDK o AGENTEYE_ENVIRONMENT.
• Le credenziali del daemon sono archiviate separatamente dalle impostazioni non segrete.

​

Modifica un’etichetta di ambiente

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