Bỏ qua tới nội dung
RexAPFTài liệuMở RexAPF Web
Tài liệuAPIGateway Agent
Web

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.

3 phút đọc
Trên trang này
  1. Bốn mức rủi ro
  2. Thứ tự xét quy tắc
  3. Khi một thao tác cần phê duyệt
  4. Phân loại
  5. Yêu cầu phê duyệt
  6. Kiểm tra lại trước khi chạy
  7. Cấu trúc tệp chính sách
  8. Dùng chính sách riêng
  9. Liên quan

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ứcTênQuyết địnhVí dụ thao tác
R0R0_PROHIBITEDLuôn từ chốiNhậ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
R1R1_ROUTINECho phép, không cần duyệt từng bướcDi 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
R2R2_CONSEQUENTIALCần bạn phê duyệtGử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ị
R3R3_INDETERMINATETừ chốiMọ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

  1. 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 ….

  2. 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 ý.

  3. 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

risk-policy-default.json
{
  "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ườngBắt buộcÝ nghĩa
versionCóChuỗi phiên bản chính sách
rulesCóMảng quy tắc, không được rỗng
rules[].idCóMã quy tắc; thiếu thì quy tắc bị bỏ qua
rules[].riskLevelCóMột trong R0_PROHIBITED, R1_ROUTINE, R2_CONSEQUENTIAL, R3_INDETERMINATE
rules[].actionTypesCó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[].targetPatternsKhôngMẫu dạng *từ*; quy tắc chỉ áp khi đối tượng chứa từ đó
rules[].descriptionKhôngMô 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ụ.

~/.rexllm-gateway/.env
COMPUTER_RISK_POLICY_PATH=/home/me/policies/strict-policy.json
Không tải được chính sách thì phiên bị chặn

Nế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.

Mẹo

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.

Liên quan

Trang này có hữu ích không?Cập nhật 22/10/2026