配置决策子系统

在复杂工作流中，Agent 常常需要在互斥的技术方案或执行策略间权衡。Decision 子系统为 Agent 提供了向专用模型咨询第二意见的能力（通过 AdvisoryDecision 工具），同时确保该建议绝不具备越权执行权限。

本指南介绍如何选择决策提供者、配置模型路由以及设定调用防护阈值。

前置条件

运行中的 Holon 守护进程（v0.45.0 或更高版本）。
已为 Agent 配置好主对话模型。
本地推理场景：包含 local-onnx feature 的安装（官方发布的发布包二进制已默认包含）。
远程推理场景：支持 Decision 能力的提供商 API 凭据或端点（例如 TypeSafe Jev 或兼容 OpenAI 协议的端点）。

第一步：选择决策提供者

Holon 的决策子系统支持两类架构：

本地 ONNX（零网络外发）： 完全在本地 CPU 上运行精简分类模型，数据不离开你的机器。
远程提供者： 通过 HTTP 向外部专用模型发送结构化查询（如 TypeSafe Jev 或 OpenAI 兼容端点）。

对数据隐私或离线环境有要求的场景，推荐使用本地 ONNX 提供者。

第二步：配置提供者

方案 A：使用本地 ONNX 提供者

启用本地提供者并指定预设：

holon config set decision.enabled true
holon config set decision.local_onnx.enabled true
holon config set decision.local_onnx.preset "jev-selector-q4f16"

如果机器有空闲 CPU 核心，可以提高推理线程数：

holon config set decision.local_onnx.num_threads 2

方案 B：使用远程提供者

直接设置决策模型的路由：

holon config set decision.enabled true
holon config set decision.model "typesafe@default/typesafe-ai/jev"

你也可以在 Web GUI 的设置 → Decision 设置 中直接可视化配置。

第三步：启用咨询工具并配置防护上限

出于安全防御考量，AdvisoryDecision 工具默认对 Agent 隐藏。你需要显式启用它并设置合理的防护边界，避免模型陷入无休止的反复决策：

# 向 Agent 暴露咨询工具
holon config set decision.tools.enabled true

# 限制每个对话轮次最多调用 3 次
holon config set decision.tools.max_calls_per_turn 3

# 要求至少 65% 的置信度；低于该分数时必须显式弃权（abstain）
holon config set decision.tools.min_confidence 0.65

# 设置工具超时时间（毫秒）
holon config set decision.tools.timeout_ms 10000

第四步：使用测试任务验证

运行一个包含明确选项权衡的任务：

holon run "评估 PostgreSQL 中 50 行小表查询应使用索引扫描还是全表扫描。给出最终建议前先咨询 advisory decision 工具。"

检查执行过程或最近记录：

holon transcript

你将在工具调用流中看到 AdvisoryDecision：

question：具体权衡的问题。
options：参与评估的候选方案。
outcome：select（包含建议方案与置信度分数）或 abstain（置信度低于阈值时弃权）。

可以看到，Agent 将建议作为参考证据接收，并由 Agent 自行决定是否采纳该建议。

后续探索

配置参考：全部 decision.* 配置项说明。
模型工具 schema 清单：AdvisoryDecision 的机器可读输入与输出契约。
Web GUI 指南：在浏览器中管理决策设置与查看遥测指标。