README.vi.md

⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית

---

---

Hệ thống được hỗ trợ

Mười hai hệ thống trong hai loại — mười CLI viết code và hai gateway chat và trợ lý (Hermes, OpenClaw). Một API chính sách và lịch sử phiên chung trên tất cả chúng. Những gì một chính sách có thể chặn là tùy từng hệ thống: dừng lệnh gọi công cụ trước khi chạy được xác minh trên tất cả mười hai, cổng cuối lượt trên tám. Ma trận tùy từng hệ thống liệt kê các sự kiện mà mỗi hệ thống hỗ trợ.

Các agents chạy trong không có hệ thống nào báo cáo thông qua Python SDK, cung cấp tracing, phiên và kiểm tra. Thực thi ở đó cần một hook trong runtime của bạn — liên hệ với chúng tôi và chúng tôi sẽ ánh xạ nó.

{/* A 6-column table instead of inline runs: table columns never re-wrap, so the grid stays 2×6 at any window width (scrolling on very narrow screens instead of collapsing into ragged orphan rows). */}

Cài đặt

npm install -g failproofai
failproofai config                             # kết nối agents và daemon của bạn
failproofai policies add FailproofAI/policies  # chọn những gì cần thực thi
failproofai                                    # bảng điều khiển trên localhost:8020

Thiết lập kết nối các hooks và chọn không chính sách — lệnh thứ hai là những gì đặt hàng rào bảo vệ trên máy, và bất kỳ gói nào cũng có cùng kiểu (failproofai policies add <owner>/<repo>; policies show <owner>/<repo> đọc một lần đầu). Chạy failproofai config mà không có terminal — CI, một container, một agent điều khiển nó — và nó áp dụng thay vì hỏi. Trên máy chưa bao giờ được thiết lập, bất kỳ lệnh nào khác sẽ chạy cùng một trình hướng dẫn trước; vô hiệu hóa điều đó bằng FAILPROOFAI_NO_FIRST_RUN=1.

Cho đến khi gói tới, điều duy nhất thực thi là block-failproofai-commands, luôn bật và không thể tắt hoặc tạm dừng: một agent có thể tạm dừng thực thi có thể tắt tất cả các chính sách khác.

---

Những gì nó chặn

Chính sách	Những gì nó chặn
block-env-files	Các đọc file .env và file bí mật khác
warn-repeated-tool-calls	Agent lặp lại cùng một lệnh gọi
block-sudo	Nâng cao đặc quyền
warn-destructive-sql	DROP, TRUNCATE, DELETE không giới hạn
block-terraform / block-kubectl	Thay đổi cơ sở hạ tầng trực tiếp chưa được xem xét
block-rm-rf	Xóa file đệ quy
block-force-push / block-push-master	git push --force, đẩy trực tiếp đến main

Mỗi một cổng gọi trước khi nó chạy, vì vậy chúng giữ trên tất cả mười hai hệ thống. Bốn cái đầu tiên áp dụng cho bất kỳ agent nào có thể gọi một công cụ; ba cái cuối cùng là những điều yêu thích của nhà phát triển — CLI viết code là loại hệ thống chúng tôi bao phủ sâu nhất. Họ sanitize-* là riêng biệt: nó chạy sau khi một công cụ trả về, vì vậy nó báo cáo một bí mật trong kết quả công cụ thay vì giữ nó ra khỏi ngữ cảnh.

→ Tất cả 39 chính sách tích hợp sẵn

---

Chính sách của riêng bạn

Thả một file vào .failproofai/policies/ — nó tải tự động, không cần cờ. Commit và toàn bộ nhóm sẽ nhận được nó lần tiếp theo.

import { customPolicies, deny, allow } from "failproofai";

customPolicies.add({
  name: "no-production-writes",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolInput?.file_path?.includes("production"))
      return deny("Writes to production paths are blocked.");
    return allow();
  },
});

Ba quyết định có sẵn cho mọi chính sách:

