SuperAPI AI 工具集

reliable-mutations

智能体与模型

查看项目

更新于 10-15 20:09

技能介绍

用途:规范智能体在托管前台运行预算与长时间后台交接场景下的写入行为,确保变更真正持久化。

主要能力与规则:优先使用单次原子调用;若动作支持批量(add many、set all、bulk update),一次性传入完整批次以原子提交。写入后必须重新读取数据(列表/读取动作、计数查询)核对行数、ID 与字段是否符合意图,再向用户报告。报告需给出具体证据,如“已保存 12/12 个面板(ids …)”或“已更新 5 行”,不能仅凭单次工具返回成功标记推断完成。若在提交与验证完成前被时间预算截断,应明确说明,报告已持久化的 M/N 与剩余部分,不得把部分或未验证的写入说成完成。

限制与禁止:不要在任何运行预算下循环执行大量小写入;逐项写入在交接、后台续跑或上游失败时可能留下部分状态。若不存在批量动作,应视为动作层缺口,去新增或扩展支持批量的动作,而不是用循环掩盖。不要因每个工具调用都返回成功就宣称完成;不要悄悄缩小范围并当作已完成;不要通过请求更长超时来“修复”,应重构写入方式。

相关:actions(定义或扩展批量/原子动作)、storing-data(数据存放与读写范围)、performance(验证最终状态时避免查询瀑布)。设计文档 packages/core/docs/design/durable-agent-runs.md 描述真正的上限修复(可检查点与持久运行),本技能是面向智能体的缓解措施。