Início Rápido - Failproof AI

Este início rápido configura uma máquina para reportar sessões, executa uma auditoria e implanta uma política. Use a skill para configurar o Failproof AI, ou siga as etapas manuais. Qual caminho é o seu? Se o seu agente roda em um dos 12 harnesses suportados — uma CLI de codificação ou um gateway como Hermes ou OpenClaw — siga os passos abaixo; você precisa do Node.js 20.9 ou superior. Se o seu agente não tem harness, instrumente-o com o Python SDK para rastreamento e auditorias, e então retome em Execute sua primeira verificação de falha; a aplicação de políticas nesse caminho requer um hook no seu runtime.

Usar a skill
Configuração manual

Instale as skills do Failproof AI

npx skills add FailproofAI/skills

Peça ao seu agente para configurar tudo

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

Seu agente inspeciona o projeto, escolhe a integração relevante, realiza a configuração e verifica o resultado. Consulte o repositório de skills do FailproofAI para skills individuais e opções avançadas de instalação.

Antes de começar

Abra o painel do Failproof AI e crie uma conta ou entre com seu e-mail de trabalho.
Vá em Administration → Keys e crie uma chave com events:add e policies:pull.
Copie o segredo de uso único e armazene-o na máquina de destino:

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

Instalar

Instale e conecte o Failproof AI

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

Transcrições de sessões são enviadas por padrão. Adicione --no-transcripts para reportar atividade de hooks e decisões de políticas sem o conteúdo das transcrições.Se esta máquina já possui histórico de agente, visualize e importe os últimos sete dias, depois aguarde a entrega ser concluída. Pule esta etapa em uma máquina nova.

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

Abra Sessions no Failproof AI e selecione uma sessão importada.

Instale hooks e políticas do agente

Isso conecta o Failproof AI ao seu harness e instala as 39 políticas integradas. Use-as para visualizar decisões de políticas locais e testar a aplicação antes que o Failproof AI audite suas sessões e crie políticas para seus agentes.Deixe o instalador detectar seu harness automaticamente, ou especifique um explicitamente. Qualquer um dos 12 é um valor válido para --cli — claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose.

failproofai policies --install --cli claude --scope user     # uma CLI de codificação
failproofai policies --install --cli hermes --scope user     # um gateway Slack/Telegram

O bloqueio de uma chamada de ferramenta antes de sua execução é verificado em todos os 12. Os gates de fim de turno são verificados em 8 — consulte a capacidade de aplicação para a matriz por harness.

Audite o comportamento

Siga Execute sua primeira verificação de falha. Use um objetivo concreto como “encontrar sessões em que o agente tentou novamente uma ferramenta com falha sem mudar sua abordagem.”

Previna a falha

Siga Previna sua primeira falha com uma política. Comece no modo de observação, inspecione as correspondências e então aplique a versão revisada.

Execute failproofai config --status. Uma configuração saudável reporta a conexão com a nuvem, o estado do daemon e se a aplicação de políticas está pausada.

​Antes de começar

​Instalar

Antes de começar

Instalar