ai-business-write/技术文档/测试页面使用指南.md

测试页面使用指南

🎯 概述

测试页面提供了两个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

预期结果

{
  "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

预期结果

{
  "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)"链接。

---

祝测试顺利！ 🎉