Guida rapida - Failproof AI

Questa guida rapida configura una macchina per la segnalazione delle sessioni, esegue un audit e distribuisce una policy. Utilizza lo skill per configurare Failproof, oppure segui i passaggi manuali. Quale percorso è il tuo? Se il tuo agente viene eseguito in uno dei 12 harness supportati — una CLI di codifica o un gateway come Hermes oppure OpenClaw — segui i passaggi di seguito; hai bisogno di Node.js 20.9 o successivo. Se il tuo agente non dispone di harness, strumentalo con Python SDK per il tracing e gli audit, quindi torna a Esegui il tuo primo controllo degli errori; l’enforcement su quel percorso richiede un hook nel tuo runtime.

Utilizza lo skill
Configurazione manuale

Installa gli skill Failproof AI

npx skills add FailproofAI/skills

Chiedi al tuo agente di configurare tutto

Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.

Il tuo agente ispeziona il progetto, sceglie l’integrazione rilevante, esegue la configurazione e la verifica. Consulta il repository degli skill FailproofAI per gli skill individuali e le opzioni di installazione avanzate.

Prima di iniziare

Apri il dashboard di Failproof AI e crea un account oppure accedi con la tua email di lavoro.
Vai a Administration → Keys e crea una chiave con events:add e policies:pull.
Copia il segreto monouso e salvalo sulla macchina di destinazione:

export FAILPROOFAI_KEY="<one-time-secret>"

Installa

Installa e connetti Failproof AI

npm install -g failproofai
failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"

I trascritti delle sessioni vengono inviati per impostazione predefinita. Aggiungi --no-transcripts per segnalare l’attività dell’hook e le decisioni delle policy senza il contenuto del trascritto.Se questa macchina dispone già di cronologia degli agenti, visualizza in anteprima e importa gli ultimi sette giorni, quindi attendi il completamento della consegna. Salta questo passaggio su una macchina nuova.

failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d
failproofai flush --wait

Apri Sessions in Failproof AI e seleziona una sessione importata.

Installa gli hook degli agenti e le policy

Questo collega Failproof AI al tuo harness e installa le 39 policy built-in. Utilizzale per visualizzare le decisioni delle policy locali e provare l’enforcement prima che Failproof AI auditi le tue sessioni e scritti le policy per i tuoi agenti.Consenti al programma di installazione di rilevare il tuo harness oppure denominarne uno in modo esplicito. Ognuno dei 12 è un valore --cli valido — claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose.

failproofai policies --install --cli claude --scope user     # a coding CLI
failproofai policies --install --cli hermes --scope user     # a Slack/Telegram gateway

Il blocco di una chiamata di strumento prima dell’esecuzione è verificato su tutti i 12. I gate di fine turno sono verificati su 8 — consulta enforcement capability per la matrice per harness.

Audita il comportamento

Segui Esegui il tuo primo controllo degli errori. Utilizza un obiettivo concreto come “trovare sessioni in cui l’agente ha ritentato uno strumento che non funzionava senza modificare il suo approccio.”

Previeni l'errore

Segui Previeni il tuo primo errore con una policy. Inizia in modalità osservazione, ispeziona le corrispondenze, quindi applica la versione revisionata.

Esegui failproofai config --status. Una configurazione integra segnala la connessione cloud, lo stato del daemon e se l’enforcement è in pausa.

​Prima di iniziare

​Installa

Prima di iniziare

Installa