后台管理功能开发，AI配置管理

2025-10-30 14:50:44 +08:00
parent dc0413d084
commit 8b6e3d0815
23 changed files with 4463 additions and 4 deletions
@@ -0,0 +1,157 @@
+# 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标准的请求：
+
+```json
+{
+  "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. 打开测试对话框
+1. 在AI配置列表中找到要测试的配置
+2. 点击操作列中的"测试"按钮
+3. 测试对话框自动打开并填充默认数据
+
+### 2. 自定义测试参数
+- 可以修改请求头添加额外的头信息
+- 可以修改请求体中的消息内容
+- 可以调整其他API参数
+
+### 3. 发送测试请求
+1. 点击"发送测试请求"按钮
+2. 等待请求完成（显示加载状态）
+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测试