Capture uma sessão de agente, encontre uma falha e comece a preveni-la.
Este início rápido faz uma máquina reportar sessões, executa uma auditoria e implanta uma política. Use a skill para configurar o Failproof ou siga os passos 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ê precisará do Node.js 20.9 ou superior. Se o seu agente não possui harness, instrumente-o com o Python SDK para rastreamento e auditorias, depois retome em Execute sua primeira verificação de falhas; a aplicação de políticas nesse caminho requer um hook no seu runtime.
Usar a skill
Configuração manual
1
Instalar as skills do Failproof AI
npx skills add FailproofAI/skills
2
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.
Vá em Administration → Keys e crie uma chave com events:add e policies:pull.
Copie o segredo de uso único e leia-o em um shell na máquina de destino. read -s solicita a entrada em um prompt que não exibe o que é digitado, portanto ele nunca aparece em um comando:
Esse único comando representa toda a configuração: instala o daemon local (root uma vez), conecta hooks em toda CLI de agente encontrada e conecta esta máquina ao Cloud. Passar a chave pela variável de ambiente em vez de --token mantém-a fora do ps, onde qualquer usuário da máquina pode ler os argumentos de um comando. Isso não a mantém fora do histórico do shell — ler com read -s é o que faz isso. Em CI, injete-a como um segredo mascarado e mantenha o rastreamento do shell (set -x) desativado, ou o trace a exibirá.Transcrições de sessão são enviadas por padrão. Adicione --no-transcripts para reportar a atividade de hooks e decisões de políticas sem o conteúdo das transcrições.
Não utilize failproofai config --connect <url> aqui. Esse flag registra uma máquina que já está configurada e retorna imediatamente — sem daemon, sem hooks — portanto a máquina apareceria no Cloud sem coletar nem aplicar nada.
Se esta máquina já tem histórico de agentes, pré-visualize e importe os últimos sete dias, depois aguarde a entrega ser concluída. Pule este passo em uma máquina nova.
Abra Sessions no Failproof AI e selecione uma sessão importada.
2
Conectar o Failproof AI a um harness
O passo anterior já conectou todos os CLIs de agente detectados. Execute-o novamente para um harness específico quando necessário, ou para adicionar um harness instalado posteriormente. Cada 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çãofailproofai policies --install --cli hermes --scope user # um gateway Slack/Telegram
O bloqueio de uma chamada de ferramenta antes de ela ser executada é verificado em todos os 12. Gates de fim de turno são verificados em 8 — consulte a capacidade de aplicação para a matriz por harness.
3
Escolher o que aplicar
Conectar hooks não ativa nenhuma política. A configuração intencionalmente não escolhe nenhuma — essa decisão é sua — então pegue um pacote:
failproofai policies add FailproofAI/policies
O pacote é baixado do seu release no GitHub, verificado por checksum e fixado na tag exata resolvida. Ele contém 38 políticas e ativa as 10 que seu manifesto marca como seguras para habilitar sem supervisão. Use-as para visualizar decisões de políticas locais e experimentar a aplicação antes que o Failproof AI audite suas sessões e escreva políticas para seus agentes.Leia qualquer pacote antes de adotá-lo com failproofai policies show <owner>/<repo>, e consulte pacotes de políticas para adotar apenas parte de um.Até que isso seja executado, a única coisa aplicando regras é block-failproofai-commands — a proteção sempre ativa que impede um agente de desligar o Failproof AI. failproofai policies lista o que está ativo.
4
Auditar o comportamento
Siga Execute sua primeira verificação de falhas. Use um objetivo concreto, como “encontrar sessões em que o agente tentou novamente uma ferramenta com falha sem mudar sua abordagem.”
Execute failproofai config --status. Uma configuração saudável reporta a conexão com o cloud, o estado do daemon e se a aplicação de políticas está pausada.
Esta página foi útil?
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Failproof AI","description":"The reliability layer for autonomous agents: trace every run, find where agents fail, and stop it with policies enforced in realtime.","colors":{"primary":"#c92251","light":"#e4587d","dark":"#e4587d"},"logo":{"light":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0","dark":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=3f0e8fc7951c3550b7fdeabbca03daff","href":"https://befailproof.ai"},"favicon":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/favicon.ico?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=ef7e5e9c419deaf5a2298f5ef6d5929f","api":{"openapi":"reference/openapi.json","playground":{"display":"simple"},"examples":{"languages":["curl","python","javascript"]}},"navbar":{"links":[{"icon":"discord","href":"https://discord.befailproof.ai","label":""},{"icon":"reddit","href":"https://www.reddit.com/r/failproofai/","label":""},{"icon":"x-twitter","href":"https://x.com/failproofai","label":""},{"icon":"github","href":"https://github.com/FailproofAI/failproofai","label":"⭐ 1.5k"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.befailproof.ai"}},"footer":{"socials":{"github":"https://github.com/FailproofAI/failproofai","x":"https://x.com/failproofai"}},"search":{"prompt":"Search Failproof AI docs"},"seo":{"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"},{"language":"ja","href":"ja"},{"language":"ko","href":"ko"},{"language":"es","href":"es"},{"language":"pt-BR","href":"pt-br"},{"language":"de","href":"de"},{"language":"fr","href":"fr"},{"language":"ru","href":"ru"},{"language":"hi","href":"hi"},{"language":"tr","href":"tr"},{"language":"vi","href":"vi"},{"language":"it","href":"it"},{"language":"ar","href":"ar"},{"language":"he","href":"he"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"exosphere","hasAudioNarration":false,"actualSubdomain":"exosphere","customDomains":["docs.befailproof.ai"],"gitSource":{"type":"github","owner":"failproofai","repo":"failproofai","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afdb4dca93dec3133f828e2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Integrations and reference","count":130},{"language":"en","tag":"HTTP API","count":109},{"language":"en","tag":"Trace","count":18},{"language":"en","tag":"Audits","count":18},{"language":"en","tag":"Analyse","count":17},{"language":"ar","tag":"Trace","count":17},{"language":"de","tag":"Trace","count":17},{"language":"es","tag":"Trace","count":17},{"language":"fr","tag":"Trace","count":17},{"language":"he","tag":"Trace","count":17},{"language":"hi","tag":"Trace","count":17},{"language":"it","tag":"Trace","count":17},{"language":"ja","tag":"Trace","count":17},{"language":"ko","tag":"Trace","count":17},{"language":"pt-BR","tag":"Trace","count":17},{"language":"ru","tag":"Trace","count":17},{"language":"tr","tag":"Trace","count":17},{"language":"vi","tag":"Trace","count":17},{"language":"zh","tag":"Trace","count":17},{"language":"en","tag":"Issues","count":15},{"language":"en","tag":"Events","count":14},{"language":"ar","tag":"Analyse","count":14},{"language":"de","tag":"Analyse","count":14},{"language":"es","tag":"Analyse","count":14},{"language":"fr","tag":"Analyse","count":14},{"language":"he","tag":"Analyse","count":14},{"language":"hi","tag":"Analyse","count":14},{"language":"it","tag":"Analyse","count":14},{"language":"ja","tag":"Analyse","count":14},{"language":"ko","tag":"Analyse","count":14},{"language":"pt-BR","tag":"Analyse","count":14},{"language":"ru","tag":"Analyse","count":14},{"language":"tr","tag":"Analyse","count":14},{"language":"vi","tag":"Analyse","count":14},{"language":"zh","tag":"Analyse","count":14},{"language":"en","tag":"Settings","count":13},{"language":"en","tag":"Start","count":13},{"language":"en","tag":"Start here","count":13},{"language":"ar","tag":"Integrations and reference","count":13},{"language":"de","tag":"Integrations and reference","count":13},{"language":"es","tag":"Integrations and reference","count":13},{"language":"fr","tag":"Integrations and reference","count":13},{"language":"he","tag":"Integrations and reference","count":13},{"language":"hi","tag":"Integrations and reference","count":13},{"language":"it","tag":"Integrations and reference","count":13},{"language":"ja","tag":"Integrations and reference","count":13},{"language":"ko","tag":"Integrations and reference","count":13},{"language":"pt-BR","tag":"Integrations and reference","count":13},{"language":"ru","tag":"Integrations and reference","count":13},{"language":"tr","tag":"Integrations and reference","count":13},{"language":"vi","tag":"Integrations and reference","count":13},{"language":"zh","tag":"Integrations and reference","count":13},{"language":"ar","tag":"Start","count":12},{"language":"ar","tag":"Start here","count":12},{"language":"de","tag":"Start","count":12},{"language":"de","tag":"Start here","count":12},{"language":"es","tag":"Start","count":12},{"language":"es","tag":"Start here","count":12},{"language":"fr","tag":"Start","count":12},{"language":"fr","tag":"Start here","count":12},{"language":"he","tag":"Start","count":12},{"language":"he","tag":"Start here","count":12},{"language":"hi","tag":"Start","count":12},{"language":"hi","tag":"Start here","count":12},{"language":"it","tag":"Start","count":12},{"language":"it","tag":"Start here","count":12},{"language":"ja","tag":"Start","count":12},{"language":"ja","tag":"Start here","count":12},{"language":"ko","tag":"Start","count":12},{"language":"ko","tag":"Start here","count":12},{"language":"pt-BR","tag":"Start","count":12},{"language":"pt-BR","tag":"Start here","count":12},{"language":"ru","tag":"Start","count":12},{"language":"ru","tag":"Start here","count":12},{"language":"tr","tag":"Start","count":12},{"language":"tr","tag":"Start here","count":12},{"language":"vi","tag":"Start","count":12},{"language":"vi","tag":"Start here","count":12},{"language":"zh","tag":"Start","count":12},{"language":"zh","tag":"Start here","count":12},{"language":"ar","tag":"Understand every run","count":11},{"language":"de","tag":"Understand every run","count":11},{"language":"es","tag":"Understand every run","count":11},{"language":"fr","tag":"Understand every run","count":11},{"language":"he","tag":"Understand every run","count":11},{"language":"hi","tag":"Understand every run","count":11},{"language":"it","tag":"Understand every run","count":11},{"language":"ja","tag":"Understand every run","count":11},{"language":"ko","tag":"Understand every run","count":11},{"language":"pt-BR","tag":"Understand every run","count":11},{"language":"ru","tag":"Understand every run","count":11},{"language":"tr","tag":"Understand every run","count":11},{"language":"vi","tag":"Understand every run","count":11},{"language":"zh","tag":"Understand every run","count":11},{"language":"ar","tag":"Find and manage failures","count":9},{"language":"de","tag":"Find and manage failures","count":9},{"language":"es","tag":"Find and manage failures","count":9},{"language":"fr","tag":"Find and manage failures","count":9},{"language":"he","tag":"Find and manage failures","count":9},{"language":"hi","tag":"Find and manage failures","count":9},{"language":"it","tag":"Find and manage failures","count":9},{"language":"ja","tag":"Find and manage failures","count":9},{"language":"ko","tag":"Find and manage failures","count":9},{"language":"pt-BR","tag":"Find and manage failures","count":9},{"language":"ru","tag":"Find and manage failures","count":9},{"language":"tr","tag":"Find and manage failures","count":9},{"language":"vi","tag":"Find and manage failures","count":9},{"language":"zh","tag":"Find and manage failures","count":9},{"language":"ar","tag":"Fix","count":8},{"language":"de","tag":"Fix","count":8},{"language":"es","tag":"Fix","count":8},{"language":"fr","tag":"Fix","count":8},{"language":"he","tag":"Fix","count":8},{"language":"hi","tag":"Fix","count":8},{"language":"it","tag":"Fix","count":8},{"language":"ja","tag":"Fix","count":8},{"language":"ko","tag":"Fix","count":8},{"language":"pt-BR","tag":"Fix","count":8},{"language":"ru","tag":"Fix","count":8},{"language":"tr","tag":"Fix","count":8},{"language":"vi","tag":"Fix","count":8},{"language":"zh","tag":"Fix","count":8},{"language":"ar","tag":"Reference","count":7},{"language":"de","tag":"Reference","count":7},{"language":"es","tag":"Reference","count":7},{"language":"fr","tag":"Reference","count":7},{"language":"he","tag":"Reference","count":7},{"language":"hi","tag":"Reference","count":7},{"language":"it","tag":"Reference","count":7},{"language":"ja","tag":"Reference","count":7},{"language":"ko","tag":"Reference","count":7},{"language":"pt-BR","tag":"Reference","count":7},{"language":"ru","tag":"Reference","count":7},{"language":"tr","tag":"Reference","count":7},{"language":"vi","tag":"Reference","count":7},{"language":"zh","tag":"Reference","count":7},{"language":"ar","tag":"Connect your agents","count":6},{"language":"de","tag":"Connect your agents","count":6},{"language":"es","tag":"Connect your agents","count":6},{"language":"fr","tag":"Connect your agents","count":6},{"language":"he","tag":"Connect your agents","count":6},{"language":"hi","tag":"Connect your agents","count":6},{"language":"it","tag":"Connect your agents","count":6},{"language":"ja","tag":"Connect your agents","count":6},{"language":"ko","tag":"Connect your agents","count":6},{"language":"pt-BR","tag":"Connect your agents","count":6},{"language":"ru","tag":"Connect your agents","count":6},{"language":"tr","tag":"Connect your agents","count":6},{"language":"vi","tag":"Connect your agents","count":6},{"language":"zh","tag":"Connect your agents","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--fpai-pink: #c92251}.dark{--fpai-pink: #e4587d}h1,h2,h3{letter-spacing:-0.025em}#content blockquote{position:relative;margin:1.5rem 0;padding:1.25rem 1.5rem 1.25rem 3.75rem!important;border-left:4px solid var(--fpai-pink)!important;border-radius:0 14px 14px 0;background:#f3f4f6!important;color:inherit!important}#content blockquote::before{content:\"“\";position:absolute;top:0.35rem;left:1rem;color:var(--fpai-pink);font-size:3rem;font-weight:700;line-height:1}#content blockquote p:first-child{margin-top:0}#content blockquote p:last-child{margin-bottom:0}.dark #content blockquote{background:rgba(148, 163, 184, 0.12)!important}.navbar-link a[href=\"https://discord.befailproof.ai\"],.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"],.navbar-link a[href=\"https://x.com/failproofai\"],.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"],#topbar-cta-button a[href=\"https://app.befailproof.ai\"]{position:relative}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after,.navbar-link a[href=\"https://x.com/failproofai\"]::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{position:absolute;top:calc(100% + 0.5rem);left:50%;z-index:50;padding:0.35rem 0.55rem;border-radius:0.4rem;background:#111827;color:#fff;font-size:0.75rem;font-weight:500;line-height:1;opacity:0;pointer-events:none;transform:translate(-50%, -0.2rem);transition:opacity 120ms ease, transform 120ms ease}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after{content:\"Join the community\"}.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after{content:\"Join r/failproofai\"}.navbar-link a[href=\"https://x.com/failproofai\"]::after{content:\"Follow launches\"}.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after{content:\"Star us!\"}#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{content:\"Go to Failproof\"}.navbar-link a[href=\"https://discord.befailproof.ai\"]:hover::after,.navbar-link a[href=\"https://discord.befailproof.ai\"]:focus-visible::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:hover::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:focus-visible::after,.navbar-link a[href=\"https://x.com/failproofai\"]:hover::after,.navbar-link a[href=\"https://x.com/failproofai\"]:focus-visible::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:hover::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:focus-visible::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:hover::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:focus-visible::after{opacity:1;transform:translate(-50%, 0)}img[src^=\"/images/frameworks/\"]{opacity:0.78}.dark img[src^=\"/images/frameworks/\"]{filter:invert(1);opacity:0.7}"}]}
{"page":{"pagePath":"pt-br/start/quickstart","slug":"/pt-br/start/quickstart","pageMetadata":{"title":"Início Rápido","description":"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.","icon":"zap","href":"/pt-br/start/quickstart"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Check,CodeBlock,Heading,Step,Steps,Tab,Tabs,Warning}=_components;if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Este início rápido faz uma máquina reportar sessões, executa uma auditoria e implanta uma política. Use a skill para configurar o Failproof ou siga os passos manuais.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Qual caminho é o seu?`}),` Se o seu agente roda em um dos 12 `,_jsx(_components.a,{href:`/pt-br/reference/harnesses`,children:`harnesses`}),` suportados — uma CLI de codificação, ou um gateway como Hermes ou OpenClaw — siga os passos abaixo; você precisará do Node.js 20.9 ou superior. Se o seu agente não possui harness, instrumente-o com o `,_jsx(_components.a,{href:`/pt-br/reference/custom-agents`,children:`Python SDK`}),` para rastreamento e auditorias, depois retome em `,_jsx(_components.a,{href:`/pt-br/start/first-audit`,children:`Execute sua primeira verificação de falhas`}),`; a aplicação de políticas nesse caminho requer um hook no seu runtime.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Usar a skill`,id:`usar-a-skill`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Instalar as skills do Failproof AI`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` skills`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` FailproofAI/skills`})]}),`\n`]})})})}),_jsxs(Step,{title:`Peça ao seu agente para configurar tudo`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Seu agente inspeciona o projeto, escolhe a integração relevante, realiza a configuração e verifica o resultado. Consulte o `,_jsx(_components.a,{href:`https://github.com/FailproofAI/skills`,children:`repositório de skills do FailproofAI`}),` para skills individuais e opções avançadas de instalação.`]})]})]})}),_jsxs(Tab,{title:`Configuração manual`,id:`configura%C3%A7%C3%A3o-manual`,\"data-child-heading-ids\":`[\"antes-de-come%C3%A7ar\",\"instala%C3%A7%C3%A3o\"]`,children:[_jsx(Heading,{level:`2`,id:`antes-de-começar`,children:`Antes de começar`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Abra o `,_jsx(_components.a,{href:`https://app.befailproof.ai`,children:`dashboard do Failproof AI`}),` e crie uma conta ou faça login com seu e-mail corporativo.`]}),`\n`,_jsxs(_components.li,{children:[`Vá em `,_jsx(_components.strong,{children:`Administration → Keys`}),` e crie uma chave com `,_jsx(_components.code,{children:`events:add`}),` e `,_jsx(_components.code,{children:`policies:pull`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Copie o segredo de uso único e leia-o em um shell na máquina de destino. `,_jsx(_components.code,{children:`read -s`}),` solicita a entrada em um prompt que não exibe o que é digitado, portanto ele nunca aparece em um comando:`]}),`\n`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`read`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -rs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` FAILPROOFAI_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` FAILPROOFAI_KEY`})]}),`\n`]})})}),_jsx(Heading,{level:`2`,id:`instalação`,children:`Instalação`}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Instalar e conectar o Failproof AI`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -g`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` failproofai`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`FAILPROOFAI_CLOUD_TOKEN`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$FAILPROOFAI_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Esse único comando representa toda a configuração: instala o daemon local (root uma vez), conecta hooks em toda CLI de agente encontrada e conecta esta máquina ao Cloud. Passar a chave pela variável de ambiente em vez de `,_jsx(_components.code,{children:`--token`}),` mantém-a fora do `,_jsx(_components.code,{children:`ps`}),`, onde qualquer usuário da máquina pode ler os argumentos de um comando. Isso não a mantém fora do histórico do shell — ler com `,_jsx(_components.code,{children:`read -s`}),` é o que faz isso. Em CI, injete-a como um segredo mascarado e mantenha o rastreamento do shell (`,_jsx(_components.code,{children:`set -x`}),`) desativado, ou o trace a exibirá.`]}),_jsxs(_components.p,{children:[`Transcrições de sessão são enviadas por padrão. Adicione `,_jsx(_components.code,{children:`--no-transcripts`}),` para reportar a atividade de hooks e decisões de políticas sem o conteúdo das transcrições.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Não utilize `,_jsx(_components.code,{children:`failproofai config --connect \u003curl>`}),` aqui. Esse flag registra uma máquina que `,_jsx(_components.strong,{children:`já`}),` está configurada e retorna imediatamente — sem daemon, sem hooks — portanto a máquina apareceria no Cloud sem coletar nem aplicar nada.`]})}),_jsx(_components.p,{children:`Se esta máquina já tem histórico de agentes, pré-visualize e importe os últimos sete dias, depois aguarde a entrega ser concluída. Pule este passo em uma máquina nova.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` backfill`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --since`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 7d`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --dry-run`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` backfill`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --since`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 7d`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` flush`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --wait`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Abra `,_jsx(_components.strong,{children:`Sessions`}),` no Failproof AI e selecione uma sessão importada.`]})]}),_jsxs(Step,{title:`Conectar o Failproof AI a um harness`,children:[_jsxs(_components.p,{children:[`O passo anterior já conectou todos os CLIs de agente detectados. Execute-o novamente para um harness específico quando necessário, ou para adicionar um harness instalado posteriormente. Cada um dos 12 é um valor válido para `,_jsx(_components.code,{children:`--cli`}),` — `,_jsx(_components.code,{children:`claude`}),`, `,_jsx(_components.code,{children:`codex`}),`, `,_jsx(_components.code,{children:`copilot`}),`, `,_jsx(_components.code,{children:`cursor`}),`, `,_jsx(_components.code,{children:`opencode`}),`, `,_jsx(_components.code,{children:`pi`}),`, `,_jsx(_components.code,{children:`hermes`}),`, `,_jsx(_components.code,{children:`openclaw`}),`, `,_jsx(_components.code,{children:`factory`}),`, `,_jsx(_components.code,{children:`devin`}),`, `,_jsx(_components.code,{children:`antigravity`}),`, `,_jsx(_components.code,{children:`goose`}),`.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policies`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` claude`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # uma CLI de codificação`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policies`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` hermes`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # um gateway Slack/Telegram`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`O bloqueio de uma chamada de ferramenta antes de ela ser executada é verificado em todos os 12. Gates de fim de turno são verificados em 8 — consulte a `,_jsx(_components.a,{href:`/pt-br/reference/harnesses#capacidade-de-enforcement`,children:`capacidade de aplicação`}),` para a matriz por harness.`]})]}),_jsxs(Step,{title:`Escolher o que aplicar`,children:[_jsx(_components.p,{children:`Conectar hooks não ativa nenhuma política. A configuração intencionalmente não escolhe nenhuma — essa decisão é sua — então pegue um pacote:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policies`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` FailproofAI/policies`})]}),`\n`]})})}),_jsx(_components.p,{children:`O pacote é baixado do seu release no GitHub, verificado por checksum e fixado na tag exata resolvida. Ele contém 38 políticas e ativa as 10 que seu manifesto marca como seguras para habilitar sem supervisão. Use-as para visualizar decisões de políticas locais e experimentar a aplicação antes que o Failproof AI audite suas sessões e escreva políticas para seus agentes.`}),_jsxs(_components.p,{children:[`Leia qualquer pacote antes de adotá-lo com `,_jsx(_components.code,{children:`failproofai policies show \u003cowner>/\u003crepo>`}),`, e consulte `,_jsx(_components.a,{href:`/pt-br/policies/packs`,children:`pacotes de políticas`}),` para adotar apenas parte de um.`]}),_jsxs(_components.p,{children:[`Até que isso seja executado, a única coisa aplicando regras é `,_jsx(_components.code,{children:`block-failproofai-commands`}),` — a proteção sempre ativa que impede um agente de desligar o Failproof AI. `,_jsx(_components.code,{children:`failproofai policies`}),` lista o que está ativo.`]})]}),_jsx(Step,{title:`Auditar o comportamento`,children:_jsxs(_components.p,{children:[`Siga `,_jsx(_components.a,{href:`/pt-br/start/first-audit`,children:`Execute sua primeira verificação de falhas`}),`. Use um objetivo concreto, como “encontrar sessões em que o agente tentou novamente uma ferramenta com falha sem mudar sua abordagem.”`]})}),_jsx(Step,{title:`Prevenir a falha`,children:_jsxs(_components.p,{children:[`Siga `,_jsx(_components.a,{href:`/pt-br/start/first-policy`,children:`Previna sua primeira falha com uma política`}),`. Comece no modo de observação, inspecione as correspondências e depois aplique a versão revisada.`]})})]}),_jsx(Check,{children:_jsxs(_components.p,{children:[`Execute `,_jsx(_components.code,{children:`failproofai config --status`}),`. Uma configuração saudável reporta a conexão com o cloud, o estado do daemon e se a aplicação de políticas está pausada.`]})})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Início Rápido","description":"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.","icon":"zap","href":"/pt-br/start/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Antes de começar","slug":"antes-de-começar","depth":2,"children":[],"tabId":"configura%C3%A7%C3%A3o-manual"},{"title":"Instalação","slug":"instalação","depth":2,"children":[],"tabId":"configura%C3%A7%C3%A3o-manual"}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/exosphere/86fd84cc0563b6f3/stars.js","/_mintlify/custom/exosphere/3e9809a158d7fc0b/reo.js"],"subdomain":"exosphere","siteName":"Failproof AI","title":"Início Rápido - Failproof AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/start/quickstart","matchLevel":1},"zh":{"href":"/zh/start/quickstart","matchLevel":1},"ja":{"href":"/ja/start/quickstart","matchLevel":1},"ko":{"href":"/ko/start/quickstart","matchLevel":1},"es":{"href":"/es/start/quickstart","matchLevel":1},"pt-BR":{"href":"/pt-br/start/quickstart","matchLevel":0},"de":{"href":"/de/start/quickstart","matchLevel":1},"fr":{"href":"/fr/start/quickstart","matchLevel":1},"ru":{"href":"/ru/start/quickstart","matchLevel":1},"hi":{"href":"/hi/start/quickstart","matchLevel":1},"tr":{"href":"/tr/start/quickstart","matchLevel":1},"vi":{"href":"/vi/start/quickstart","matchLevel":1},"it":{"href":"/it/start/quickstart","matchLevel":1},"ar":{"href":"/ar/start/quickstart","matchLevel":1},"he":{"href":"/he/start/quickstart","matchLevel":1}}},"lastModified":"2026-09-15T05:52:36.261Z","originalFileLocation":"pt-br/start/quickstart.mdx","locale":"pt-BR"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Início Rápido - Failproof AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Failproof AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.befailproof.ai/pt-br/start/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=In%C3%ADcio+R%C3%A1pido\u0026amp;description=Capture+uma+sess%C3%A3o+de+agente%2C+encontre+uma+falha+e+comece+a+preveni-la.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=ec31da64e1718aa759a07f863d7b002230e6a0cd40b7314b01942285976bf6c3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Início Rápido - Failproof AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=In%C3%ADcio+R%C3%A1pido\u0026amp;description=Capture+uma+sess%C3%A3o+de+agente%2C+encontre+uma+falha+e+comece+a+preveni-la.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=ec31da64e1718aa759a07f863d7b002230e6a0cd40b7314b01942285976bf6c3\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c92251\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.befailproof.ai/pt-br/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pt-br/start/quickstart.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.befailproof.ai/pt-br/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.befailproof.ai/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.befailproof.ai/zh/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.befailproof.ai/ja/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.befailproof.ai/ko/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.befailproof.ai/es/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.befailproof.ai/de/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.befailproof.ai/fr/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.befailproof.ai/ru/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hi\" href=\"https://docs.befailproof.ai/hi/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://docs.befailproof.ai/tr/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"vi\" href=\"https://docs.befailproof.ai/vi/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.befailproof.ai/it/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.befailproof.ai/ar/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"he\" href=\"https://docs.befailproof.ai/he/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.befailproof.ai/start/quickstart\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.befailproof.ai/#organization\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.befailproof.ai#website\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.befailproof.ai/pt-br/start/quickstart#webpage\",\"url\":\"https://docs.befailproof.ai/pt-br/start/quickstart\",\"name\":\"Início Rápido\",\"description\":\"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.\",\"dateModified\":\"2026-09-15T05:52:36.261Z\",\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.befailproof.ai/pt-br/start/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.befailproof.ai/pt-br/start/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start here\",\"item\":\"https://docs.befailproof.ai/pt-br\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Início Rápido\",\"item\":\"https://docs.befailproof.ai/pt-br/start/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.befailproof.ai/pt-br/start/quickstart#article\",\"headline\":\"Início Rápido\",\"name\":\"Início Rápido\",\"description\":\"Capture uma sessão de agente, encontre uma falha e comece a preveni-la.\",\"url\":\"https://docs.befailproof.ai/pt-br/start/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://docs.befailproof.ai/pt-br/start/quickstart#webpage\"},\"dateModified\":\"2026-09-15T05:52:36.261Z\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Failproof AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Failproof AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/pt-br/start/quickstart.md","siteName":"Failproof AI","nav":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","pages":[{"title":"en","href":"/start/quickstart"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/start/quickstart"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/start/quickstart"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/start/quickstart"}]},{"language":"es","pages":[{"title":"es","href":"/es/start/quickstart"}]},{"language":"pt-BR","tabs":[{"tab":"Start","icon":"rocket","groups":[{"group":"Start here","pages":[{"title":"Torne seu agente à prova de falhas","description":"Observabilidade e controle para cada ambiente em que seus agentes operam — CLIs de codificação, gateways de chat, assistentes auto-hospedados e seus próprios agentes instrumentados.","icon":"shield-check","href":"/pt-br"},{"title":"Início Rápido","icon":"zap","href":"/pt-br/start/quickstart"},{"title":"Harnesses de agentes","description":"Capture sessões e aplique políticas em todos os 12 harnesses de agentes suportados.","icon":"plug-zap","href":"/pt-br/reference/harnesses"},{"title":"Assistente Failproof","icon":"message-square-text","href":"/pt-br/sessions/assistant"},{"title":"Execute sua primeira verificação de falha","icon":"scan-search","href":"/pt-br/start/first-audit"},{"title":"Evite sua primeira falha com uma política","icon":"shield-check","href":"/pt-br/start/first-policy"},{"title":"Escolha sua configuração","icon":"waypoints","href":"/pt-br/start/setup"},{"title":"Conceitos principais","icon":"boxes","href":"/pt-br/start/concepts"},{"group":"Starter templates","expanded":false,"pages":[{"title":"Agentes personalizados","icon":"code","href":"/pt-br/start/quickstarts/custom-agents"},{"title":"LangChain e LangGraph","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/langchain.svg","href":"/pt-br/start/quickstarts/langchain"},{"title":"CrewAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/crewai.svg","href":"/pt-br/start/quickstarts/crewai"},{"title":"LlamaIndex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/llamaindex.svg","href":"/pt-br/start/quickstarts/llamaindex"},{"title":"Pydantic AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/pydantic-ai.svg","href":"/pt-br/start/quickstarts/pydantic-ai"}]}]}]},{"tab":"Trace","icon":"route","pages":[{"title":"Trace","href":"/pt-br/sessions/overview"}]},{"tab":"Analyse","icon":"scan-search","pages":[{"title":"Analyse","href":"/pt-br/evaluations/overview"}]},{"tab":"Fix","icon":"shield-check","pages":[{"title":"Fix","href":"/pt-br/policies/overview"}]},{"tab":"Settings","icon":"settings-2","pages":[{"title":"Settings","href":"/pt-br/admin/overview"}]},{"tab":"Integrations and reference","icon":"braces","pages":[{"title":"Integrations and reference","href":"/pt-br/reference/overview"}]}]},{"language":"de","pages":[{"title":"de","href":"/de/start/quickstart"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/start/quickstart"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/start/quickstart"}]},{"language":"hi","pages":[{"title":"hi","href":"/hi/start/quickstart"}]},{"language":"tr","pages":[{"title":"tr","href":"/tr/start/quickstart"}]},{"language":"vi","pages":[{"title":"vi","href":"/vi/start/quickstart"}]},{"language":"it","pages":[{"title":"it","href":"/it/start/quickstart"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/start/quickstart"}]},{"language":"he","pages":[{"title":"he","href":"/he/start/quickstart"}]}]},"basePath":"","title":"Início Rápido - Failproof AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}