通过 AI 工具的扩展机制接入 decision-model-preview 决策模型:以评论自动审核为例,一次请求并行判定多条内容,返回 choice、probabilities、confidence,按置信度自动放行、隐藏或转人工。
背景:为什么用决策模型
评论审核、工单分类、请求路由这类判断,常见做法是让对话模型输出 JSON:判定规则写在 prompt 里,容易被诱导性内容带偏;输出外层常包代码围栏,解析不稳;每次都先生成一段分析文字,token 开销不小。
decision-model-preview 是决策模型,专做这类判断。通过 /compatible-mode/v1/systemone 接口发送 state(待判定内容)和 questions(类型化问题),直接返回结构化答案:choice(结论)、probabilities(分布)、confidence(把握),不生成自然语言文本。问题支持三种类型:Choice(从选项中选)、Score(按等级打分)、Noul(返回 0 到 1 的概率),一次调用可以混合多个问题并行评估。
与让对话模型"顺手判一下"相比:
- 判定标准写在
criteria字段里结构化传入,不依赖长 prompt 的措辞 - 返回就是 JSON,无围栏、无多余文字,Agent 与代码直接消费
- 答案是短结构而非长文本,输出 token 开销小,适合高频调用
接入决策模型目前仅支持 Token Plan 个人版。
示例:在 Claude Code 中接入评论审核
以 Claude Code 为例,通过 Slash Command 接入决策模型。其他工具的接入方式类似,区别在于扩展机制和配置文件路径不同。
步骤一:创建 Slash Command
将套餐 API Key(以 sk-sp- 为前缀)配置为环境变量 $ANTHROPIC_AUTH_TOKEN,供后续 curl 鉴权使用。
在项目根目录创建 .claude/commands/review-comments.md,写入以下内容:
步骤二:审核评论
准备一份评论文件 comments.txt,每行一条评论:
在 Claude Code 中输入 /review-comments comments.txt,输出示例:
输出里有两处值得留意:
- #5 和 #9 是负评和报错,判 pass。 判定看内容性质,不看语气。批评、质疑、报错反馈属于正常讨论,这条规则写进了
criteria。 - #8 是带链接的技术分享,confidence 只有 0.69,进人工队列。 内容介于分享与引流之间,概率分布也不极端(spam 0.84 / pass 0.16),模型明确表示倾向但把握不足——这正是
criteria边界描述要处理的那类样本。分流阈值写在 Command 的第 4 步里,调高更保守,调低更自动。
读懂返回的三个字段
答案按 questions 里的 key 原样返回,每条 Choice 答案包含:
| 字段 | 含义 | 怎么用 |
|---|---|---|
choice | 选中的选项 | 分支依据:放行还是隐藏 |
probabilities | 每个选项的概率,总和为 1 | 展示、排序、加权 |
confidence | 判定把握,0 到 1 | 阈值分流:高自动执行,低转人工 |
questions 的 key 自定义,不参与推理。需要"程度"类判断时改用 Noul(返回 0 到 1 的概率)或 Score(按等级打分),一次调用可以混合。
其他工具
不同工具的扩展机制和配置文件路径如下表所示,该表为支持扩展机制的主流 AI 编程工具示例。将上述 Claude Code 示例中的配置内容保存到对应路径即可。
| 工具 | 扩展机制 | 配置文件路径 |
|---|---|---|
| Claude Code | Slash Command | .claude/commands/review-comments.md |
| Codex | Skill | ~/.codex/skills/token-plan-review/SKILL.md |
| Qwen Code | Skill | ~/.qwen/skills/review-comments/SKILL.md |
| OpenCode | Agent | .opencode/agents/review-comments.md |
| OpenClaw | Skill | ~/.openclaw/workspace/skills/token-plan-review/SKILL.md |
| Hermes Agent | Skill | ~/.hermes/skills/moderation/review-comments/SKILL.md |
| Qoder | Skill | ~/.qoder/skills/review-comments/SKILL.md |
Skill 类工具(Codex、Qwen Code、OpenClaw、Hermes Agent、Qoder)需要在配置文件开头添加 YAML front matter,完整配置文件如下:
注意事项
- 判定边界写在
criteria里。"什么算 spam"的边界案例(如带链接的技术分享)写成明确的选项描述,比反复调整问题措辞更有效。 - 复杂判断拆小:一次只问一个明确问题,多维度分开判定,在 Command 的分流规则里组合结果。
confidence低是模型明确表示拿不准,分流到人工比重试有效;阈值 0.9 是示例值,按误判成本调整。- 请求失败按状态码处理:
401检查 API Key,422是请求体校验失败(响应正文会指出出错字段),429和529退避后重试。 - 模型输出的是判定和把握,不是事实担保。涉及账号封禁、资金处置等高风险动作时,保持人工复核环节。