闲社

标题: 【工作流】AI工作流故障排查自动化 [打印本页]

作者: admin 时间: 昨天 09:21
标题: 【工作流】AI工作流故障排查自动化
[md]
# AI工作流故障排查自动化

## 套餐描述

把脱敏执行失败记录分类、评估重试幂等性并生成可交给人工处理的故障证据包。

## 详细介绍

# AI工作流故障排查自动化

**4个可下载技能 · 4步自动化工作流 · 每个技能可单独运行**

AI工作流真正上线后，超时、限流、字段映射、凭据和副作用重试会把“失败一次”变成重复写入、丢单或死循环。本套餐把脱敏执行记录规范化，按透明规则分类失败原因，再结合重试次数、幂等键和副作用生成保守的重试或死信计划，最后汇总成可交给人工负责人的故障证据包。4个技能都是标准库Python脚本，不连接n8n或Dify、不调用重试API、不发送通知、不写数据库、不自动关闭事故；规则分类只是路由提示，不能替代现场日志、业务确认或平台运维。

## 4步自动化工作流

### 1 规范执行失败记录

**对应技能：** `execution-log-normalizer`

**解决什么：** 检查执行ID、工作流名、失败节点、错误文本、开始时间和重试次数等最小字段，避免后续排查建立在不完整日志上。

**你会得到：** READY或BLOCKED、failure_fingerprint、规范化record和缺失字段原因。

**流转到下一步：** READY记录进入失败原因分类；BLOCKED记录先补齐或转人工，不会被后续步骤掩盖。

### 2 分类失败原因与处理路径

**对应技能：** `failure-cause-classifier`

**解决什么：** 用透明规则把错误文本分到transient、data、auth、configuration或unknown，并保留命中的词和保守建议。

**你会得到：** classification、matched_terms、suggested_path、失败节点和仅限规则命中的置信说明。

**流转到下一步：** 分类结果进入重试安全规划；unknown、权限和数据类错误不会被自动当成可重试故障。

### 3 规划有上限的重试与死信

**对应技能：** `retry-idempotency-planner`

**解决什么：** 综合失败类别、当前重试次数、上限、幂等键和副作用，决定RETRY_WITH_BACKOFF、HOLD_FOR_HUMAN_REVIEW或DEAD_LETTER。

**你会得到：** action、重试上限、退避序列、阻断理由、side_effects和never_call_retry_api策略。

**流转到下一步：** 计划与前两步证据一起进入事故包；它只提出动作，不实际重跑或写入任何系统。

### 4 生成故障人工复核包

**对应技能：** `incident-review-packet-builder`

**解决什么：** 把失败记录、分类、重试计划、时间线和人工检查项汇总成可追踪的事故记录。

**你会得到：** incident_hash、失败节点、拟议动作、完整证据、人工复核队列和READY_FOR_HUMAN_REVIEW。

**最终交付：** 一份可接入Error Workflow、CI、工单或值班流程的脱敏故障证据包；是否重试、修复、回滚或关闭仍由人工负责人决定。

## 实际示例

随包样例使用一个虚构的CRM同步执行记录，失败节点为CRM Request，错误文本为限流，当前重试次数为1并有脱敏幂等键。第一步得到READY记录；第二步识别transient；第三步生成有上限的RETRY_WITH_BACKOFF；第四步生成非空incident_hash和三项人工确认队列。缺少必需字段的样例会在第一步BLOCKED；没有幂等键但存在写入副作用时计划会转人工或DEAD_LETTER。示例只验证本地规则和证据流转，不代表真实业务故障已修复。

## 适合谁

- 使用n8n、Dify或相似平台运行AI工作流，需要处理失败执行和限流的个人与小团队
- 维护Error Workflow、死信队列、失败工单或值班告警的实施人员
- 需要避免重试重复写库、重复发信或重复调用外部API的自动化负责人
- 想把“先看日志、再判断原因、再确认幂等”固化成可复核流程的团队

## 买家只需提供

- 已授权且脱敏的执行失败JSON，含失败节点、错误文本、时间和重试次数
- 业务允许的重试上限、幂等键规则和副作用清单
- 人工负责人、死信存放位置、回滚要求和通知边界

## 使用方式

1. 使用Python 3.10或更高版本，按4个README准备UTF-8 JSON；删除密码、Cookie、Token、API Key、真实客户数据和绝对路径。
2. 依次运行失败记录、原因分类、重试规划和事故包脚本，也可将JSON结果映射到Error Workflow、CI或工单系统。
3. 先用随包限流、缺字段和缺幂等键样例验收READY、BLOCKED、transient、unknown、DEAD_LETTER和READY_FOR_HUMAN_REVIEW，再接入真实脱敏日志。

## 交付与验收

- 交付4个独立技能目录，每个包含_meta.json、SKILL.md、agents/openai.yaml、README、Python执行器和脱敏样例；根目录另含完整详情和发布清单。
- 4个脚本均可离线重复运行，相同输入产生稳定JSON；技能数与工作流步数精确为4，顶层目录slug唯一且为小写短横线。
- 正常样例得到执行记录READY、原因transient、RETRY_WITH_BACKOFF和非空incident_hash；缺字段样例得到BLOCKED；副作用无幂等键样例进入人工或死信路径。
- 缺字段、无效JSON、未知原因、重试上限、缺幂等键和副作用风险均保留可见理由；不会把unknown、auth或data错误自动升级为重试。
- 不包含平台账号、OAuth授权、执行数据读取、重试API、通知发送、数据库写入、自动修复、自动回滚、事故关闭、长期存储、值班服务或人工运维。

## 服务说明

本套餐只处理买家有权使用且已脱敏的执行记录，不接收密码、Cookie、Token、API Key、真实客户数据或内部机密。错误关键词只能提供保守分类，可能误报或漏报；重试是至少一次语义，幂等键和副作用必须由买家结合业务确认。任何PASS或RETRY建议都不代表系统安全、数据已恢复或可以跳过人工审批，不承诺零故障、绝对合规、固定节省时间或经营结果。

## 套餐图标

## 包含技能

- [execution-log-normalizer](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=execution-log-normalizer)
- [failure-cause-classifier](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=failure-cause-classifier)
- [incident-review-packet-builder](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=incident-review-packet-builder)
- [retry-idempotency-planner](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=retry-idempotency-planner)

## 安装方式

此套餐为**付费套餐**，购买后可一键下载全部技能。

🛒 [点击购买并下载 AI工作流故障排查自动化](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=buy&bundle_id=435)

## 收费方式

💴 **现金购买** - 需要支付 ¥127.00

## 前往安装

**[👉 点击前往套餐安装页面](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=bundle&ac=detail&slug=execution-log-normalizer-9b867949593e)**
[/md]

欢迎光临闲社 (https://www.xianshe.com/)