一句话
智能助手不是把步骤连起来就算完：要用稳定的业务主键定位记录，用幂等规则防止重复，用日志定位过程，最后回到目标表确认结果。
业务事件或定时触发 ↓ 用稳定条件查询目标数据 ↓ 计算、判断或逐行映射 ↓ 修改已有记录，或按规则新增 ↓ 回读目标表，确认业务结果
用稳定主键定位
- 资产用资产编码，项目用项目编号，周期任务用“项目编号＋月份”。
- 姓名、项目名称适合展示，不适合当唯一条件。
- 查不到目标记录时，先判断是数据缺了、条件错了还是字段类型不一致，不要默认自动新增。
四类常用模式
| 模式 | 怎么做 |
|---|---|
| 事件完成后回写台账 | 审批通过后按资产编码、项目编号找到主档，更新状态、使用人或完成标记。 |
| 定时生成待办 | 按计划查询仍在进行、负责人有效的项目，为每个项目创建任务；已存在的跳过。 |
| 查询上期记录 | 先算出上一个周期，再按“对象＋周期”查；第一期没有上期是正常情况。 |
| 子表逐行回写 | 每一行用自己的编码匹配自己的目标记录，不要把同一个值写给所有记录。 |
幂等：执行一次和执行两次结果一样
- 更新状态天然幂等；生成任务前先按组合键查，有则跳过。
- 生成逾期提醒时查“已逾期且未生成提醒”，生成后立刻写回提醒标志。
- 验收时故意再跑一次：不应多出任务、提醒或台账。
- 部门负责人这类关系放在人员档案或配置表里，自动化先查关系表，不写死人名。
日志排错顺序
- 触发事件是否真的发生。
- 数据是否满足触发条件。
- 是否产生了执行实例。
- 第一个异常节点在哪里。
- 该节点的输入、筛选条件、字段类型、排序和映射对不对。
- 目标表是否得到预期的数量和内容。
绿色日志只能说明节点按配置跑了，不能说明配置符合业务。最终要回到台账、任务表里看实际数据。
常见错误
- 按姓名或“包含”条件找记录。
- 查不到就自动新增，造出重复主档。
- 周期任务没有“对象＋周期”组合键。
- 项目结束了还在生成月报。
- 失败后整批重跑，没先确认已经写了哪些。
资料来源：jdy-knowledge《智能助手业务闭环与排错》（《自动化业务闭环》课程第 1—9 集学员稿提炼）。
笔记配合视频看效果更好，视频在 B 站「AI企业管理研究员」等平台。