Tích hợp Agent

Failproof AI hỗ trợ Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin CLI, Antigravity CLI, và Goose.

Tích hợp	Phạm vi hook được hỗ trợ
Claude Code	User, project, local
Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi	User, project
Factory Droid, Devin CLI, Antigravity CLI, Goose	User, project
Hermes, OpenClaw	User

Mỗi tích hợp chuẩn hóa tên sự kiện hook gốc, tên công cụ và các trường đầu vào công cụ trước khi chính sách chạy. Chính sách chỉ có thể hoạt động trên các sự kiện mà tích hợp công khai; hãy kiểm tra hành vi cuối lượt và hướng dẫn trên tích hợp và phiên bản chính xác mà bạn triển khai.

Khả năng thực thi

“Block” có nghĩa là phán quyết trả về của bộ điều hợp hiện tại được tiêu thụ bởi tích hợp được đặt tên. Việc chặn sau công cụ có thể thay thế kết quả hiển thị cho mô hình nhưng không thể hoàn tác hiệu ứng phụ của công cụ đã xảy ra.

Tích hợp	Sự kiện chặn được xác minh	Các cảnh báo chỉ quan sát hoặc không chặn
Claude Code	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, và một số sự kiện tác vụ/cấu hình	`PostToolUse`, vòng đời phiên, thông báo và các sự kiện sau lỗi chỉ là quan sát.
Codex	`PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse`	Việc chặn sau công cụ thay thế kết quả sau khi thực thi; sự kiện bắt đầu phiên và compact là quan sát trong bộ điều hợp hiện tại.
GitHub Copilot CLI	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse`	Việc chặn sau công cụ thay thế kết quả sau khi thực thi; sự kiện phiên và thông báo là quan sát.
Cursor	`PreToolUse`, `UserPromptSubmit`, `Stop`	`PostToolUse` và sự kiện phiên là quan sát.
OpenCode	`PreToolUse`	Sự kiện sau công cụ và vòng đời là quan sát; xử lý dừng hiện tại là hướng dẫn cho lượt sau chứ không phải là cánh cổng được xác minh.
Pi	`PreToolUse`, `UserPromptSubmit`	Sự kiện sau công cụ và vòng đời là quan sát; hướng dẫn dừng áp dụng cho lượt sau.
Hermes	`PreToolUse`	Phán quyết sau công cụ, phiên và dừng subagent không phải là cánh cổng.
OpenClaw	`PreToolUse`, `UserPromptSubmit`, `Stop`	Sự kiện sau công cụ, phiên, dừng subagent và nén là quan sát.
Factory Droid	`PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact`	Phán quyết sau công cụ và dừng subagent là quan sát.
Devin CLI	`PreToolUse`, `UserPromptSubmit`, `Stop`, `PermissionRequest` có điều kiện	Hook quyền không chạy trong mọi chế độ quyền; sự kiện sau công cụ và phiên là quan sát.
Antigravity CLI	`PreToolUse`, `Stop`	Phán quyết nhắc nhở người dùng và sau công cụ là quan sát; hướng dẫn nhắc nhở vẫn có thể được tiêm.
Goose	`PreToolUse`	Sự kiện nhắc nhở người dùng, sau công cụ và phiên là quan sát. Hook dừng chặn gốc tồn tại ở thượng nguồn nhưng không được cài đặt bởi bộ điều hợp hiện tại.

Khả năng phụ thuộc vào phiên bản. Hãy kiểm tra lại sau khi nâng cấp CLI agent, đặc biệt khi chính sách dựa vào hành vi nhắc nhở, dừng, quyền hoặc sau công cụ thay vì cánh cổng trước công cụ phổ biến.

Cài đặt hook ghi lại và chính sách

Dashboard
CLI

Mở Administration → Keys và tạo khóa với events:add và policies:pull, đặt tên cho máy hoặc môi trường.
Trên máy đích, kết nối CLI cục bộ với khóa được hiển thị và cài đặt hook tích hợp.
Bắt đầu phiên agent mới, sau đó xác nhận sự kiện hook và phiên của nó trong Observe → Events.
Mở Observe → policy cho cùng khoảng thời gian và xác nhận quyết định chính sách được gán cho máy.

Kết nối bắt đầu bằng khóa máy. Xác nhận rằng nó bao gồm cả quyền nhập vào và phân phối chính sách trước khi sao chép bí mật của nó.

Ngăn tạo khóa API mới được sử dụng để cấp quyền nhập sự kiện và phân phối chính sách.

Sau khi cài đặt hook, luồng Events sẽ hiển thị các sự kiện mới từ máy và môi trường mà bạn đã kết nối.

Luồng Events trực tiếp được sử dụng để xác nhận tích hợp mới được cài đặt đang báo cáo.

Cuối cùng, xác minh rằng quyết định chính sách được gán cho cùng một máy. Điều này xác nhận tích hợp đang báo cáo hoạt động chính sách cũng như sự kiện trace.

Trang Policy được sử dụng để xác minh quyết định chính sách từ tích hợp mới kết nối.

Cài đặt hook cho mỗi tích hợp được phát hiện:

failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key>
failproofai policies --install

Hoặc nhắm mục tiêu các tích hợp được đặt tên và phạm vi cấu hình:

failproofai policies --install \
  --cli claude codex cursor \
  --scope user

Phạm vi project giữ cấu hình hook với một kho lưu trữ. Phạm vi user bao gồm công việc trên nhiều kho lưu trữ. Claude Code cũng hỗ trợ phạm vi local; hỗ trợ khác nhau tùy theo tích hợp và CLI từ chối các kết hợp không được hỗ trợ.Xác minh máy và sự kiện của nó:

failproofai config --status
failproofai flush --wait
fp events --since 1h --event-type hook_triggered,hook_completed

Thêm đường dẫn phiên không mặc định

Dashboard
CLI

Các đường dẫn bổ sung được đăng ký trên máy, không phải trên Cloud. Sau khi thêm một đường dẫn, mở Observe → Sessions, lọc theo môi trường của máy và xác nhận các phiên từ đường dẫn mới xuất hiện. Mở một phiên và kiểm tra agent, tích hợp và dấu thời gian sự kiện trước khi dựa vào nó trong một cuộc kiểm toán.

Danh sách Sessions được lọc theo môi trường nhận dữ liệu từ đường dẫn ghi lại bổ sung.

Thêm đường dẫn với nhãn tùy chọn, sau đó kiểm tra các đường dẫn được cấu hình:

failproofai harness add-path claude checkout=/srv/checkout/.claude
failproofai harness list claude
failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d

Xóa đường dẫn bằng failproofai harness remove-path claude checkout.

Chạy một phiên mới sau khi cài đặt. Xác minh cả luồng sự kiện trực tiếp và quyết định chính sách thực tế trước khi mở rộng triển khai.

Connect your agents

Reference

HTTP API

Khả năng thực thi

Cài đặt hook ghi lại và chính sách

Thêm đường dẫn phiên không mặc định

​Khả năng thực thi

​Cài đặt hook ghi lại và chính sách

​Thêm đường dẫn phiên không mặc định

Khả năng thực thi

Cài đặt hook ghi lại và chính sách

Thêm đường dẫn phiên không mặc định