SuperAPI AI 工具集

agent-output-parsing

智能体与模型

查看项目

更新于 10-16 05:46

技能介绍

用途:该技能用于解析 Configurator CLI 在非 TTY 模式(或使用 --json)时输出的 JSON envelope,帮助在自动化脚本中处理输出、理解退出码并排查部署失败。

主要能力:

  • JSON envelope 结构说明,包含 command、version、exitCode、result、logs、errors 字段。
  • 各命令 result 形状说明,包括 validate、diff、deploy --plan、deploy(已执行)、introspect。
  • 退出码决策树:0 成功;2 认证问题(检查 SALEOR_URL 是否以 /graphql/ 结尾、SALEOR_TOKEN 是否有效、在 Dashboard 重新生成 token);3 网络问题;4 校验错误;5 部分失败;6 删除被阻止;7 破坏性变更被阻止;1 为意外错误。
  • 逐层下钻模式:先查看失败概览,再按实体类型过滤,最后下钻到具体实体的字段级差异,修复 config.yml 后重新校验并部署。
  • 报告读取:部署报告默认写入当前工作目录,文件名为 deployment-report-YYYY-MM-DD_HH-MM-SS.json,可用 --report-path=custom/path.json 指定路径;报告包含 summary、operations、duration、reportPath、resilience 等。

使用方式:在 Bash 或 JavaScript 中调用命令并解析输出。示例:OUTPUT=$(pnpm dlx @saleor/configurator deploy --json 2>/dev/null),再用 jq 读取 .exitCode、.result.errors[]、.errors[] 等字段。JavaScript 中注意 CLI 非零退出时仍会向 stdout 输出有效 JSON,需捕获 err.stdout 再解析。

适用场景:自动化脚本、命令链工作流、部署失败排查、按实体类型或名称下钻分析变更。

限制:资料未提供价格、平台支持范围或性能指标;具体命令与字段以对应文档为准。