帮你快速理解、总结文档立即下载
文档中心>Agent Runtime>Agent 集群>实践教程>重建 Agent 后继续处理工作文件

重建 Agent 后继续处理工作文件

最近更新时间:2026-10-09 18:52:01
我的收藏
员工助手已经整理了资料并生成报告初稿,如果运行环境需要重建,用户希望重新打开助手后能够接着修改,而不是重新上传资料、重做一遍任务。
本实践以“整理客服知识库试用报告”为例:让办公助手把资料、初稿和任务进度保存到 AgentWorkspaces,重建助手的运行实例,再让助手读取原文件、补充信息并完成报告。整个过程使用虚构材料,不需要接入企业知识库。
完成后,您将验证两件事:原有工作文件可以保留;新启动的 Agent 能依据保存的任务进度继续工作。

开始前准备

已创建 Agent 集群。AgentWorkspaces 会随集群默认安装,无需单独安装。
已准备可访问的办公助手。助手需具有读取、写入和列出本地文件的工具权限,仅能在聊天中生成文本的助手无法完成本实践。
已按 为 Agent 集群开启 AgentWorkspaces 为测试助手挂载独立工作区。本文使用 /workspace;如应用使用其他路径,请统一替换下文路径。
已确认助手运行实例引用的 PVC、命名空间和挂载路径,并具备该测试工作负载的管理权限。本实践只重建计算实例,保留工作区及其 PVC。
请使用独立测试助手和工作区,保证同一工作区只有一个写入方。不要直接删除 AgentWay 的业务实例来代替下面的运行环境重建步骤,以免实例清理策略连带删除需要保留的存储。

第一步:让助手保存资料并生成报告初稿

打开助手,发送以下任务。示例目录 report-resume-demo 只用于本次实践;如果已存在,请换一个目录名,并同步替换后续任务中的路径。
请帮我整理一份客服知识库试用报告,并实际使用文件工具保存结果。
不要联网,也不要向任何人发送消息。

先确认可以读写 /workspace。计划使用的目录是
/workspace/report-resume-demo。
如果该目录已经存在,请停止,不要覆盖里面的文件。

本次虚构资料:
- 试用范围:客服一组,共 5 人。
- 首轮收集了 20 条高频问题,其中 16 条已经补齐标准答案。
- 剩余 4 条问题由林晨负责,计划周三 18:00 前完成。
- 是否扩大试用范围尚未决定。
- 用户反馈尚未收集,最终结论待补充。

请完成:
1. 创建上述目录,将原始资料保存为 source.md。
2. 根据资料生成 report-draft.md,包含进展、待办和待确认事项。
缺少的信息写“待确认”,不要编造反馈或结论。
3. 创建 progress.md,记录任务目标、已有文件和下一步:
等待用户补充试用反馈,再完善报告,原始资料和初稿需要保留。
4. 保存后实际读取这三个文件,报告各文件路径和内容摘要。
检查助手的文件操作记录,确认文件已经写入工作区。只有聊天回复“已保存”,不能作为文件已经存在的依据。可以通过助手的文件工具或容器终端打开文件,核对以下内容:
文件
应包含的内容
source.md
5 人试用、20 条问题、已完成 16 条、剩余 4 条及负责人和截止时间。
report-draft.md
当前进展和待办;用户反馈、是否扩大范围仍待确认。
progress.md
原始资料和初稿的位置,以及等待反馈后继续完善报告的下一步。

第二步:保留工作区,重建助手运行环境

