SuperAPI AI 工具集

trigger-flow

部署与运维

查看项目

更新于 10-16 03:46

技能介绍

用途:这是一个 Postman Flows 助手技能,用于通过 Postman CLI 触发(运行)已部署的 Flow。触发会经由 Webhook 执行流程,并返回 Run ID(x-run-id)、HTTP 状态和响应体。

主要能力:包装命令 POSTMAN_CLI_SOURCE=claude-code-plugin postman flows trigger <flowId> [options]。支持 -i/--input 传入键值对载荷(可重复)、-f/--input-file 从 JSON 文件读取载荷、-q/--query 传查询参数、--headers 传自定义请求头、-s/--scenario 使用命名场景、-n/--dry-run 仅预览请求 URL 与载荷(加 --show-secrets 可显示令牌)、-r/--result 仅输出响应体。Flow ID 为 24 位十六进制。

使用方式:若用户给出 24 位 ID 则直接使用;若只给名称,需先用 list-flows 技能解析 ID,此时需要工作区 ID,未知则询问用户;单一匹配用其 ID,多个匹配列出候选让用户选择。随后把自然语言请求翻译为 CLI 标志,运行前展示确切命令。触发成功后报告 Run ID、HTTP 状态与响应体。

状态处理:若流程未部署(404 并提示部署命令),说明无法触发,并可在用户明确确认后使用 deploy-flow 技能部署,再重新触发。若触发器被禁用,说明情况,并在用户确认后执行 POSTMAN_CLI_SOURCE=claude-code-plugin postman flows update <flowId> --trigger on,然后触发。若返回非 2xx,展示状态与响应体,并可用 get-flow-run 技能按 Run ID 查看失败块、原因与状态。

限制:触发已部署流程是非变更操作,无需确认;部署或启用触发器属于状态变更,必须先获得用户明确确认。CLI 前缀、凭据复用与错误处理规则参见 references/flows-cli-baseline.md。