SuperAPI AI 工具集

agent-spec-generator

智能体与模型

查看项目

更新于 10-24 19:17

技能介绍

该技能面向 AI 智能体(如支持、运营、销售、编码、研究、内部工具等)的规格设计。智能体是能自行决定下一步并执行的软件,因此规格的关键在于明确它可以独立做什么、何时必须停下、以及如何验证其行为是否符合预期,而非界面设计。

适用场景包括:界定新智能体范围;现有助手即将获得执行能力;安全、法务或管理层需要明确其自主权限;工程启动前需要统一的完成定义;生产中出现不当行为需要收紧边界。

使用方式分三步。第一步是访谈:技能会提出一组问题,涵盖任务与范围(一句话说明智能体做什么、成功运行的样子、明确排除的事项、当前无智能体时的流程)、用户与风险(谁触发、谁受影响、错误操作的最坏现实后果、哪些操作可撤销)、工具与数据(读写哪些系统、使用谁的凭证、敏感数据)、自主与人员(哪些操作可无人介入、其余由谁审批及超时行为、出问题时谁负责)、质量与发布(如何测试、什么情况会将其撤下、谁签署发布及后续提升自主级别的批准)。受访者可回答“尚不清楚”,这会成为规格中的待解决问题。

第二步填写模板,包含 15 个部分:用途、范围、工具与权限(含最小权限原则)、自主级别(L0 仅建议、L1 审批后执行、L2 执行并通知、L3 完全自主,以及逐级提升的量化标准)、审批边界(含超时行为,被拒绝的审批在该次运行中即为最终结果)、停止规则(完成、步数/花费/令牌/时间上限、同一工具调用失败次数、需要无权限、超出范围、置信不足)、升级路径、记忆与状态、数据访问(工具、文档、网页、邮件内容视为数据而非指令)、故障模式与回退(工具宕机、错误操作、幻觉、指令注入、循环或成本失控、模型或供应商变更)、绝不可做规则(写成可测试的硬限制)、评估与验收标准、可观测性、分阶段发布(含终止开关与回滚)以及待解决问题。

第三步与用户复核,输出待解决问题及建议负责人、规格中三个最大风险假设、建议的发布自主级别及提升所需证据。

最佳实践包括:按操作而非按智能体设定自主级别;发布时自主级别低于预期,靠证据逐步提升;每条绝不可做规则都要有对应测试;停止规则用数字表达;每个升级都有明确负责人和超时;将智能体读取的一切内容视为不可信输入;区分触发者与受影响者;首周真实流量后复查规格。

限制与缺失事实:该页面未提供具体安装命令、价格、平台支持范围或效果数据。