Files
opsxapi/apps/server/internal/docs/content/17-ai.md
T
logan 1bcd7be2ac AI 大模型接入 + 自动化测试(手动/AI/定时三种触发)
- 自动化测试核心(packages/core/src/testing.ts):
  - JSONPath 求值($.a.b[0].c)、断言评估(状态码/耗时/Header/Body × 10 种操作)
  - 变量提取(响应 → 当前环境,{{var}} 链式传值)、Markdown 报告导出
- 用例模型:场景用例 = 有序步骤(引用 HTTP 接口 + 断言 + 提取),失败后继续可选
- 执行器 testRunner + 定时调度器 scheduler(应用运行期间按间隔自动执行)
- TestingView:用例列表 / 步骤编排 / 断言与提取编辑器 / 报告(统计卡+断言明细+过滤+再次运行+导出)
- AI 助手:OpenAI 兼容客户端(DeepSeek/智谱/Kimi/OpenAI/Ollama 预设)
  - 设置 → AI 助手:供应商 CRUD + 测试连接 + 当前使用切换
  - AI 生成场景用例:读取集合接口清单 → 编排步骤/断言/提取 → 预览保存
- 入口:侧栏底部「自动化测试」+ ⋯ 菜单;文档新增 /docs/testing /docs/ai
- 新增 11 个引擎单测(总 48 前端用例全绿);本地 E2E:运行通过+断言通过+petId 提取验证
2026-09-18 01:57:57 +08:00

2.2 KiB
Raw Blame History

AI 助手

接入 OpenAI 兼容协议的大模型,为接口调试与自动化测试提供 AI 能力。密钥只保存在本机(localStorage),请求直连供应商,不经过任何第三方中转。

配置模型供应商

设置 → AI 助手 → 模型供应商,点「添加供应商」,内置常用预设:

供应商 Base URL 模型示例
DeepSeek https://api.deepseek.com/v1 deepseek-chat
智谱 GLM https://open.bigmodel.cn/api/paas/v4 glm-4-flash
Moonshot Kimi https://api.moonshot.cn/v1 moonshot-v1-8k
OpenAI https://api.openai.com/v1 gpt-4o-mini
Ollama 本地 http://127.0.0.1:11434/v1 qwen2.5:7b
  • API Key:Ollama 等本地服务可留空;
  • 测试连接:保存前先发一条 ping 验证地址 / 密钥 / 模型名;
  • 多个供应商时可切换「当前使用」的模型。

AI 生成场景用例

自动化测试视图 →「AI 生成」:

  1. 选择集合(AI 读取其中全部 HTTP 接口:方法、URL、Body 示例);
  2. 可选填写一句要求,如「覆盖下单 → 支付 → 查询流程,重点断言金额字段」;
  3. 模型按业务依赖编排步骤,输出断言与变量提取(如 $.data.token → token,后续步骤用 {{token}});
  4. 预览生成的步骤清单(未识别的接口会自动跳过并提示),确认后保存为正式用例。

生成结果只是起点 —— 步骤、断言、提取规则都可再手动调整。

隐私与边界

  • API Key 仅存本机,随工作区数据一起持久化;导出全量备份时会包含,分享备份文件前请注意;
  • 供应商收到的内容为接口清单摘要(方法 / URL / Body 片段)与你的指令,不含环境变量值与 API Key;
  • 未配置供应商时,Mock 数据、环境变量等离线功能不受影响。

常见问题

生成失败? 依次检查:Base URL 是否带 /v1、模型名是否属于该供应商、Key 是否有效(用「测试连接」验证)、本机能否直连该域名(内网代理环境注意放行)。

想用公司内网模型? 添加自定义供应商,Base URL 填内网网关地址即可(需兼容 OpenAI Chat Completions 协议)。