SuperAPI AI 工具集

apidog-test-scenario

测试与质量

查看项目

更新于 10-15 16:51

技能介绍

用途:该技能用于 Apidog 测试场景(test-scenario)的建模与编排,支持查询、创建、更新、删除、运行,以及把接口、单接口测试用例或其他场景的步骤导入当前场景。适合设计「登录→创建资源→查询→断言→清理」等多步骤自动化流程,并处理条件、循环、等待、脚本、数据库操作、外部程序等步骤类型,也用于排查步骤串联失败、变量为空、步骤顺序错误等问题。不适用于仅单接口用例(用 apidog-test-case)、仅运行已有场景或查看报告(用 apidog-test-automation)、或仅配置环境变量与数据库连接。

主要能力与用法:使用前需先阅读 ../apidog-cli/SKILL.md。命令参数以当前 CLI help 为准。一个重要事实是 test-scenario create 只保存元数据,即使载荷含 steps 也不会在创建时写入;正确流程是先创建元数据,再执行 get --with-case-detail 读取完整结构,然后用 import-steps、add-ref 或 test-scenario update --file 添加或修改步骤。已验证的导入入口包括: apidog test-scenario import-steps <scenarioId> --project <projectId> --source endpoint --ids <endpointIds> --sync manual apidog test-scenario import-steps <scenarioId> --project <projectId> --source test-case --endpoint <endpointId> --ids <testCaseIds> --sync manual apidog test-scenario import-steps <scenarioId> --project <projectId> --source test-scenario --from-scenario <sourceScenarioId> --step-ids <stepIds> apidog test-scenario add-ref <scenarioId> --project <projectId> --scenario <sourceScenarioId> 其中 import-steps 复制步骤进当前场景,add-ref 仅添加引用而不复制源场景内部步骤;--sync manual 为默认值,--sync auto 仅适用于 endpoint/test-case 来源。

限制与注意:CLI 命令非交互,缺少 ID 时不会自动列出资源,应先 list/get。编辑既有步骤须基于完整 get --with-case-detail 回读进行,update 不是 JSON Patch。步骤间数据优先用 {{$.1.response.body.token}} 这类原生引用,仅在完整场景运行时有效;脚本中不可直接写 {{...}},应用 pm.variables.get("$.1.response.body.token")。不要假设响应路径固定为 body.data.id,需按真实响应校验。其他细节如环境与变量命令、报告边界、运行/CI 边界,资料指向 environment、variables、database-connection 及 apidog-test-automation。部分具体字段与枚举需查阅对应 schema,暂未提供更多细节。