跳到正文
秩启v1.5.4
外贸企业AI应用与组织升级

方法与实践 / 智能体与工作流

工作流出了问题,运行记录应该留下哪些信息?

用任务状态、版本和关键节点帮助定位问题,同时控制日志中的敏感内容。

约 2 分钟
同事在独立资料夹之间核对任务与接手信息(AI概念配图)
AI概念配图,用于辅助理解方法。
要点

运行记录至少要能说明哪项任务、用了哪个版本、在哪一步发生问题以及哪些动作已经完成。保留足够定位的状态和引用位置,同时限制敏感原文与凭据进入日志。记录应服务于诊断和责任交接。

哪一项:任务标识、输入来源、版本;哪一步:状态、耗时与错误类型;谁处理:待办、负责人和恢复结果
运行记录回答三个问题 · 查看原图,可缩放阅读 ↗

从业务任务定位执行过程

为一次任务分配稳定标识,将触发时间、输入来源、流程版本和最终状态关联起来。业务同事提出问题时,维护人员可以找到对应执行,而不必在大量模型对话中猜测。

每个关键节点记录开始、完成或失败,以及耗时和错误类型。对外部动作还要保留目标记录标识,便于核查是否已经创建、发送或修改。

记录足够信息,避免复制全部资料

通常可以保存来源位置、必要字段和脱敏样例,不需要把所有客户资料或整份附件长期复制进日志。密钥和访问令牌应排除,日志查看和保留期限按企业实际要求设置。

为了复现问题需要保留原输入时,应明确存放位置与授权人员。调试记录也属于资料管理范围,不能因为名称叫“日志”就绕开原有访问要求。

让异常记录指向后续处理

区分输入不完整、模型返回异常、接口不可用与业务校验失败,给出适合使用者理解的说明。只有错误码而没有处理去向,会让员工反复提交同一任务。

维护人员应能筛选待处理事项,并记录修复、补做或取消。上线后的观察不仅是统计调用次数,还要知道未完成任务由谁承接、什么时候需要暂停相关流程。

从一条业务标识找到执行证据

记录流程版本、关键步骤状态、结果位置与处理人,用脱敏数据重现一次失败。日志不保存不必要的敏感原文与凭据,保留期限和读取人员由企业明确,调试功能可用性按实际环境核对。

参考来源

外部资料用于说明方法;具体功能、费用和许可条件以供应商现行说明及实际验证为准。

  1. n8n Docs|调试执行记录利用已有执行数据定位问题

文章评论