Policy YAML 構文リファレンス (AGT Policy Reference)
ステータス
Owner: TBD · Status: draft · 正式な情報源: flezi.app.ai.agent/docs/governance/agt-policy-overview.md
このドキュメントでは、Agent の Tool 呼び出し権限を制御するために使用する AGT Policy YAML 形式の完全な構文仕様を説明します。
全体 構造
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"
アクション (Actions)
| Action | 意味 | 実際の動作 |
|---|---|---|
allow | 実行を許可 | Tool は承認なしで直ちに実行されます |
deny | 実行を拒否 | 呼び出しは直ちにブロックされ、エラーメッセージが LLM に返されます |
require_approval | 人による承認を必須化 | 実行セッションが一時停止し、chat 画面に承認フォームが表示されます |
完全なポリシー例
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