Quyết định	Hiệu ứng
allow()	Cho phép hoạt động
deny(message)	Chặn nó — thông báo quay lại agent
instruct(message)	Cho nó qua, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của agent

→ Viết một chính sách

---

Quan sát

Thực thi là một nửa. Nửa kia là xem agent thực sự làm gì.

Chạy failproofai mà không có đối số và nó phục vụ bảng điều khiển trên localhost:8020 đọc lịch sử chạy đã có trên máy của bạn — không tài khoản, không đăng ký, không có gì rời khỏi hộp. Bạn nhận được danh sách phiên, chuỗi các lệnh gọi mô hình, lệnh gọi công cụ và quyết định hook bên trong mỗi lần chạy, những gì bị chặn và những gì chính sách nói với agent, và kiểm tra ngoại tuyến (failproofai audit) quét lịch sử của bạn để tìm các mẫu rủi ro và gợi ý chính sách để dừng chúng.

→ Bảng điều khiển cục bộ · Đọc một trace · Kiểm tra cục bộ

Failproof AI Observability là phía được lưu trữ của cùng một mô hình dữ liệu, cho các nhóm chạy agents trên một bộ: mỗi lần chạy từ mọi hệ thống ở một nơi, biểu đồ thực thi với các sub-agents song song trên các đường riêng của họ, độ trễ p50/p95/p99 cho mô hình, công cụ và hooks, chi phí theo mô hình và theo dõi cửa sổ ngữ cảnh, theo dõi lỗi, SQL trên traces của riêng bạn với bảng điều khiển có thể chia sẻ, các đánh giá được tính điểm bởi dịch vụ của bạn, kiểm tra theo lịch trình biến các lỗi định kỳ thành phát hiện hỗ trợ bằng bằng chứng, và cảnh báo được định tuyến đến Slack, email hoặc webhook đã ký. Tự lưu trữ trong cụm của riêng bạn có sẵn trong kế hoạch Enterprise.

→ Phiên · Kiểm tra · Đặt lịch demo

---

Tài liệu

Bắt đầu
Hướng dẫn bắt đầu nhanh	Cài đặt, kết nối một hệ thống, xem lần chạy đầu tiên
Các khái niệm	Cách hệ thống hook hoạt động
Hệ thống được hỗ trợ	Tất cả 12, và những gì mỗi cái có thể thực thi

Quan sát
Phiên	Theo dõi một lần chạy: mô hình, công cụ, lỗi, độ trễ
Đọc một trace	Biểu đồ thực thi đang nói với bạn điều gì
Kiểm tra	Tìm mẫu lỗi trên nhiều phiên
Bảng điều khiển cục bộ	localhost:8020, không cần tài khoản

Thực thi
Gói chính sách	Các chính sách Failproof AI và gói từ hub chính sách
Viết một chính sách	Từ một kiểm tra hoặc trong code
Cấu hình	Phạm vi cấu hình, quy tắc hợp nhất và tham số chính sách

Công cụ agent của riêng bạn
Python SDK	Báo cáo chạy từ một agent không có hệ thống
Policy SDK	Tham chiếu allow / deny / instruct

---

Giấy phép

MIT với Commons Clause — miễn phí cho sử dụng nội bộ và cá nhân; bán lại thương mại của failproofai yêu cầu một thỏa thuận riêng. Xem LICENSE để biết toàn bộ văn bản.

---

Đóng góp

Xem CONTRIBUTING.md. Các chính sách mới, trường hợp đặc biệt và bản dịch đều được chào đón.

Xây dựng trước khi bạn bắt đầu. Chạy bun install && bun run build trước. Repo này chạy các hooks của failproofai trên chính nó, và chúng giải quyết import failproofai so với gói dist/ được biên dịch — mà không có bản dựng bạn sẽ gặp các lỗi hook Cannot find package 'failproofai'. Xây dựng lại sau khi thay đổi src/. Xem Xây dựng trước khi các dev hooks trong repo sẽ hoạt động.

---

Xây dựng với ❤️ bởi befailproof.ai tại SF và Bengaluru.