哈喽,我是 Raina~
之前我们分享过一套 AI 驱动接口自动化 方案:基于 JSON 编排实现接口链路串联,代码框架封装在 Skill 里,比较适合代码基础薄弱、希望快速落地接口自动化的同学。
但在企业真实场景里,还有一类更普遍的需求:
团队已经有自己搭建好的接口自动化框架,日常以增量方式新增接口用例,而不是每次从零生成一套工程。
这类同学往往不需要 Excel / JSON 编排那一套,而是希望 AI 能直接生成 pytest 用例代码,并且不破坏现有工程结构——在原有框架上「加文件、加用例」就行。
那么,能不能在原有方案基础上,补上「接口依赖可视化 + 增量代码生成」这两块能力?
针对这些新痛点,我AI驱动接口自动化方案做了一次重要升级,今天这篇给大家分享下思路和效果。
一、核心作用:
- ✅ 新增知识图谱 Skill:把接口依赖关系可视化,同时产出给 AI 读的 Markdown 关系数据
- ✅ 重构生成逻辑:从 Excel / JSON 读取模式,改为直接生成 pytest 用例代码
- ✅ 新增 Bug 修复 Skill:执行报错时,把日志丢给 AI,自动分析并给出修复方案
*
二、Skill介绍
整套方案现在由 6 个 Skill 串联:
执行流程:
 text 接口文档(已有 / 代码扫描生成) → 知识图谱(HTML 可视化 + MD 关系数据) → 测试计划(md,含串联场景 / 前置依赖 / 待澄清项) → pytest 代码生成(增量写入现有框架 / 无框架则新建) → 执行 & Allure 报告 → (可选)Bug 修复 Skill
以上 Skill 包已整理在【Raina的AI&测试实战圈】,Cursor、Claude Code 等 AI 工具均可导入使用。
*
三、案例实践流程
1、生成接口文档(可选)
操作思路和之前方案一样:用 api-doc-generator 读取源码自动生成接口文档。先拉取项目代码到本地,把 Skill 放到项目目录下执行即可。
详细操作可参考往期文章《利用AI辅助接口自动化测试,90% 的人都卡在了第一步》,这里不重复展开。
2、生成知识图谱
支持两种方式,一种是提供接口文档/swagger,第二种直接阅读项目源码进行生成
案例一:基于接口文档进行生成
输出结果
skill 会从接口文档或后端源码推断接口之间的关系,生成一份给人看的 HTML 知识图谱,以及一份给后续 AI 读的 Markdown 关系数据,如下:
知识谱图html效果:
案例二:检索代码生成知识图谱
执行skill
效果如下:
#### 知识图谱作用:
例如你点击一个工单的接口,它能够看到工单所关联的接口的关系、接口的参数,依赖、契约关系、消费、调用顺序等等。
有了这份接口知识图谱,我们就能快速查询任意接口和其他接口之间的关联关系。
还有一个很关键的用处:可以把图谱提供给 AI,让 AI 掌握接口之间的依赖关联,在接口自动化场景里,快速完成带接口依赖场景的脚本编排。
3、测试计划生成
输入:
发送之后,AI会根据接口文档和知识谱图的内容做分析,并且输出一些问题,让你进行澄清,最后再生成一份计划文档(md文件)
#### 生成效果:
第一部分是总览,例如我的这边只需要生成串联的方式,总共就有8条用例
前置依赖,哪些接口需要抽取出来做复用
串联场景,这里内容太多,我就不全部都截图出来了
重点是看它的步骤,例如这个案例,从新增、查询、修改都进行了串联,且参数也进行了传递
4、代码生成
输入:
发送指令后,AI 会先检测当前工作区是否存在接口自动化代码框架:
- 已有框架:自动分析现有项目结构,在原有框架基础上新增代码,不破坏原有工程
- 无框架:自动新建
tests目录,直接生成全套自动化代码
默认会使用预设代码结构;如果有定制化需求,可以修改 Skill 内的模板结构
5、代码执行&报告查看
执行代码
执行结果如下:
且默认会启动allure报告,可以看到内部的操作逻辑和执行日志
6、bug 修复skill
这里也提供了一个bug修复skill
执行过程中如果出现报错,你可以直接把失败日志复制给 AI。AI 会分析报错原因,给出对应的代码修改建议;等你确认方案后,再对问题进行修复。 这里就不单独演示案例了,大家遇到 bug 可以直接上手实操体验这个 Skill。