哪些信息可以一起呈现
结构类型、业务类型、状态和进度分别表达不同含义。一个“正文编写”任务可以拥有子任务;它的图标不决定是否完成,100% 进度也不能替代应用验收。只提供摘要或文件路径,不会自动生成平台可下载的交付物。
从业务操作到统一视图
例如,应用保存“编写施工方案”这项工作后,该任务可以先以未开始状态出现。应用明确派发后,同一任务记录本次执行;结果提交并通过应用的业务检查后,再映射为相应业务状态。再次执行同一项工作时,应保留可追溯的尝试记录。 当前后台同步是异步的。请求已进入队列,只说明平台接收了同步请求;任务视图可能短暂显示上一次保存的状态。页面在可见时约每五秒重新读取数据,但这不是同步完成时间的保证。打开页面和手动刷新只读取平台已保存的任务及执行事实,不会重新运行 Agent,也不会替应用发起一次任务同步。持续不同步时,需要检查应用是否成功提交同步请求及后台诊断。
同一项工作如何保持连续
应用为业务任务和每次尝试提供稳定的来源标识。平台据此关联相同任务及执行记录;重复同步不会因为标题变化而创建另一项工作。修改任务名称和更换显示语言也不应改变任务身份。 以标书应用为例,一个计划步骤可以先出现在任务树中,后续准备出实际业务任务时继续使用同一来源标识。应用再将执行尝试逐次关联到该任务,用户可以从统一入口回看每次过程。 真正新增的业务工作应使用新的业务标识;不能为了减少任务数量,把不相干的工作或多个执行尝试合并成一条记录。在哪里修改
平台排期不会改变应用的业务依赖,也不会到点自动派发。多人同时修改排期遇到冲突时,应重新读取并核对最新数据,避免覆盖其他人的安排。
运行结束与业务完成
一次 Agent 运行结束,只描述那次执行。应用可能还需要核对覆盖范围、内容质量、材料来源或提交结果,再决定业务任务是否完成。平台会保留应用给出的业务状态,避免以 Runtime 成功覆盖业务判断。 通用项目任务的“实施成功 → 待验收 → 接受或返工”流程见执行与验收。应用管理的任务使用该应用自己的验收入口;平台通用派发和验收工具不能接管这些任务。 点击某次执行时,平台根据保存的关联定位那次运行,而不是打开“最近一次对话”。应用没有提供可定位的 Agent 执行、历史记录缺失或权限变化时,可能只能查看摘要;不能以其他运行的内容补齐它。同步异常时
后台同步失败会保留已有平台任务并记录诊断,已排队的同步可重试。若应用的业务提交成功但同步请求未入队,需要应用再次请求同步。不要通过重跑已完成的业务工作来修复显示问题。
接入实现与验证要点见 SDK 接入指南。