由管理员在集群工作负载管理页面完成以下操作。本文使用由 Deployment 管理的测试助手,更新期间允许短暂不可用;若助手由其他控制器管理,应使用对应控制器支持的重建方式,并保留同一 PVC。
1. 找到测试助手实际使用的工作负载,核对名称、命名空间、当前 Pod 和挂载的 PVC,记录重建前的 Pod UID 与节点。
2. 暂停向该助手提交新任务,等待第一步的文件操作完成。记录或下载三个文件的副本,以便比较重建前后的内容。
3. 保留工作负载的镜像、模型配置、访问方式和存储卷配置,将测试 Deployment 的实例数调整为 0,等待原 Pod 退出并释放工作区。
4. 确认原 PVC 仍存在,将实例数恢复为 1,等待新 Pod 就绪。核对新 Pod UID 已变化,并且仍引用原 PVC、挂载到原路径。
5. 重新打开助手,确认能够正常对话。存储挂载冲突或模型连接失败时先处理错误,不重复删除工作区或新建空 PVC。
这一过程重建的是 Agent 的运行环境,不会通过重新输入原始资料来重建测试文件。若平台自动调整实例数,先使用平台支持的维护操作,避免它与手工调整相互冲突。

第三步:让新启动的 Agent 读取文件继续工作

在助手中新建一个对话,不粘贴第一步的原始资料或初稿,发送:
请继续 /workspace/report-resume-demo 中尚未完成的报告任务。

先实际读取 progress.md、source.md 和 report-draft.md,
向我概述此前完成了什么、还缺什么。
如果文件缺失或无法读取,请停止并说明,不要重新生成缺失文件,
也不要依据猜测继续。

这是本次新增的反馈:
- 5 位试用人员中,4 位反馈检索更方便,1 位认为答案分类仍需优化。
- 暂不扩大试用范围,先补齐剩余 4 条问题并优化分类。
- 分类优化由周宁负责,计划周五 18:00 前完成。

请在已有初稿基础上生成 report-final.md:
1. 保留原有进展和未完成待办,补充本次反馈与决定。
2. 不要因为计划截止时间已经给出,就将待办写成已经完成。
3. 原样保留 source.md 和 report-draft.md。
4. 更新 progress.md,记录报告已补充反馈、最终文件的位置,
以及仍需跟进的两项待办。
5. 保存后实际读取最终报告,告诉我文件路径和主要修改。

不要联网,也不要发送消息。
这里使用新对话,是为了验证助手依据工作区文件接续任务。工作区保留文件及应用主动保存的任务进度,不自动恢复进程内存或对话历史。

第四步:核对报告与任务接续结果

打开最终文件,对照下面的检查项核对。模型表达可以不同,事实、负责人和任务状态应一致。
检查项
预期结果
原始资料和初稿
与重建前保存的副本一致,没有被新助手覆盖或重新生成。
原有进展
仍是 20 条问题中完成 16 条,剩余 4 条。
原有待办
林晨负责剩余 4 条问题,计划周三 18:00 前完成,没有被标成已完成。
新增反馈
4 人认为检索更方便,1 人希望优化答案分类。
试用决定
暂不扩大范围,先补齐答案并优化分类。
新增待办
周宁负责分类优化,计划周五 18:00 前完成。
任务进度
progress.md 指向最终报告,并保留两项未完成待办。
如果助手能读取旧文件并完成最终报告,说明本次重建后,工作文件与已保存任务进度可用于接续工作。仅显示助手“运行中”,或在新对话中重新粘贴初稿后得到正确回复,都不能替代这一验证。
本实践不要求跨节点。只有记录显示新旧 Pod 位于不同节点,并且文件校验与继续写入均成功,才能将本次结果记为跨节点接续。跨节点前应确认数据已完成远端持久化、旧实例已释放工作区;容器内执行 sync 不等于完成远端持久化。

常见问题

现象
处理方法
助手只输出报告,没有创建文件
检查模板是否提供文件工具及目录写入权限;要求实际保存并回读,不能只返回文本。
重建后助手无法打开
先核对实例就绪、访问入口和模型连接;与文件是否保留分开排查。
新助手找不到原文件
停止继续写入,核对原 PVC、命名空间、挂载路径和应用实际写入位置。
能读到文件,但无法继续任务
检查 progress.md 是否包含明确目标、文件位置和下一步,要求助手先读文件再执行。
新助手把待办当作已完成
根据原始资料和任务进度纠正,重新核对最终报告。文件保留不能替代内容审核。
工作区挂载冲突
确认旧实例退出且挂载已释放,避免同一工作区存在多个写入方。