4.1 KiB
4.1 KiB
AI配置接口测试功能
功能概述
在AI配置管理页面新增了接口测试功能，允许管理员直接在页面上测试AI配置的接口连通性和正确性。
新增功能
1. 测试按钮
- 在AI配置列表的操作列中新增了"测试"按钮
- 点击后打开接口测试对话框
2. 测试对话框
测试对话框分为左右两个区域：
左侧 - 请求配置区域
- 请求URL: 自动根据配置的API基础URL生成，默认为
{apiBaseUrl}/v3/chat - 请求头: JSON格式的请求头，自动包含Authorization和Content-Type
- 请求体: JSON格式的请求体，基于Coze API标准格式生成
右侧 - 响应结果区域
- 状态码: 显示HTTP响应状态码，带颜色标识
- 响应头: 显示服务器返回的响应头信息
- 响应体: 显示服务器返回的响应内容，自动格式化JSON
3. 操作按钮
- 发送测试请求: 发送HTTP请求到配置的API端点
- 格式化请求: 格式化请求头和请求体的JSON格式
- 格式化响应: 格式化响应体的JSON格式
- 复制响应: 将响应内容复制到剪贴板
- 重置: 重置测试数据到初始状态
技术实现
1. 请求构建
基于AiChatServiceImpl中的实现，自动构建符合Coze API标准的请求：
{
"bot_id": "配置的Bot ID",
"workflow_id": "配置的Workflow ID (可选)",
"user_id": "test_user_时间戳",
"stream": false,
"additional_messages": [
{
"role": "user",
"content": "你好，这是一个测试消息，请回复确认接口正常工作。",
"content_type": "text",
"type": "question"
}
]
}
2. 请求头处理
- 自动添加Authorization Bearer Token
- 自动添加Content-Type: application/json
- 支持合并自定义请求头
3. 响应处理
- 显示完整的HTTP状态码
- 显示所有响应头信息
- 自动格式化JSON响应体
- 支持非JSON响应的显示
4. 错误处理
- 网络错误处理
- JSON格式错误提示
- HTTP错误状态码提示
使用方法
1. 打开测试对话框
- 在AI配置列表中找到要测试的配置
- 点击操作列中的"测试"按钮
- 测试对话框自动打开并填充默认数据
2. 自定义测试参数
- 可以修改请求头添加额外的头信息
- 可以修改请求体中的消息内容
- 可以调整其他API参数
3. 发送测试请求
- 点击"发送测试请求"按钮
- 等待请求完成（显示加载状态）
- 查看右侧的响应结果
4. 分析测试结果
- 状态码 200: 请求成功，配置正常
- 状态码 401: 认证失败，检查API Token
- 状态码 400: 请求参数错误，检查Bot ID等配置
- 状态码 500: 服务器错误，联系API提供商
支持的配置类型
1. Coze配置
- 完全支持Coze API的测试
- 自动构建符合Coze标准的请求格式
- 支持Bot ID和Workflow ID
2. 其他配置类型
- 基础的HTTP请求测试
- 可以通过修改请求体适配不同的API格式
安全考虑
1. Token脱敏
- 在请求头显示中，Token会部分脱敏显示
- 实际请求使用完整的Token
2. 跨域处理
- 使用浏览器原生fetch API
- 可能受到CORS策略限制
- 建议在开发环境或配置了CORS的环境中使用
3. 数据隔离
- 测试数据不会影响生产数据
- 使用独立的测试用户ID
故障排除
1. 网络错误
- 检查API URL是否正确
- 检查网络连接
- 检查防火墙设置
2. 认证错误
- 检查API Token是否正确
- 检查Token是否过期
- 检查Token权限
3. 参数错误
- 检查Bot ID是否正确
- 检查Workflow ID是否存在
- 检查请求体格式
4. CORS错误
- 在开发环境中测试
- 或使用支持CORS的代理服务器
后续扩展
1. 批量测试
- 支持批量测试多个配置
- 生成测试报告
2. 测试历史
- 保存测试历史记录
- 支持测试结果对比
3. 自动化测试
- 定时自动测试配置可用性
- 异常告警通知
4. 更多API支持
- 支持OpenAI API测试
- 支持Claude API测试
- 支持其他AI服务商API测试