Chính sách rủi ro của Gateway Agent
Cách Gateway Agent phân loại từng thao tác Computer Use thành R0–R3 trước khi thực thi, và cách dùng tệp chính sách riêng.
Trên trang này
Khi Agent điều khiển máy tính qua Gateway Agent (Computer Use), mỗi thao tác được đối chiếu với một chính sách rủi ro trước khi chạy. Chính sách mặc định nằm trong tệp risk-policy-default.json đi kèm Gateway Agent và hoạt động theo nguyên tắc từ chối mặc định.
Bốn mức rủi ro
| Mức | Tên | Quyết định | Ví dụ thao tác |
|---|---|---|---|
| R0 | R0_PROHIBITED | Luôn từ chối | Nhập, đọc, sao chép, dán bí mật; điều khiển màn hình khoá, màn hình đăng nhập; nâng quyền, tắt cơ chế an toàn |
| R1 | R1_ROUTINE | Cho phép, không cần duyệt từng bước | Di chuột, nhấp, cuộn, gõ phím, quản lý cửa sổ, mở ứng dụng, chụp màn hình |
| R2 | R2_CONSEQUENTIAL | Cần bạn phê duyệt | Gửi, đăng, chia sẻ, tải lên; thanh toán; đăng nhập; xoá; ghi đè; cài/gỡ phần mềm; đổi cài đặt hệ thống; chạy với quyền quản trị |
| R3 | R3_INDETERMINATE | Từ chối | Mọi thao tác không khớp quy tắc nào |
Thao tác không có trong chính sách sẽ rơi vào R3 và bị từ chối, nên một loại thao tác mới không bao giờ được chạy chỉ vì chưa ai khai báo.
Thứ tự xét quy tắc
Gateway xét quy tắc theo thứ tự ưu tiên: R0 trước, rồi R2, rồi R1. Quy tắc đầu tiên khớp sẽ quyết định. Nhờ vậy, một cú nhấp bình thường là R1, nhưng nếu đối tượng nhấp khớp mẫu nguy hiểm thì quy tắc R2 r2-target-destructive được áp dụng trước.
Quy tắc r2-target-destructive áp cho click và double_click khi đối tượng chứa một trong các từ: send, delete, remove, publish, pay, purchase, install, uninstall, overwrite, share. Việc so khớp không phân biệt hoa thường.
Khi một thao tác cần phê duyệt
Phân loại
Trước khi thực thi, Gateway phân loại thao tác. R0 và R3 dừng ngay với thông báo
Action denied: risk level ….Yêu cầu phê duyệt
Với R2, Gateway tạm dừng vòng thao tác và gửi yêu cầu phê duyệt kèm bằng chứng về trạng thái màn hình. Bạn chọn đồng ý hoặc từ chối; thao tác chỉ tiếp tục khi được đồng ý.
Kiểm tra lại trước khi chạy
Sau khi được duyệt, Gateway kiểm tra lại trạng thái và đối tượng. Mỗi lượt duyệt chỉ dùng được một lần, gắn với đúng thao tác đó, và hết hạn sau 120 giây theo mặc định. Nếu trạng thái đã đổi, thao tác bị từ chối.
Cấu trúc tệp chính sách
{
"version": "1.0.0",
"defaultRiskLevel": "R3_INDETERMINATE",
"rules": [
{
"id": "r2-deletion",
"riskLevel": "R2_CONSEQUENTIAL",
"actionTypes": ["delete", "remove", "trash", "erase"],
"description": "Deletion actions"
},
{
"id": "r2-target-destructive",
"riskLevel": "R2_CONSEQUENTIAL",
"actionTypes": ["click", "double_click"],
"targetPatterns": ["*send*", "*delete*"],
"description": "Click targeting destructive UI elements"
}
]
}| Trường | Bắt buộc | Ý nghĩa |
|---|---|---|
version | Có | Chuỗi phiên bản chính sách |
rules | Có | Mảng quy tắc, không được rỗng |
rules[].id | Có | Mã quy tắc; thiếu thì quy tắc bị bỏ qua |
rules[].riskLevel | Có | Một trong R0_PROHIBITED, R1_ROUTINE, R2_CONSEQUENTIAL, R3_INDETERMINATE |
rules[].actionTypes | Có | Các loại thao tác áp dụng; thiếu hoặc rỗng làm cả tệp bị từ chối |
rules[].targetPatterns | Không | Mẫu dạng *từ*; quy tắc chỉ áp khi đối tượng chứa từ đó |
rules[].description | Không | Mô tả hiện trong lý do phân loại |
Dùng chính sách riêng
Đặt biến COMPUTER_RISK_POLICY_PATH trong .env của Gateway (mặc định ở ~/.rexllm-gateway/.env) để trỏ tới tệp của bạn, rồi khởi động lại dịch vụ.
COMPUTER_RISK_POLICY_PATH=/home/me/policies/strict-policy.jsonNếu tệp không đọc được, sai JSON hoặc thiếu trường bắt buộc, Gateway không mở phiên Computer Use và trả lỗi. Hãy kiểm tra tệp bằng node -e "JSON.parse(require('fs').readFileSync('đường-dẫn','utf8'))" trước khi áp dụng.
Sao chép risk-policy-default.json làm điểm xuất phát, rồi chỉ chuyển thêm thao tác sang R2 hoặc R0. Tránh hạ mức R0 xuống thấp hơn.