AI Provider、48 条内置审核规则与内部经验库
本手册指导管理员完成 AI 模型接入(公有云与内网私有化双轨)、单日费用预算控制、48 条内置审核技能选配,以及 自定义 Prompt 技能与内部 DBA 经验库 的编写。
1. 配置 AI Provider(/admin/review-engine/providers)
场景 A:接入公有云 OpenAI 兼容模型(default 零泄漏轨道)
适用于 OpenAI、DeepSeek、阿里云百炼(通义千问)、OpenRouter 等公网 HTTPS 服务:
场景 B:接入内网自部署本地模型(san 原生免脱敏轨道)
适用于在内网 GPU 服务器通过 vLLM / Ollama 部署的专用 SQL 审核模型(如 SAN-4B、SQL-Audit-Nano):
跨轨道防泄漏保障
即使你同时配置了优先级 1 的内网 san 模型和优先级 2 的公有云 default 模型,当内网模型超时时,系统会以目标端点的轨道从原始数据重新构建并执行全量脱敏 + 零泄漏校验,绝不会把 san 的明文 SQL 载荷直接回退发给公有云 Provider。
2. 参考计价与单日全局 AI 预算(/admin/review-engine/ai-budget)
- 在 Provider 表单第 3 栏 参考计价 中,按
CNY或USD/ 百万 Token 配置生效日期与分时时段(例如 DeepSeek 夜间优惠时段[00:30, 08:30)),分别填写普通输入、输出、缓存读取(cached_tokens)与缓存写入(cache_write_tokens)单价。 - 在 AI 预算(
/admin/review-engine/ai-budget) 中设置 全局单日预算上限 与 告警百分比阈值(例如每日¥100,达80%触发通知告警)。 - 开启 预算强制阻断(
enforced) 需要两步确认(点击后系统弹窗展示影响范围并下发impact_token)。达到预算上限时新预审返回2010 AI_DAILY_BUDGET_EXHAUSTED。
3. 48 条内置审核技能分类速查(/admin/review-engine/skills)
内置技能锁定定义与名称(不可删除),管理员可按业务规范逐条开关并调节 {{参数}} 阈值。以下按场景列出核心内置规则:
DML 安全与批量限制
建表、主键与列规范(DDL)
高危删改与索引治理(DDL)
4. 编写自定义审核技能与内部经验库
示例 1:新建自定义 Prompt 技能(/admin/review-engine/skills)
例如要求所有业务表必须包含审计时间字段 created_at 与 updated_at:
- 技能名称:
custom.require-audit-timestamps - 适用引擎:
all(或指定mysql/postgresql) - 规则文本(
knowledge_text): - 保存并点击 启用(启用时系统会自动执行内联 Eval 门禁校验结构化输出合法性),再把它勾选进
/admin/rule-sets规则集即可生效。
示例 2:沉淀表级 DBA 内部经验(/admin/review-engine/knowledge)
对于特定核心大表的专项约束(例如账务流水表禁止新增非唯一二级索引),无需写全局技能,可直接在 内部经验库 创建 表级作用域(table) 条目:
- 作用域:
table(选择目标数据源、库名billing、表名ledger_entries) - 零泄漏类型化对象引用写法:
- 在公有云
default轨道下,编译器会自动把{{ref:...}}校验并替换为本次预审的匿名 Token(如table_1/column_4),既让大模型准确命中该表规则,又保证真实表名绝不外泄。
强制命中必阻断原则
任何已启用且绑定到流程的审核技能或作用域命中的内部经验条目,一旦实际违规即固定归类为 policy_finding(有效级别 critical)并直接阻断提交(2008);如果某条规则只想作建议不阻断,请不要将其作为强制规则启用,改由模型常规观察(最高 medium)提醒审批人。