> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Tích hợp Agent
> Ghi lại phiên làm việc và áp dụng chính sách trong các CLI agent được hỗ trợ.
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
1. 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.
2. 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.
3. 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**.
4. 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ó.
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.
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.
Cài đặt hook cho mỗi tích hợp được phát hiện:
```bash theme={null}
failproofai config \
--connect https://app.befailproof.ai \
--token
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:
```bash theme={null}
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ó:
```bash theme={null}
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
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.
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:
```bash theme={null}
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.