SuperAPI AI 工具集

unattended-agent-runs

智能体与模型

查看项目

更新于 10-26 02:06

技能介绍

该技能面向需要无人值守运行的新闻编辑室代理工作,即计划任务或长期代理在无人逐次监督的情况下持续运行。

用途:适用于计划进程检查收件箱、日历、任务队列或问题池;长期运行的代理从本地生产者接收周期工作;运行需要在重启或上下文丢失后安全恢复;操作员需要消息、文件等外部操作已落地的证明。不适用于有人主动监督的单个短任务、没有稳定授权或升级策略的工作、需要在发生时刻由人介入的操作,以及一次性批处理。

主要能力与使用方式:

  1. 运行层级选择:Tier 1 为每次运行使用全新独立进程,给予一个有界任务、允许输出刷新的超时、摘要目标文件和狭窄范围,最易检查和替换;Tier 2 为持久受监督会话,适用于启动成本高、需持续上下文或长任务场景,生产者需持有单飞租约,直到会话执行明确的 done 步骤且生产者确认摘要已投递。生产者身份须包含进程 ID 和进程启动时间,防止重用进程 ID 继承旧租约;生产者重启后新生产者接管现有租约继续监督。

  2. 工作流程:接收带唯一运行 ID 的自包含任务;创建阶段为 started 的恢复检查点;逐页完整阅读提示并记录每页已读;重读本次运行的持续搁置列表;记录下一步并进入 working 阶段;外部操作前写入 side-effect-pending 及副作用记录(目标、幂等键、预期时间、待检查证据);执行一次授权操作;回读外部状态并记录精确 ID、回读结果和完成时间,进入 side-effect-complete;从检查点继续,明确记录假设、开放问题和来源限制;写入最终摘要文件并记录 summary-written;执行一次明确 done 步骤,生产者确认摘要投递后才清除租约。

  3. 规则要点:恢复时启动全新代理会话,只读活动检查点和继续所需的任务部分,不重放旧终端记录,不重复已记录完成的操作;若阶段为 side-effect-pending,重试前先检查外部系统;无活动检查点时不带入上次运行的项目、假设或未完成工作;不得因等待输入而阻塞,应通知请求者并在可能时按声明的安全假设继续并记录;无法安全推进时写入 blocked 检查点和摘要,在不执行外部操作的情况下完成运行。消息投递方面,仅在需要输入或结果就绪时联系请求者;配置的静默时段将授权消息放入暂存队列;释放暂存消息前检查发送日志和目标是否重复;已接受或已排队不等于送达证明,需验证收到的副本或目标记录,模糊发送在重试前先检查;生产者负责投递运行摘要,代理只写文件不自行发送状态。资源与持久化方面,对会话范围而非仅监督者应用内存高值、最大内存、最大交换和 CPU 控制;并行工作扇出保持较小,通常两到三个;将大型渲染、媒体处理或广泛数据作业卸载到合适计算资源;避免在压缩单行文件上运行 .{0,N}(a|b).{0,N} 形状的表达式,使用固定字符串搜索或有界索引切片工具;使用支持持久性的受监督用户服务,并用真实重启验证重启行为;固定工作目录和状态目录,不依赖隐藏默认值或符号链接。

  4. 完成记录:运行结束后生成简短完成记录,包含运行 ID、结果(完成或阻塞)、检查来源列表、外部操作及精确 ID 和回读、假设、暂存消息、恢复阶段和摘要路径。

适用场景:新闻编辑室中需要周期性无人值守执行的收件箱检查、任务队列处理、问题池推进等,以及需要安全恢复和外部操作落地证明的长期代理工作。

限制:资料未提供具体安装命令、平台绑定、价格或收费信息;平台示例仅提及 Linux systemd 用户单元、macOS launchd 和 Windows 任务计划程序,具体配置需参考仓库内 references 文件。该技能强调必须有书面授权策略,未授权时只能准备草稿或记录阻塞,不得执行外部操作。