关于 workflows-history
workflows-history 是用于查询 Zapier 工作流运行记录的 Agent 技能,可查看运行结果或故障细节。它帮助用户追踪状态、时间、输入、输出和步骤错误,并区分已发布运行与草稿测试。
主要功能
- 01按 ID 或名称查找工作流
- 02获取运行历史
- 03汇总运行状态与数据
- 04检查步骤错误
- 05识别草稿测试运行
适用场景
- 01排查失败的工作流运行
- 02查看近期运行状态和输出
- 03确认修改是否仍未发布
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ zapier/ agent-skills --skill workflows-history安装后在 Claude Code 中输入/workflows-history确认已加载。
详细介绍
Zapier 工作流历史记录
使用公开 SDK CLI 实验性命令界面。不要使用 zapier-sdk-code-substrate。
兼容性检查
使用此技能前,先运行 workflows-doctor 捆绑包兼容性检查。如果未安装或无法加载 workflows-doctor,请运行 workflows-install,或从 zapier/agent-skills 安装 workflows-doctor,然后再继续。如果 workflows-doctor 报告 SDK/技能存在偏差,请按其刷新说明操作,停止本次技能调用;如有需要,重新加载 Agent 工作区,并请用户重新运行原始请求。
确定工作流
如果用户提供了工作流 ID,请直接使用。
如果用户通过名称或描述来指代工作流,请先列出工作流并找到匹配的 ID:
zapier-sdk --stability experimental list-workflows --json
如果有多个工作流匹配,请列出候选项并询问用户指的是哪一个。
获取运行历史记录
zapier-sdk --stability experimental list-workflow-runs <workflow-id> --json
解析 JSON 输出。可能有用的字段包括 id、status、started_at、finished_at、input 和 output。
已知工作流 ID 时,请附上 Zapier 编辑器链接:
https://zapier.com/workflow/<workflow-id>
深入查看单次运行
如果某个已部署的工作流运行失败,或用户想查看步骤级详细信息:
zapier-sdk --stability experimental get-workflow-run <run-id> --json
使用 run-workflow-draft 启动的草稿测试运行也是工作流运行(kind: "draft");请使用 get-workflow-run 检查。
如果手动触发器响应返回了触发器 ID,但尚未获得工作流运行 ID,请从触发器追溯到运行:
zapier-sdk --stability experimental get-trigger-run <trigger-id> --json
总结响应中出现的失败原因、状态、时间、输入、输出以及任何步骤错误详情。除非用户要求,否则不要直接输出原始 JSON。
草稿状态
运行使用已发布的版本——未发布的草稿编辑不会显示在运行历史记录中。如果用户预期最近的更改已反映在运行中,但实际并未反映,请检查是否有未关闭的草稿包含该更改:
zapier-sdk --stability experimental list-workflow-drafts <workflow-id> --json
如果存在未关闭的草稿,请告知用户其更改尚未发布(注明 last_edited_at 和编辑器链接),不要据此断定工作流已损坏。