Démarrage rapide - Failproof AI

Ce guide de démarrage rapide vous permet de configurer une machine pour envoyer des sessions, d’effectuer un audit et de déployer une politique. Utilisez le skill pour configurer Failproof, ou suivez les étapes manuelles. Quelle est votre situation ? Si votre agent s’exécute dans l’un des 12 harnais pris en charge — une CLI de codage, ou une passerelle comme Hermes ou OpenClaw — suivez les étapes ci-dessous ; vous avez besoin de Node.js 20.9 ou ultérieur. Si votre agent n’a pas de harnais, instrumentez-le avec le SDK Python pour le traçage et les audits, puis rejoignez la section Exécuter votre premier contrôle d’échec ; l’application des politiques sur ce chemin nécessite un hook dans votre runtime.

Utiliser le skill
Configuration manuelle

Installer les skills Failproof AI

npx skills add FailproofAI/skills

Demandez à votre agent de tout configurer

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

Votre agent inspecte le projet, choisit l’intégration appropriée, effectue la configuration et vérifie le bon fonctionnement. Consultez le dépôt de skills FailproofAI pour les skills individuels et les options d’installation avancées.

Avant de commencer

Ouvrez le tableau de bord Failproof AI et créez un compte ou connectez-vous avec votre adresse e-mail professionnelle.
Allez dans Administration → Keys et créez une clé avec les droits events:add et policies:pull.
Copiez le secret à usage unique et stockez-le sur la machine cible :

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

Installation

Installer et connecter Failproof AI

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

Les transcripts de session sont envoyés par défaut. Ajoutez --no-transcripts pour signaler l’activité des hooks et les décisions de politique sans le contenu des transcripts.Si cette machine possède déjà un historique d’agent, prévisualisez et importez les sept derniers jours, puis attendez la fin de la livraison. Ignorez cette étape sur une nouvelle machine.

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

Ouvrez Sessions dans Failproof AI et sélectionnez une session importée.

Installer les hooks d'agent et les politiques

Cette étape attache Failproof AI à votre harnais et installe les 39 politiques intégrées. Utilisez-les pour visualiser les décisions de politique locales et tester l’application avant que Failproof AI n’audite vos sessions et n’écrive des politiques pour vos agents.Laissez l’installateur détecter votre harnais, ou nommez-en un explicitement. Chacune des 12 valeurs est valide pour --cli — claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose.

failproofai policies --install --cli claude --scope user     # une CLI de codage
failproofai policies --install --cli hermes --scope user     # une passerelle Slack/Telegram

Le blocage d’un appel d’outil avant son exécution est vérifié sur les 12 harnais. Les barrières de fin de tour sont vérifiées sur 8 — consultez la capacité d’application pour la matrice par harnais.

Auditer le comportement

Suivez Exécuter votre premier contrôle d’échec. Utilisez un objectif concret, par exemple : « trouver les sessions où l’agent a réessayé un outil défaillant sans changer d’approche. »

Prévenir l'échec

Suivez Prévenir votre premier échec avec une politique. Commencez en mode observation, inspectez les correspondances, puis appliquez la version révisée.

Exécutez failproofai config --status. Une configuration saine indique la connexion cloud, l’état du daemon et si l’application des politiques est en pause.

​Avant de commencer

​Installation

Avant de commencer

Installation