Agent 工作流
由 Relay 驱动的无监督 Agent 工作流
你把任务说明和输入文件发送到 Relay,然后合上笔记本。
一台持续在线的主机在下一轮检查中发现任务。主机上的 Agent 读取交接备注和任务文档,开始执行。工作结束后,它把产物、日志和结果说明推回 Relay。
等你再次打开电脑,就可以接收结果,继续下一步。
配置好这条流程后,任务的接收、执行和回传可以无人值守地进行。Relay 负责交接文件与上下文,主机上的 cron 负责定时触发,Agent 负责在预先约定的范围内完成工作。
让常开主机成为任务执行端
这条工作流需要一台持续在线、能够运行 Agent 的主机。它可以是你的工作站、家用服务器,或者已经配置好的远程机器。
先为主机准备好 Relay CLI 会话、目标工作区和 Agent 运行环境,再约定任务入口与结果位置。例如,在同一个工作区中使用:
- /tasks:等待主机处理的任务。
- /results:主机回传的结果。
主机只检查约定的任务入口,结果由提交任务的设备稍后接收。
在 Linux 主机上,可以通过 cron 定时启动收件脚本,例如每五分钟检查一次。任务会在后续检查发现它时开始处理。检查间隔由你根据工作节奏设置。 cron 配置说明
把足够明确的任务送进收件箱
无人值守的执行,需要一份能够直接开始工作的任务说明。假设你准备让主机运行一次评估,并整理结果,可以交付这样的目录:
task/
├── TASK.md
├── inputs/
└── config.json任务文档说明目标、输入文件、运行方式和完成标准。还可以写清楚工作范围、最长运行时间,以及遇到缺失输入时应如何处理。分阶段交接推荐用 HANDOFF.md 记录进度和下一步;已有的 TASK.md 也可以承担同样的作用。
交接备注则为 Agent 提供简短的入口:
请先阅读 TASK.md,使用 inputs/ 和 config.json 完成本轮评估。整理指标、运行日志和结果摘要,将产物回传到 /results。
通过 CLI 发送时,可以写成:
relay bundle push ./task --add-folder /tasks --note "请先阅读 TASK.md,完成评估并整理结果,产物回传 /results。"发送端保持联网,直到上传与发布成功。此后,主机可以独立接收这次交接,笔记本可以离线。
发现任务后,先读懂上下文,再开始执行
每次定时检查,主机上的执行脚本读取指定任务目录的收件箱:
relay bundle inbox --folder /tasks --jsonJSON 输出包含完整备注。执行脚本选择待处理的 Bundle,先在本地保存 Bundle ID 和备注,再将文件下载到这个任务自己的目录。如果 relay bundle pull --help 列出 --save-note,脚本还可以添加该参数,将完整备注作为 RELAY_NOTE.md 保存在接收目录。此时 JSON 也会返回 note 和 notePath。
接收端 Agent 按照 Relay Skill 的流程完整阅读备注。如果备注指向 TASK.md 或其他交接文档,还需要完整阅读该文档,再结合预先配置的任务要求开始工作。
在评估示例中,Agent 可以检查输入是否齐全,运行既定评估,分析输出,再按照完成标准整理交付物。缺少输入或无法继续时,则保留问题说明和日志,等待后续补充。
任务说明也应交代如何判断完成。例如,“运行评估”之后,还需要核对输出文件、记录失败项,并生成可供复核的摘要。
将产物和结果说明一起推回
Agent 完成工作后,可以把交付目录整理为:
outputs/
├── SUMMARY.md
├── metrics.csv
└── run.log其中,SUMMARY.md 说明本次处理了什么、哪些检查已经通过,以及还有哪些问题需要复核。
执行脚本随后将产物推回 Relay,并在备注中关联原任务:
relay bundle push ./outputs --add-folder /results --note "原任务 <任务 Bundle ID> 已完成。指标和日志已附上,结论及待复核项见 SUMMARY.md。"只有结果 Bundle 成功发布后,主机才将这次任务记录为已交付。
你下次上线时,可以查看 /results 中的收件,读取结果备注,再取回文件。主机交付的上下文会帮助你判断下一步应该复核、继续分析,还是发起新的任务。
从一次交接,延伸到持续接收任务
这套方式适合输入和交付物比较明确的工作,例如运行评估、整理数据、生成报告,或者处理一批待分析的材料。
你准备任务文件,写清楚目标和交付要求。常开主机定时收件,由 Agent 执行,再将产物与说明回传。
笔记本可以在交付任务后离线。主机继续工作,下一次交接则带着结果和新的上下文,等待你回来接手。