SuperAPI AI 工具集

get-flow-run

部署与运维

查看项目

更新于 10-16 03:46

技能介绍

用途:这是一个 Postman Flows 助手技能,依据 Run ID 使用 Postman CLI 检查 Flow 运行,输出每次运行的详细日志、失败块和状态。适用于触发器返回非 2xx,或用户需要排查某次 Flow 运行失败原因的场景,属于只读操作,无需确认。

主要能力:封装命令 POSTMAN_CLI_SOURCE=claude-code-plugin postman flows get-run --run-id <runId> [options]。选项包括 -r, --run-id <runId>(必填,即 trigger-flow 报告的 x-run-id)、-l, --logs(显示详细事件日志)、--filter <blockId>(将事件日志聚焦于一个或多个块 ID,可重复使用)。

使用方式:

  1. 获取 Run ID:使用触发器技能刚报告的 Run ID(x-run-id);若没有,向用户询问。
  2. 检查:先用摘要,再添加 --logs 查看细节。例如: POSTMAN_CLI_SOURCE=claude-code-plugin postman flows get-run --run-id session-abc123 POSTMAN_CLI_SOURCE=claude-code-plugin postman flows get-run --run-id session-abc123 --logs 如需聚焦可疑块: POSTMAN_CLI_SOURCE=claude-code-plugin postman flows get-run --run-id session-abc123 --logs --filter blockId1
  3. 报告:解析输出并汇报,而非直接倾倒原始日志,应说明哪个块失败及原因、运行状态。示例:Run session-abc123 — failed;Failing block: "HTTP Request (Get Orders)";Reason: downstream returned 504 after 10s timeout;Status: error;Suggestion: the upstream API timed out — retry, or raise the request timeout.

限制:需参考 references/flows-cli-baseline.md 了解 CLI 前缀、凭据复用和错误处理规则。若未找到 Run ID,需与用户确认,因为运行记录可能需要一点时间才会出现。原文未提供收费、平台或效果等更多信息。