Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.
Hướng dẫn bắt đầu nhanh này sẽ giúp bạn thiết lập một máy để báo cáo phiên làm việc, chạy kiểm toán, và triển khai một chính sách. Sử dụng kỹ năng để thiết lập Failproof AI, hoặc thực hiện theo các bước thủ công.Con đường nào là của bạn? Nếu agent của bạn chạy trên một trong 12 harnesses được hỗ trợ — một CLI mã hóa, hoặc một gateway như Hermes hay OpenClaw — hãy thực hiện theo các bước dưới đây; bạn cần Node.js 20.9 hoặc phiên bản sau. Nếu agent của bạn không có harness, hãy sử dụng Python SDK để thực hiện tracing và kiểm toán, rồi quay lại Chạy kiểm tra lỗi đầu tiên của bạn; thực thi trên con đường đó cần một hook trong runtime của bạn.
Sử dụng kỹ năng
Thiết lập thủ công
1
Cài đặt kỹ năng Failproof AI
npx skills add FailproofAI/skills
2
Yêu cầu agent của bạn thiết lập mọi thứ
Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.
Agent của bạn sẽ kiểm tra dự án, chọn tích hợp phù hợp, thực hiện thiết lập, và xác minh nó. Xem kho lưu trữ kỹ năng FailproofAI để xem các kỹ năng riêng lẻ và các tùy chọn cài đặt nâng cao.
Đi tới Administration → Keys và tạo một khóa với events:add và policies:pull.
Sao chép mã bí mật một lần, sau đó đọc nó vào shell trên máy đích. read -s nhận nó tại một lời nhắc không phản hồi, vì vậy nó không bao giờ xuất hiện trong lệnh:
Một lệnh duy nhất là tất cả những gì cần thiết cho thiết lập: nó cài đặt daemon cục bộ (root một lần), kết nối hooks vào mọi CLI agent mà nó tìm thấy, và kết nối máy này với Cloud. Truyền khóa thông qua môi trường thay vì --token giúp tránh nó trong ps, nơi mọi người dùng trên máy có thể đọc các đối số của lệnh. Nó không giữ nó ra khỏi lịch sử shell — đọc nó bằng read -s là điều đó làm. Trong CI, hãy tiêm nó như một mã bí mật được che dấu và giữ tracing shell (set -x) tắt, hoặc trace sẽ in ra nó.Các bảng điểm phiên được gửi theo mặc định. Thêm --no-transcripts để báo cáo hoạt động hook và quyết định chính sách mà không có nội dung bảng điểm.
Không sử dụng failproofai config --connect <url> tại đây. Cờ đó đăng ký một máy đã được thiết lập và trả về ngay lập tức — không có daemon, không có hooks — vì vậy máy sẽ xuất hiện trong Cloud trong khi không thu thập và thực thi bất cứ điều gì.
Nếu máy này đã có lịch sử agent, xem trước và nhập bảy ngày gần đây, sau đó chờ để kết thúc giao hàng. Bỏ qua bước này trên một máy mới.
Mở Sessions trong Failproof AI và chọn một phiên được nhập.
2
Gắn Failproof AI vào harness
Bước trước đó đã kết nối mọi CLI agent mà nó phát hiện. Chạy lại nó cho một harness cụ thể khi bạn cần, hoặc để thêm một harness được cài đặt sau. Mỗi một trong 12 đều là một giá trị --cli hợp lệ — 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
Chặn một lệnh công cụ trước khi nó chạy được xác minh trên tất cả 12. Các cổng lượt kết thúc được xác minh trên 8 — xem khả năng thực thi để xem ma trận cho từng harness.
3
Chọn những gì để thực thi
Kết nối hooks không bật chính sách. Thiết lập cố tình không chọn bất cứ điều gì — quyết định đó là của bạn — vì vậy hãy lấy một bộ:
failproofai policies add FailproofAI/policies
Bộ được tìm nạp từ bản phát hành GitHub của nó, xác minh tổng kiểm tra, và được ghim vào thẻ chính xác mà nó giải quyết. Nó mang 38 chính sách và bật 10 chính sách mà bản kê khai của nó đánh dấu là an toàn để bật khi không có người trực. Sử dụng chúng để xem các quyết định chính sách cục bộ và thử thực thi trước khi Failproof AI kiểm toán các phiên của bạn và viết chính sách cho các agent của bạn.Đọc bất kỳ bộ nào trước khi lấy nó bằng failproofai policies show <owner>/<repo>, và xem bộ chính sách để chỉ lấy một phần của bộ.Cho đến khi cái này chạy, điều duy nhất thực thi là block-failproofai-commands — bảo vệ luôn bật ngăn một agent tắt Failproof AI. failproofai policies liệt kê những gì được bật.
4
Kiểm toán hành vi
Thực hiện theo Chạy kiểm tra lỗi đầu tiên của bạn. Sử dụng một mục tiêu cụ thể như “tìm các phiên nơi agent thử lại một công cụ không thành công mà không thay đổi cách tiếp cận của nó.”
Chạy failproofai config --status. Một thiết lập lành mạnh báo cáo kết nối đến cloud, trạng thái daemon, và liệu thực thi có bị tạm dừng hay không.
Trang này có hữu ích không?
{"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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":"vi/start/quickstart","slug":"/vi/start/quickstart","pageMetadata":{"title":"Bắt đầu nhanh","description":"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.","icon":"zap","href":"/vi/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: \"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.\"\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:`Hướng dẫn bắt đầu nhanh này sẽ giúp bạn thiết lập một máy để báo cáo phiên làm việc, chạy kiểm toán, và triển khai một chính sách. Sử dụng kỹ năng để thiết lập Failproof AI, hoặc thực hiện theo các bước thủ công.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Con đường nào là của bạn?`}),` Nếu agent của bạn chạy trên một trong 12 `,_jsx(_components.a,{href:`/vi/reference/harnesses`,children:`harnesses`}),` được hỗ trợ — một CLI mã hóa, hoặc một gateway như Hermes hay OpenClaw — hãy thực hiện theo các bước dưới đây; bạn cần Node.js 20.9 hoặc phiên bản sau. Nếu agent của bạn không có harness, hãy sử dụng `,_jsx(_components.a,{href:`/vi/reference/custom-agents`,children:`Python SDK`}),` để thực hiện tracing và kiểm toán, rồi quay lại `,_jsx(_components.a,{href:`/vi/start/first-audit`,children:`Chạy kiểm tra lỗi đầu tiên của bạn`}),`; thực thi trên con đường đó cần một hook trong runtime của bạn.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Sử dụng kỹ năng`,id:`s%E1%BB%AD-d%E1%BB%A5ng-k%E1%BB%B9-n%C4%83ng`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Cài đặt kỹ năng 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:`Yêu cầu agent của bạn thiết lập mọi thứ`,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:[`Agent của bạn sẽ kiểm tra dự án, chọn tích hợp phù hợp, thực hiện thiết lập, và xác minh nó. Xem `,_jsx(_components.a,{href:`https://github.com/FailproofAI/skills`,children:`kho lưu trữ kỹ năng FailproofAI`}),` để xem các kỹ năng riêng lẻ và các tùy chọn cài đặt nâng cao.`]})]})]})}),_jsxs(Tab,{title:`Thiết lập thủ công`,id:`thi%E1%BA%BFt-l%E1%BA%ADp-th%E1%BB%A7-c%C3%B4ng`,\"data-child-heading-ids\":`[\"tr%C6%B0%E1%BB%9Bc-khi-b%E1%BA%AFt-%C4%91%E1%BA%A7u\",\"c%C3%A0i-%C4%91%E1%BA%B7t\"]`,children:[_jsx(Heading,{level:`2`,id:`trước-khi-bắt-đầu`,children:`Trước khi bắt đầu`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Mở `,_jsx(_components.a,{href:`https://app.befailproof.ai`,children:`bảng điều khiển Failproof AI`}),` và tạo một tài khoản hoặc đăng nhập bằng email công việc của bạn.`]}),`\n`,_jsxs(_components.li,{children:[`Đi tới `,_jsx(_components.strong,{children:`Administration → Keys`}),` và tạo một khóa với `,_jsx(_components.code,{children:`events:add`}),` và `,_jsx(_components.code,{children:`policies:pull`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Sao chép mã bí mật một lần, sau đó đọc nó vào shell trên máy đích. `,_jsx(_components.code,{children:`read -s`}),` nhận nó tại một lời nhắc không phản hồi, vì vậy nó không bao giờ xuất hiện trong lệnh:`]}),`\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:`cài-đặt`,children:`Cài đặt`}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Cài đặt và kết nối 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:[`Một lệnh duy nhất là tất cả những gì cần thiết cho thiết lập: nó cài đặt daemon cục bộ (root một lần), kết nối hooks vào mọi CLI agent mà nó tìm thấy, và kết nối máy này với Cloud. Truyền khóa thông qua môi trường thay vì `,_jsx(_components.code,{children:`--token`}),` giúp tránh nó trong `,_jsx(_components.code,{children:`ps`}),`, nơi mọi người dùng trên máy có thể đọc các đối số của lệnh. Nó không giữ nó ra khỏi lịch sử shell — đọc nó bằng `,_jsx(_components.code,{children:`read -s`}),` là điều đó làm. Trong CI, hãy tiêm nó như một mã bí mật được che dấu và giữ tracing shell (`,_jsx(_components.code,{children:`set -x`}),`) tắt, hoặc trace sẽ in ra nó.`]}),_jsxs(_components.p,{children:[`Các bảng điểm phiên được gửi theo mặc định. Thêm `,_jsx(_components.code,{children:`--no-transcripts`}),` để báo cáo hoạt động hook và quyết định chính sách mà không có nội dung bảng điểm.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Không sử dụng `,_jsx(_components.code,{children:`failproofai config --connect \u003curl>`}),` tại đây. Cờ đó đăng ký một máy `,_jsx(_components.strong,{children:`đã`}),` được thiết lập và trả về ngay lập tức — không có daemon, không có hooks — vì vậy máy sẽ xuất hiện trong Cloud trong khi không thu thập và thực thi bất cứ điều gì.`]})}),_jsx(_components.p,{children:`Nếu máy này đã có lịch sử agent, xem trước và nhập bảy ngày gần đây, sau đó chờ để kết thúc giao hàng. Bỏ qua bước này trên một máy mới.`}),_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:[`Mở `,_jsx(_components.strong,{children:`Sessions`}),` trong Failproof AI và chọn một phiên được nhập.`]})]}),_jsxs(Step,{title:`Gắn Failproof AI vào harness`,children:[_jsxs(_components.p,{children:[`Bước trước đó đã kết nối mọi CLI agent mà nó phát hiện. Chạy lại nó cho một harness cụ thể khi bạn cần, hoặc để thêm một harness được cài đặt sau. Mỗi một trong 12 đều là một giá trị `,_jsx(_components.code,{children:`--cli`}),` hợp lệ — `,_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:[`Chặn một lệnh công cụ trước khi nó chạy được xác minh trên tất cả 12. Các cổng lượt kết thúc được xác minh trên 8 — xem `,_jsx(_components.a,{href:`/vi/reference/harnesses#kh%E1%BA%A3-n%C4%83ng-th%E1%BB%B1c-thi`,children:`khả năng thực thi`}),` để xem ma trận cho từng harness.`]})]}),_jsxs(Step,{title:`Chọn những gì để thực thi`,children:[_jsx(_components.p,{children:`Kết nối hooks không bật chính sách. Thiết lập cố tình không chọn bất cứ điều gì — quyết định đó là của bạn — vì vậy hãy lấy một bộ:`}),_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:`Bộ được tìm nạp từ bản phát hành GitHub của nó, xác minh tổng kiểm tra, và được ghim vào thẻ chính xác mà nó giải quyết. Nó mang 38 chính sách và bật 10 chính sách mà bản kê khai của nó đánh dấu là an toàn để bật khi không có người trực. Sử dụng chúng để xem các quyết định chính sách cục bộ và thử thực thi trước khi Failproof AI kiểm toán các phiên của bạn và viết chính sách cho các agent của bạn.`}),_jsxs(_components.p,{children:[`Đọc bất kỳ bộ nào trước khi lấy nó bằng `,_jsx(_components.code,{children:`failproofai policies show \u003cowner>/\u003crepo>`}),`, và xem `,_jsx(_components.a,{href:`/vi/policies/packs`,children:`bộ chính sách`}),` để chỉ lấy một phần của bộ.`]}),_jsxs(_components.p,{children:[`Cho đến khi cái này chạy, điều duy nhất thực thi là `,_jsx(_components.code,{children:`block-failproofai-commands`}),` — bảo vệ luôn bật ngăn một agent tắt Failproof AI. `,_jsx(_components.code,{children:`failproofai policies`}),` liệt kê những gì được bật.`]})]}),_jsx(Step,{title:`Kiểm toán hành vi`,children:_jsxs(_components.p,{children:[`Thực hiện theo `,_jsx(_components.a,{href:`/vi/start/first-audit`,children:`Chạy kiểm tra lỗi đầu tiên của bạn`}),`. Sử dụng một mục tiêu cụ thể như “tìm các phiên nơi agent thử lại một công cụ không thành công mà không thay đổi cách tiếp cận của nó.”`]})}),_jsx(Step,{title:`Ngăn chặn lỗi`,children:_jsxs(_components.p,{children:[`Thực hiện theo `,_jsx(_components.a,{href:`/vi/start/first-policy`,children:`Ngăn chặn lỗi đầu tiên của bạn bằng chính sách`}),`. Bắt đầu ở chế độ quan sát, kiểm tra các kết quả khớp, sau đó thực thi phiên bản đã xem xét.`]})})]}),_jsx(Check,{children:_jsxs(_components.p,{children:[`Chạy `,_jsx(_components.code,{children:`failproofai config --status`}),`. Một thiết lập lành mạnh báo cáo kết nối đến cloud, trạng thái daemon, và liệu thực thi có bị tạm dừng hay không.`]})})]})]})]})}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":"Bắt đầu nhanh","description":"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.","icon":"zap","href":"/vi/start/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Trước khi bắt đầu","slug":"trước-khi-bắt-đầu","depth":2,"children":[],"tabId":"thi%E1%BA%BFt-l%E1%BA%ADp-th%E1%BB%A7-c%C3%B4ng"},{"title":"Cài đặt","slug":"cài-đặt","depth":2,"children":[],"tabId":"thi%E1%BA%BFt-l%E1%BA%ADp-th%E1%BB%A7-c%C3%B4ng"}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/exosphere/86fd84cc0563b6f3/stars.js","/_mintlify/custom/exosphere/3e9809a158d7fc0b/reo.js"],"subdomain":"exosphere","siteName":"Failproof AI","title":"Bắt đầu nhanh - 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":0},"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:35.848Z","originalFileLocation":"vi/start/quickstart.mdx","locale":"vi"},"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=\"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.\">\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=\"Bắt đầu nhanh - Failproof AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Failproof AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.befailproof.ai/vi/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=B%E1%BA%AFt+%C4%91%E1%BA%A7u+nhanh\u0026amp;description=Ghi+l%E1%BA%A1i+m%E1%BB%99t+phi%C3%AAn+l%C3%A0m+vi%E1%BB%87c+c%E1%BB%A7a+agent%2C+t%C3%ACm+ra+l%E1%BB%97i%2C+v%C3%A0+b%E1%BA%AFt+%C4%91%E1%BA%A7u+ng%C4%83n+ch%E1%BA%B7n+n%C3%B3.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=dd41d4fb3dd9ca2a04852240a076c763f38f190e3952efb56421f1f71568f7c1\">\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=\"Bắt đầu nhanh - Failproof AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=B%E1%BA%AFt+%C4%91%E1%BA%A7u+nhanh\u0026amp;description=Ghi+l%E1%BA%A1i+m%E1%BB%99t+phi%C3%AAn+l%C3%A0m+vi%E1%BB%87c+c%E1%BB%A7a+agent%2C+t%C3%ACm+ra+l%E1%BB%97i%2C+v%C3%A0+b%E1%BA%AFt+%C4%91%E1%BA%A7u+ng%C4%83n+ch%E1%BA%B7n+n%C3%B3.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=dd41d4fb3dd9ca2a04852240a076c763f38f190e3952efb56421f1f71568f7c1\">\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/vi/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/vi/start/quickstart.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"vi\" href=\"https://docs.befailproof.ai/vi/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=\"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/vi/start/quickstart#webpage\",\"url\":\"https://docs.befailproof.ai/vi/start/quickstart\",\"name\":\"Bắt đầu nhanh\",\"description\":\"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.\",\"dateModified\":\"2026-09-15T05:52:35.848Z\",\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.befailproof.ai/vi/start/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.befailproof.ai/vi/start/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start here\",\"item\":\"https://docs.befailproof.ai/vi\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bắt đầu nhanh\",\"item\":\"https://docs.befailproof.ai/vi/start/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.befailproof.ai/vi/start/quickstart#article\",\"headline\":\"Bắt đầu nhanh\",\"name\":\"Bắt đầu nhanh\",\"description\":\"Ghi lại một phiên làm việc của agent, tìm ra lỗi, và bắt đầu ngăn chặn nó.\",\"url\":\"https://docs.befailproof.ai/vi/start/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://docs.befailproof.ai/vi/start/quickstart#webpage\"},\"dateModified\":\"2026-09-15T05:52:35.848Z\",\"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":"/vi/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","tabs":[{"tab":"Start","icon":"rocket","groups":[{"group":"Start here","pages":[{"title":"Làm cho agent của bạn không thể thất bại","description":"Khả năng quan sát và thực thi cho mọi công cụ mà agent chạy — CLI mã hóa, cổng trò chuyện, trợ lý tự lưu trữ và agent được đo lường của riêng bạn.","icon":"shield-check","href":"/vi"},{"title":"Bắt đầu nhanh","icon":"zap","href":"/vi/start/quickstart"},{"title":"Agent harnesses","description":"Capture sessions and enforce policies across all 12 supported agent harnesses.","icon":"plug-zap","href":"/vi/reference/harnesses"},{"title":"Failproof Assistant","icon":"message-square-text","href":"/vi/sessions/assistant"},{"title":"Chạy kiểm tra lỗi đầu tiên của bạn","icon":"scan-search","href":"/vi/start/first-audit"},{"title":"Ngăn chặn lỗi đầu tiên của bạn bằng một chính sách","icon":"shield-check","href":"/vi/start/first-policy"},{"title":"Chọn cài đặt của bạn","icon":"waypoints","href":"/vi/start/setup"},{"title":"Các khái niệm cốt lõi","icon":"boxes","href":"/vi/start/concepts"},{"group":"Starter templates","expanded":false,"pages":[{"title":"Các agent tùy chỉnh","icon":"code","href":"/vi/start/quickstarts/custom-agents"},{"title":"LangChain và LangGraph","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/langchain.svg","href":"/vi/start/quickstarts/langchain"},{"title":"CrewAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/crewai.svg","href":"/vi/start/quickstarts/crewai"},{"title":"LlamaIndex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/llamaindex.svg","href":"/vi/start/quickstarts/llamaindex"},{"title":"Pydantic AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/pydantic-ai.svg","href":"/vi/start/quickstarts/pydantic-ai"}]}]}]},{"tab":"Trace","icon":"route","pages":[{"title":"Trace","href":"/vi/sessions/overview"}]},{"tab":"Analyse","icon":"scan-search","pages":[{"title":"Analyse","href":"/vi/evaluations/overview"}]},{"tab":"Fix","icon":"shield-check","pages":[{"title":"Fix","href":"/vi/policies/overview"}]},{"tab":"Settings","icon":"settings-2","pages":[{"title":"Settings","href":"/vi/admin/overview"}]},{"tab":"Integrations and reference","icon":"braces","pages":[{"title":"Integrations and reference","href":"/vi/reference/overview"}]}]},{"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":"Bắt đầu nhanh - Failproof AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}