Chuyển tới nội dung chính

Cú pháp tham chiếu Policy YAML (AGT Policy Reference)

Trạng thái

Owner: TBD · Trạng thái: draft · Nguồn chuẩn: flezi.app.ai.agent/docs/governance/agt-policy-overview.md

Tài liệu này cung cấp đặc tả cú pháp đầy đủ của định dạng chính sách AGT Policy YAML được sử dụng để kiểm soát quyền gọi công cụ của Agent.

Cấu trúc tổng quát​

version: "1.0"
name: "policy_name"
description: "Mô tả mục đích chính sách"
rules:
  - tool: "tên_công_cụ_hoặc_wildcard"
    action: "allow | deny | require_approval"
    reason: "Lý do hiển thị khi kích hoạt quy tắc"
    parameters: # Tùy chọn: Ràng buộc giá trị tham số
      tên_tham_số:
        matches: "biểu_thức_chính_quy_regex"

Các hành động (Actions)​

ActionÝ nghĩaHành vi thực tế
allowCho phép thực thiCông cụ được thực thi ngay mà không cần duyệt
denyCấm thực thiLệnh gọi bị chặn ngay lập tức, trả thông báo lỗi về cho LLM
require_approvalBắt buộc con người duyệtPhiên chạy tạm dừng và hiển thị form duyệt cho người dùng trên màn hình chat

Ví dụ mẫu chính sách hoàn chỉnh​

version: "1.0"
name: "customer_support_safe_guard"
rules:
  # 1. Cấm hoàn toàn mọi lệnh shell hệ thống
  - tool: "bash"
    action: deny
    reason: "Agent chăm sóc khách hàng không được phép chạy lệnh hệ thống"

  # 2. Cho phép tra cứu tri thức
  - tool: "query_knowledge_base"
    action: allow

  # 3. Yêu cầu duyệt nếu xóa dữ liệu khách hàng
  - tool: "crm_delete_customer"
    action: require_approval
    reason: "Thao tác xóa khách hàng cần quản trị viên xác nhận"

  # 4. Mặc định cho phép các công cụ còn lại
  - tool: "*"
    action: allow

Liên quan​