Inicio rápido - Failproof AI

Esta guía de inicio rápido permite que una máquina reporte sesiones, ejecuta una auditoría y despliega una política. Usa la habilidad para configurar Failproof o sigue los pasos manuales. ¿Cuál es tu camino? Si tu agente corre en uno de los 12 harnesses soportados — una CLI de codificación o una pasarela como Hermes u OpenClaw — sigue los pasos a continuación; necesitas Node.js 20.9 o superior. Si tu agente no tiene harness, instrumenta con el SDK de Python para trazabilidad y auditorías, y luego continúa en Ejecuta tu primera verificación de fallos; la aplicación de políticas en esa ruta requiere un hook en tu entorno de ejecución.

Usar la habilidad
Configuración manual

Instala las habilidades de Failproof AI

npx skills add FailproofAI/skills

Pídele a tu agente que configure todo

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

Tu agente inspecciona el proyecto, elige la integración relevante, realiza la configuración y la verifica. Consulta el repositorio de habilidades de FailproofAI para ver habilidades individuales y opciones de instalación avanzadas.

Antes de empezar

Abre el panel de Failproof AI y crea una cuenta o inicia sesión con tu correo de trabajo.
Ve a Administration → Keys y crea una clave con events:add y policies:pull.
Copia el secreto de un solo uso y guárdalo en la máquina de destino:

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

Instalación

Instala y conecta Failproof AI

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

Las transcripciones de sesiones se envían por defecto. Añade --no-transcripts para reportar actividad de hooks y decisiones de políticas sin el contenido de las transcripciones.Si esta máquina ya tiene historial de agente, previsualiza e importa los últimos siete días, luego espera a que finalice la entrega. Omite este paso en una máquina nueva.

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

Abre Sessions en Failproof AI y selecciona una sesión importada.

Instala hooks y políticas del agente

Esto conecta Failproof AI a tu harness e instala las 39 políticas integradas. Úsalas para ver las decisiones de políticas locales y probar la aplicación antes de que Failproof AI audite tus sesiones y escriba políticas para tus agentes.Deja que el instalador detecte tu harness, o especifica uno explícitamente. Cualquiera de los 12 es un valor válido para --cli — claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose.

failproofai policies --install --cli claude --scope user     # una CLI de codificación
failproofai policies --install --cli hermes --scope user     # una pasarela de Slack/Telegram

Bloquear una llamada a herramienta antes de que se ejecute está verificado en los 12. Las compuertas de fin de turno están verificadas en 8 — consulta la capacidad de aplicación para ver la matriz por harness.

Audita el comportamiento

Sigue Ejecuta tu primera verificación de fallos. Usa un objetivo concreto como “encuentra sesiones donde el agente reintentó una herramienta fallida sin cambiar su enfoque”.

Previene el fallo

Sigue Previene tu primer fallo con una política. Comienza en modo de observación, inspecciona las coincidencias y luego aplica la versión revisada.

Ejecuta failproofai config --status. Una configuración saludable reporta la conexión a la nube, el estado del daemon y si la aplicación de políticas está en pausa.

​Antes de empezar

​Instalación

Antes de empezar

Instalación