Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.
Questa guida introduttiva configura una macchina per segnalare sessioni, esegue un audit e distribuisce una policy. Usa la skill per configurare Failproof AI, oppure segui i passaggi manuali.Quale percorso è il tuo? Se il tuo agente funziona in uno dei 12 harness supportati — una CLI di coding o un gateway come Hermes o OpenClaw — segui i passaggi seguenti; hai bisogno di Node.js 20.9 o versioni successive. Se il tuo agente non ha un harness, strumentalo con Python SDK per il tracing e gli audit, quindi unisciti a Esegui il tuo primo controllo di errore; l’enforcement su quel percorso richiede un hook nel tuo runtime.
Usa la skill
Configurazione manuale
1
Installa le skill Failproof AI
npx skills add FailproofAI/skills
2
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 delle skill FailproofAI per le skill individuali e le opzioni di installazione avanzate.
Vai a Administration → Keys e crea una chiave con events:add e policies:pull.
Copia il segreto monouso, quindi leggilo in una shell sulla macchina di destinazione. read -s lo accetta da un prompt che non viene visualizzato, quindi non appare mai in un comando:
Un unico comando completa tutta la configurazione: installa il daemon locale (root una volta), collega i hook in ogni CLI di agente che trova e connette questa macchina al Cloud. Passare la chiave attraverso l’ambiente piuttosto che tramite --token la mantiene fuori da ps, dove ogni utente della macchina può leggere gli argomenti di un comando. Non la mantiene fuori dalla cronologia della shell — leggerla con read -s è quello che lo fa. In CI, inettala come segreto mascherato e mantieni il tracing della shell (set -x) disattivato, altrimenti la traccia la stampa.Le trascrizioni delle sessioni vengono inviate per impostazione predefinita. Aggiungi --no-transcripts per segnalare l’attività degli hook e le decisioni sulle policy senza il contenuto della trascrizione.
Non usare failproofai config --connect <url> qui. Quel flag iscrive una macchina che è già configurata e ritorna subito — nessun daemon, nessun hook — quindi la macchina apparirebbe nel Cloud senza raccogliere e applicare nulla.
Se questa macchina ha già una cronologia di agenti, visualizza in anteprima e importa gli ultimi sette giorni, quindi attendi il completamento della consegna. Salta questo passaggio su una nuova macchina.
Apri Sessions in Failproof AI e seleziona una sessione importata.
2
Collega Failproof AI a un harness
Il passaggio precedente ha già collegato ogni CLI di agente rilevata. Eseguilo nuovamente per un harness esplicitamente quando necessario, o per aggiungere un harness installato successivamente. 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 CLIfailproofai policies --install --cli hermes --scope user # a Slack/Telegram gateway
Il blocco di una chiamata di tool prima che venga eseguita è verificato su tutti i 12. I gate di fine turno sono verificati su 8 — consulta enforcement capability per la matrice per harness.
3
Scegli cosa applicare
Il collegamento dei hook non abilita alcuna policy. La configurazione deliberatamente non ne sceglie nessuna — quella decisione è tua — quindi prendi un pacchetto:
failproofai policies add FailproofAI/policies
Il pacchetto viene recuperato dal suo rilascio GitHub, verificato con checksum e bloccato al tag esatto in cui è stato risolto. Contiene 38 policy e attiva le 10 che il suo manifest contrassegna come sicure da abilitare in modo non presidiato. Usale per vedere le decisioni delle policy locali e provare l’enforcement prima che Failproof AI auditi le tue sessioni e scriva policy per i tuoi agenti.Leggi qualsiasi pacchetto prima di prenderlo con failproofai policies show <owner>/<repo>, e consulta policy packs per prendere solo parte di uno.Finché questo non viene eseguito, l’unica cosa che applica è block-failproofai-commands — la guardia sempre attiva che impedisce a un agente di disattivare Failproof AI. failproofai policies elenca cosa è attivo.
4
Controlla il comportamento
Segui Esegui il tuo primo controllo di errore. Usa un obiettivo concreto come trovare sessioni in cui l’agente ha ritentato un tool non riuscito senza cambiare il suo approccio.
Esegui failproofai config --status. Una configurazione corretta segnala la connessione cloud, lo stato del daemon e se l’enforcement è in pausa.
Questa pagina è stata utile?
{"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":"it/start/quickstart","slug":"/it/start/quickstart","pageMetadata":{"title":"Guida introduttiva","description":"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.","icon":"zap","href":"/it/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: \"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.\"\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:`Questa guida introduttiva configura una macchina per segnalare sessioni, esegue un audit e distribuisce una policy. Usa la skill per configurare Failproof AI, oppure segui i passaggi manuali.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Quale percorso è il tuo?`}),` Se il tuo agente funziona in uno dei 12 `,_jsx(_components.a,{href:`/it/reference/harnesses`,children:`harness`}),` supportati — una CLI di coding o un gateway come Hermes o OpenClaw — segui i passaggi seguenti; hai bisogno di Node.js 20.9 o versioni successive. Se il tuo agente non ha un harness, strumentalo con `,_jsx(_components.a,{href:`/it/reference/custom-agents`,children:`Python SDK`}),` per il tracing e gli audit, quindi unisciti a `,_jsx(_components.a,{href:`/it/start/first-audit`,children:`Esegui il tuo primo controllo di errore`}),`; l’enforcement su quel percorso richiede un hook nel tuo runtime.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Usa la skill`,id:`usa-la-skill`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Installa le skill 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:`Chiedi al tuo agente di configurare tutto`,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:[`Il tuo agente ispeziona il progetto, sceglie l’integrazione rilevante, esegue la configurazione e la verifica. Consulta il `,_jsx(_components.a,{href:`https://github.com/FailproofAI/skills`,children:`repository delle skill FailproofAI`}),` per le skill individuali e le opzioni di installazione avanzate.`]})]})]})}),_jsxs(Tab,{title:`Configurazione manuale`,id:`configurazione-manuale`,\"data-child-heading-ids\":`[\"prima-di-iniziare\",\"installa\"]`,children:[_jsx(Heading,{level:`2`,id:`prima-di-iniziare`,children:`Prima di iniziare`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Apri il `,_jsx(_components.a,{href:`https://app.befailproof.ai`,children:`dashboard Failproof AI`}),` e crea un account o accedi con la tua email aziendale.`]}),`\n`,_jsxs(_components.li,{children:[`Vai a `,_jsx(_components.strong,{children:`Administration → Keys`}),` e crea una chiave con `,_jsx(_components.code,{children:`events:add`}),` e `,_jsx(_components.code,{children:`policies:pull`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Copia il segreto monouso, quindi leggilo in una shell sulla macchina di destinazione. `,_jsx(_components.code,{children:`read -s`}),` lo accetta da un prompt che non viene visualizzato, quindi non appare mai in un 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:`installa`,children:`Installa`}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Installa e connetti 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:[`Un unico comando completa tutta la configurazione: installa il daemon locale (root una volta), collega i hook in ogni CLI di agente che trova e connette questa macchina al Cloud. Passare la chiave attraverso l’ambiente piuttosto che tramite `,_jsx(_components.code,{children:`--token`}),` la mantiene fuori da `,_jsx(_components.code,{children:`ps`}),`, dove ogni utente della macchina può leggere gli argomenti di un comando. Non la mantiene fuori dalla cronologia della shell — leggerla con `,_jsx(_components.code,{children:`read -s`}),` è quello che lo fa. In CI, inettala come segreto mascherato e mantieni il tracing della shell (`,_jsx(_components.code,{children:`set -x`}),`) disattivato, altrimenti la traccia la stampa.`]}),_jsxs(_components.p,{children:[`Le trascrizioni delle sessioni vengono inviate per impostazione predefinita. Aggiungi `,_jsx(_components.code,{children:`--no-transcripts`}),` per segnalare l’attività degli hook e le decisioni sulle policy senza il contenuto della trascrizione.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Non usare `,_jsx(_components.code,{children:`failproofai config --connect \u003curl>`}),` qui. Quel flag iscrive una macchina che è `,_jsx(_components.strong,{children:`già`}),` configurata e ritorna subito — nessun daemon, nessun hook — quindi la macchina apparirebbe nel Cloud senza raccogliere e applicare nulla.`]})}),_jsx(_components.p,{children:`Se questa macchina ha già una cronologia di agenti, visualizza in anteprima e importa gli ultimi sette giorni, quindi attendi il completamento della consegna. Salta questo passaggio su una nuova macchina.`}),_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:[`Apri `,_jsx(_components.strong,{children:`Sessions`}),` in Failproof AI e seleziona una sessione importata.`]})]}),_jsxs(Step,{title:`Collega Failproof AI a un harness`,children:[_jsxs(_components.p,{children:[`Il passaggio precedente ha già collegato ogni CLI di agente rilevata. Eseguilo nuovamente per un harness esplicitamente quando necessario, o per aggiungere un harness installato successivamente. Ognuno dei 12 è un valore `,_jsx(_components.code,{children:`--cli`}),` valido — `,_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:` # a coding CLI`})]}),`\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:` # a Slack/Telegram gateway`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Il blocco di una chiamata di tool prima che venga eseguita è verificato su tutti i 12. I gate di fine turno sono verificati su 8 — consulta `,_jsx(_components.a,{href:`/it/reference/harnesses#capacit%C3%A0-di-applicazione`,children:`enforcement capability`}),` per la matrice per harness.`]})]}),_jsxs(Step,{title:`Scegli cosa applicare`,children:[_jsx(_components.p,{children:`Il collegamento dei hook non abilita alcuna policy. La configurazione deliberatamente non ne sceglie nessuna — quella decisione è tua — quindi prendi un pacchetto:`}),_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:`Il pacchetto viene recuperato dal suo rilascio GitHub, verificato con checksum e bloccato al tag esatto in cui è stato risolto. Contiene 38 policy e attiva le 10 che il suo manifest contrassegna come sicure da abilitare in modo non presidiato. Usale per vedere le decisioni delle policy locali e provare l’enforcement prima che Failproof AI auditi le tue sessioni e scriva policy per i tuoi agenti.`}),_jsxs(_components.p,{children:[`Leggi qualsiasi pacchetto prima di prenderlo con `,_jsx(_components.code,{children:`failproofai policies show \u003cowner>/\u003crepo>`}),`, e consulta `,_jsx(_components.a,{href:`/it/policies/packs`,children:`policy packs`}),` per prendere solo parte di uno.`]}),_jsxs(_components.p,{children:[`Finché questo non viene eseguito, l’unica cosa che applica è `,_jsx(_components.code,{children:`block-failproofai-commands`}),` — la guardia sempre attiva che impedisce a un agente di disattivare Failproof AI. `,_jsx(_components.code,{children:`failproofai policies`}),` elenca cosa è attivo.`]})]}),_jsx(Step,{title:`Controlla il comportamento`,children:_jsxs(_components.p,{children:[`Segui `,_jsx(_components.a,{href:`/it/start/first-audit`,children:`Esegui il tuo primo controllo di errore`}),`. Usa un obiettivo concreto come trovare sessioni in cui l’agente ha ritentato un tool non riuscito senza cambiare il suo approccio.`]})}),_jsx(Step,{title:`Previeni l'errore`,children:_jsxs(_components.p,{children:[`Segui `,_jsx(_components.a,{href:`/it/start/first-policy`,children:`Previeni il tuo primo errore con una policy`}),`. Inizia in modalità osservazione, ispeziona le corrispondenze, quindi applica la versione rivista.`]})})]}),_jsx(Check,{children:_jsxs(_components.p,{children:[`Esegui `,_jsx(_components.code,{children:`failproofai config --status`}),`. Una configurazione corretta segnala la connessione cloud, lo stato del daemon e se l’enforcement è in pausa.`]})})]})]})]})}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":"Guida introduttiva","description":"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.","icon":"zap","href":"/it/start/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prima di iniziare","slug":"prima-di-iniziare","depth":2,"children":[],"tabId":"configurazione-manuale"},{"title":"Installa","slug":"installa","depth":2,"children":[],"tabId":"configurazione-manuale"}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/exosphere/86fd84cc0563b6f3/stars.js","/_mintlify/custom/exosphere/3e9809a158d7fc0b/reo.js"],"subdomain":"exosphere","siteName":"Failproof AI","title":"Guida introduttiva - 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":1},"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":0},"ar":{"href":"/ar/start/quickstart","matchLevel":1},"he":{"href":"/he/start/quickstart","matchLevel":1}}},"lastModified":"2026-09-15T05:52:36.557Z","originalFileLocation":"it/start/quickstart.mdx","locale":"it"},"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=\"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.\">\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=\"Guida introduttiva - Failproof AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Failproof AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.befailproof.ai/it/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=Guida+introduttiva\u0026amp;description=Acquisisci+una+sessione+di+agente%2C+trova+un+errore+e+inizia+a+prevenirlo.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=bc15ebba168f968dbf858da1f62eb6365589fd325470c3082795a2e98624a015\">\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=\"Guida introduttiva - Failproof AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=Guida+introduttiva\u0026amp;description=Acquisisci+una+sessione+di+agente%2C+trova+un+errore+e+inizia+a+prevenirlo.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=bc15ebba168f968dbf858da1f62eb6365589fd325470c3082795a2e98624a015\">\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/it/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/it/start/quickstart.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.befailproof.ai/it/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=\"pt-BR\" href=\"https://docs.befailproof.ai/pt-br/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=\"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/it/start/quickstart#webpage\",\"url\":\"https://docs.befailproof.ai/it/start/quickstart\",\"name\":\"Guida introduttiva\",\"description\":\"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.\",\"dateModified\":\"2026-09-15T05:52:36.557Z\",\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.befailproof.ai/it/start/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.befailproof.ai/it/start/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start here\",\"item\":\"https://docs.befailproof.ai/it\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Guida introduttiva\",\"item\":\"https://docs.befailproof.ai/it/start/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.befailproof.ai/it/start/quickstart#article\",\"headline\":\"Guida introduttiva\",\"name\":\"Guida introduttiva\",\"description\":\"Acquisisci una sessione di agente, trova un errore e inizia a prevenirlo.\",\"url\":\"https://docs.befailproof.ai/it/start/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://docs.befailproof.ai/it/start/quickstart#webpage\"},\"dateModified\":\"2026-09-15T05:52:36.557Z\",\"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":"/it/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","pages":[{"title":"pt-BR","href":"/pt-br/start/quickstart"}]},{"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","tabs":[{"tab":"Start","icon":"rocket","groups":[{"group":"Start here","pages":[{"title":"Rendi il tuo agent failproof","description":"Osservabilità e enforcement per ogni harness su cui i tuoi agent vengono eseguiti — coding CLI, chat gateway, assistant auto-hosted e tuoi agent strumentati.","icon":"shield-check","href":"/it"},{"title":"Guida introduttiva","icon":"zap","href":"/it/start/quickstart"},{"title":"Harness per agenti","description":"Cattura sessioni e applica criteri su tutti i 12 harness di agenti supportati.","icon":"plug-zap","href":"/it/reference/harnesses"},{"title":"Failproof Assistant","icon":"message-square-text","href":"/it/sessions/assistant"},{"title":"Esegui il tuo primo controllo di guasto","icon":"scan-search","href":"/it/start/first-audit"},{"title":"Evita il tuo primo errore con una policy","icon":"shield-check","href":"/it/start/first-policy"},{"title":"Scegli la tua configurazione","icon":"waypoints","href":"/it/start/setup"},{"title":"Concetti fondamentali","icon":"boxes","href":"/it/start/concepts"},{"group":"Starter templates","expanded":false,"pages":[{"title":"Agenti personalizzati","icon":"code","href":"/it/start/quickstarts/custom-agents"},{"title":"LangChain e LangGraph","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/langchain.svg","href":"/it/start/quickstarts/langchain"},{"title":"CrewAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/crewai.svg","href":"/it/start/quickstarts/crewai"},{"title":"LlamaIndex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/llamaindex.svg","href":"/it/start/quickstarts/llamaindex"},{"title":"Pydantic AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/pydantic-ai.svg","href":"/it/start/quickstarts/pydantic-ai"}]}]}]},{"tab":"Trace","icon":"route","pages":[{"title":"Trace","href":"/it/sessions/overview"}]},{"tab":"Analyse","icon":"scan-search","pages":[{"title":"Analyse","href":"/it/evaluations/overview"}]},{"tab":"Fix","icon":"shield-check","pages":[{"title":"Fix","href":"/it/policies/overview"}]},{"tab":"Settings","icon":"settings-2","pages":[{"title":"Settings","href":"/it/admin/overview"}]},{"tab":"Integrations and reference","icon":"braces","pages":[{"title":"Integrations and reference","href":"/it/reference/overview"}]}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/start/quickstart"}]},{"language":"he","pages":[{"title":"he","href":"/he/start/quickstart"}]}]},"basePath":"","title":"Guida introduttiva - Failproof AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}