204 lines
4.5 KiB
Markdown
204 lines
4.5 KiB
Markdown
# 测试页面使用指南
|
||
|
||
## 🎯 概述
|
||
|
||
测试页面提供了两个API接口的可视化测试功能：
|
||
1. **AI解析接口** - 从非结构化文本中提取结构化字段
|
||
2. **文档生成接口** - 根据字段数据填充Word模板并生成文档
|
||
|
||
---
|
||
|
||
## 📋 功能说明
|
||
|
||
### 1. AI解析接口测试
|
||
|
||
#### 功能描述
|
||
使用AI大模型从输入文本中提取结构化字段数据。
|
||
|
||
#### 使用步骤
|
||
|
||
1. **切换到"AI解析接口"标签页**
|
||
- 点击页面顶部的"AI解析接口"标签
|
||
|
||
2. **添加输入字段**
|
||
- 输入字段编码（如：`clue_info`）
|
||
- 输入字段值（原始文本）
|
||
- 可以添加多个输入字段
|
||
- 点击"+ 添加输入字段"添加更多
|
||
|
||
3. **添加输出字段**
|
||
- 输入需要提取的字段编码（如：`target_name`）
|
||
- 可以添加多个输出字段
|
||
- 点击"+ 添加输出字段"添加更多
|
||
|
||
4. **开始解析**
|
||
- 点击"开始解析"按钮
|
||
- 等待AI处理（可能需要一些时间）
|
||
- 查看解析结果
|
||
|
||
#### 示例数据
|
||
|
||
**输入字段：**
|
||
```
|
||
字段编码: clue_info
|
||
字段值: 被举报用户名称是张三，年龄30岁，某公司总经理，男性，1980年5月出生，中共党员，正处级
|
||
```
|
||
|
||
**输出字段：**
|
||
```
|
||
target_name
|
||
target_gender
|
||
target_organization_and_position
|
||
```
|
||
|
||
#### 预期结果
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"data": {
|
||
"outData": [
|
||
{
|
||
"fieldCode": "target_name",
|
||
"fieldValue": "张三"
|
||
},
|
||
{
|
||
"fieldCode": "target_gender",
|
||
"fieldValue": "男"
|
||
},
|
||
{
|
||
"fieldCode": "target_organization_and_position",
|
||
"fieldValue": "某公司总经理"
|
||
}
|
||
]
|
||
},
|
||
"isSuccess": true
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 2. 文档生成接口测试
|
||
|
||
#### 功能描述
|
||
根据字段数据填充Word模板，生成填充后的文档并上传到MinIO。
|
||
|
||
#### 使用步骤
|
||
|
||
1. **切换到"文档生成接口"标签页**
|
||
- 点击页面顶部的"文档生成接口"标签
|
||
|
||
2. **添加字段数据**
|
||
- 输入字段编码（如：`target_name`）
|
||
- 输入字段值（如：`张三`）
|
||
- 可以添加多个字段
|
||
- 点击"+ 添加字段"添加更多
|
||
|
||
3. **添加文件配置**
|
||
- 输入文件ID（如：`1`）
|
||
- 输入文件名称（如：`初步核实审批表.doc`）
|
||
- 输入模板编码（如：`PRELIMINARY_VERIFICATION_APPROVAL`）
|
||
- 可以添加多个文件
|
||
- 点击"+ 添加文件"添加更多
|
||
|
||
4. **生成文档**
|
||
- 点击"生成文档"按钮
|
||
- 等待文档生成和上传（可能需要一些时间）
|
||
- 查看生成结果
|
||
|
||
#### 示例数据
|
||
|
||
**字段数据：**
|
||
```
|
||
target_name: 张三
|
||
target_gender: 男
|
||
target_organization_and_position: 某公司总经理
|
||
```
|
||
|
||
**文件配置：**
|
||
```
|
||
文件ID: 1
|
||
文件名称: 初步核实审批表.doc
|
||
模板编码: PRELIMINARY_VERIFICATION_APPROVAL
|
||
```
|
||
|
||
#### 预期结果
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"data": {
|
||
"documentId": "DOC202411260001",
|
||
"documentName": "初步核实审批表_张三.docx",
|
||
"fpolicFieldParamFileList": [
|
||
{
|
||
"fileId": 1,
|
||
"fileName": "初步核实审批表.doc",
|
||
"filePath": "/202511261123/初步核实审批表.doc"
|
||
}
|
||
]
|
||
},
|
||
"isSuccess": true
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
### AI解析接口
|
||
|
||
1. **字段编码必须正确**
|
||
- 字段编码需要与数据库中的配置一致
|
||
- 可以使用数据库中已有的字段编码
|
||
|
||
2. **输出字段必须存在**
|
||
- 输出字段必须在数据库中已配置
|
||
- 如果字段不存在，可能无法提取
|
||
|
||
3. **AI服务配置**
|
||
- 需要配置 `SILICONFLOW_API_KEY` 在 `.env` 文件中
|
||
- 如果未配置，解析将失败
|
||
|
||
### 文档生成接口
|
||
|
||
1. **模板编码必须正确**
|
||
- 模板编码需要与数据库中的文件配置一致
|
||
- 必须使用 `template_code` 字段的值
|
||
|
||
2. **MinIO配置**
|
||
- 需要配置MinIO连接信息
|
||
- 模板文件必须存在于MinIO中
|
||
|
||
3. **字段值匹配**
|
||
- Word模板中的占位符需要与字段编码匹配
|
||
- 未匹配的占位符将保持为空
|
||
|
||
---
|
||
|
||
## 🔗 相关链接
|
||
|
||
- **Swagger API文档**: http://localhost:7500/api-docs
|
||
- **测试页面**: http://localhost:7500/
|
||
|
||
---
|
||
|
||
## 📝 常见问题
|
||
|
||
### Q: 解析接口一直加载怎么办？
|
||
A: 检查AI服务配置是否正确，查看浏览器控制台是否有错误信息。
|
||
|
||
### Q: 文档生成失败？
|
||
A:
|
||
1. 检查模板编码是否正确
|
||
2. 检查MinIO配置和连接
|
||
3. 检查模板文件是否存在于MinIO
|
||
|
||
### Q: 如何查看详细的接口文档？
|
||
A: 点击页面底部的"查看完整的API文档 (Swagger)"链接。
|
||
|
||
---
|
||
|
||
**祝测试顺利！** 🎉
|
||
|