mcpField
W
workflows-history

workflows-history

github.com/zapier生产力23462 次安装3 周前更新
代码仓库

关于 workflows-history

workflows-history 是用于查询 Zapier 工作流运行记录的 Agent 技能,可查看运行结果或故障细节。它帮助用户追踪状态、时间、输入、输出和步骤错误,并区分已发布运行与草稿测试。

主要功能

  1. 01按 ID 或名称查找工作流
  2. 02获取运行历史
  3. 03汇总运行状态与数据
  4. 04检查步骤错误
  5. 05识别草稿测试运行

适用场景

  1. 01排查失败的工作流运行
  2. 02查看近期运行状态和输出
  3. 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 和编辑器链接),不要据此断定工作流已损坏。

评论

支持 Markdown