助手配置 ★
一句话：一页管三件事——让不让用助手（总开关）、给多少额度（用量配额）、助手此刻有哪些工具（已注册工具，只读清单）。
功能在哪
- 菜单路径：AI → AI 助手 → 助手配置
- 地址栏路由：
/ai/agent/config - 主要权限：
agent:config:query（「用量配额」块需agent:quota:query；保存总开关需agent:config:update）
界面认识
页面自上而下三块：
总开关
| 字段 | 要点 |
|---|---|
| 启用 AI 助手 | 开关；开启时旁注「助手已开启，用户可以在『智能助手』页面使用」 |
| 开启缘由 | 500 字文本域，占位符原话：「记录为什么开、开给谁用—— 助手能改库里的表和流程，这个问题需要能回答」 |
| 保存 | 页脚按钮 + 「上次修改：时间（操作人 id）」留痕 |
用量配额
块头「新增配额」按钮；信息条原话：「没有配置配额 = 不限制（但仍然全量计量）。删除一条配额，该维度就恢复为不限制。达到上限后只拒绝新的提问，不会中断进行中的对话。」
列表列：范围（整个租户 / 用户 xxx / 智能体 / 工作流）/ 周期（每月 / 每天）/ token 上限 / 金额上限（元）（不限）/ 预警线 / 状态（生效中 / 已停用）/ 操作（编辑、删除）。
「新增配额 / 编辑」弹窗字段：
| 字段 | 要点 |
|---|---|
| 范围 | 整个租户 / 指定用户 / 指定 Agent / 指定工作流 四选一 |
| 周期 | 每月 / 每天 |
| token 上限 | 留空表示该维度不限 |
| 金额上限（元） | 留空不限 |
| 预警线 | 百分比；「达到后通知租户联系人，每周期只发一次」 |
| 状态 | 生效中 / 已停用 |
页脚「确 定 / 取 消」。
已注册的工具（只读）
警告条原话：「工具清单是只读的，不能在线开关。 工具的权限串与风险等级属于实现的一部分 —— 能在界面上把『不可逆』改成『低风险』的话，它就不再需要用户确认了。要下线某个工具，改代码并发布，这样留得下痕迹。」
列表列：展示名 / 工具 / 分组 / 风险（高风险 / 不可逆 / 低风险 / 只读）/ 需确认（要确认 | 可直接跑）/ 需要的权限（权限串标签，空 = 登录即可）/ 说明。
这块清单是「合并视图」
展示的是代码声明套上租户覆盖之后的生效值：在工具管理里维护过展示名 / 分组的工具，这里同步反映（如「数据模型清单（文…」一行）；但这里只能看、不能改。
常用操作
开 / 关 AI 助手
拨开关 → 填「开启缘由」→ 「保存」。关闭后「智能助手」页面对用户不可用；进行中的对话按平台策略收尾，新对话入口下架。
新增 / 调整配额
「新增配额」选范围与周期、填 token / 金额上限与预警线后「确 定」。额度收紧想恢复不限制：删除该条配额即可（信息条原话）。
停用一条配额而不删除
编辑弹窗里把状态改「已停用」：规则保留、暂不生效，比删除更适合「临时松绑」。
视角对照
| 视角 | 看到什么 |
|---|---|
租户管理员 docadmin | 三块全量（含配额维护） |
业务角色（如 salesman01） | 角色未授 agent:config:query 时看不到本菜单；自己的配额余量在用量看板顶部告警条自查 |
进阶
- 配额维度可叠：租户 / 用户 / 智能体 / 工作流各配各的，任一条触顶都会拒绝新提问——排查「为什么问不了」时逐维核对；
- 预警线通知每周期只发一次，配 80% 是给自己留缓冲期；
- 「已注册的工具」是安全态势的快照：哪些工具要确认、要什么权限串，一眼过完；觉得某把工具不该存在，去代码里下线而不是在这里找开关；
- 总开关的「开启缘由」是治理留痕：助手能改库里的表和流程，开给谁、为什么开，日后复核全靠这句话。
常见问题
Q：达到配额上限会打断正在进行的对话吗？ A：不会。只拒绝新的提问，进行中的对话不中断（信息条原话）。
Q：没配配额是不是就不计量了？ A：仍然全量计量，只是不限制；用量看板照常出账。
Q：已注册的工具里为什么没有开关？ A：工具清单只读；下线工具要改代码并发布，界面改风险 / 权限属于放松安全约束（见工具管理的放松确认）。
Q：总开关关了，用量还会继续记吗？ A：开关关后没有新对话产生，自然没有新用量；历史台账保留在用量看板。
Q：预警通知发给谁？ A：租户联系人，每周期只发一次。
相关页面
- 用量看板：配额消耗与调用明细的台账；
- 工具管理：已注册工具清单的维护入口；
- 智能体管理：配额「指定 Agent」维度的对象来源；
- 让 AI 助手安全读写业务数据：总开关与配额约束的那条 AI 读写链路。