67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件:调整模块标题、链路图缩放,替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线,将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包,迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
6.8 KiB
6.8 KiB
模块 9:Agent 的权限与停止边界
给 Agent 更多工具,不会让结论更可靠,只会扩大它可能造成的影响。
角色、上下文和工具权限必须同时收敛,才能让一份 Agent 资产在不同任务中保持可控。
角色
允许承担什么判断
允许承担什么判断
上下文
允许读取什么材料
允许读取什么材料
工具
允许产生什么副作用
允许产生什么副作用
按风险选择最小工具集
| Agent 类型 | 典型职责 | 最小能力方向 | 不应默认拥有 |
|---|---|---|---|
| 代码理解 Agent | 定位入口、调用链与事实 | 代码搜索、文件读取 | 写文件、执行发布 |
| 方案审查 Agent | 比较方案与范围风险 | 读取源码、diff、规则 | 直接修改业务代码 |
| 测试设计 Agent | 生成测试点与验证方案 | 读取需求、代码、测试 | 宣称测试已经通过 |
| CI 分析 Agent | 分层解释失败日志 | 读取日志、配置、diff | 修改环境或密钥 |
| 实施 Agent | 在确认范围内生成变更 | 受控编辑与验证 | 自行扩大任务范围 |
先定义角色,再分配最少工具;不要先打开全部权限,再期待提示词自己约束行为。
用真实案例设计一个只读审查 Agent
角色:状态变更审查 Agent
输入:变更目标、入口与 Service 源码、状态定义、相关测试或 diff
可读材料:页面/API、权限与审计入口、状态写入代码、测试结构
输出:事实表、影响链路、最小改动建议、验证清单、待确认项
禁止:修改代码、执行发布、把前端必填当作最终业务保护
停止:缺少状态写入点、关键规则冲突、验证证据缺失
公务用车案例在这里只贡献“状态变更要先取证”的素材,不把任何字段名或接口路径固化为通用规则。
Stop Conditions 是 Agent 的安全阀
| 停止信号 | Agent 应输出 | Agent 不应做 |
|---|---|---|
| 缺少入口或关键 Service | 缺失材料清单 | 补猜调用链 |
| 状态规则与需求冲突 | 冲突来源与待确认问题 | 自行选择业务规则 |
| 请求超出角色权限 | 范围风险与转交建议 | 临时取得写入或发布权限 |
| 验证记录不完整 | 待执行验证项 | 写成“已通过” |
| 需要外部系统事实 | 所需日志、接口或外部确认项 | 将源码推断包装成运行结论 |
可靠 Agent 的表现不是总能继续,而是知道何时不能再继续。
自定义 Agent 的验收标准
职责清楚
知道何时选择它
知道何时选择它
权限收敛
只拥有必要工具
只拥有必要工具
输出稳定
可被后续 Skill 或 Review 使用
可被后续 Skill 或 Review 使用
会正确停止
证据不足不虚构
证据不足不虚构
不能说明“为什么需要这个角色、为什么给这些工具”的 Agent,不应进入共享资产库。