87 lines
2.2 KiB
Markdown
87 lines
2.2 KiB
Markdown
# 接口开发说明 - 存量场景优化建议接口
|
||
|
||
## 📋 接口基本信息
|
||
|
||
- **接口路径**: `/api/v1/value/scenario-optimization`
|
||
- **请求方法**: `POST`
|
||
- **接口功能**: 基于存量场景信息和截图，分析场景不足，提供优化建议和改进方向
|
||
- **涉及页面**: `ContextStep.vue` - 生成场景挖掘与优化建议按钮
|
||
- **是否涉及大模型**: ✅ **是**
|
||
- **工作量评估**: 8 人日
|
||
- **优先级**: 中
|
||
|
||
---
|
||
|
||
## 🎯 功能描述
|
||
|
||
该接口使用大模型技术分析存量场景的不足，并提供优化建议，支持：
|
||
1. **图片识别（OCR）**: 如果上传了场景截图，使用 OCR 识别内容
|
||
2. **场景分析**: 分析现有场景的功能和不足
|
||
3. **优化建议**: 提供具体的优化建议和改进方向
|
||
4. **价值提升**: 识别可提升的价值点
|
||
|
||
---
|
||
|
||
## 📥 请求格式
|
||
|
||
```json
|
||
{
|
||
"existing_scenarios": [
|
||
{
|
||
"name": "月度销售经营报表",
|
||
"description": "统计各区域门店的月度GMV，维度单一",
|
||
"image_url": "https://example.com/screenshot.png" // 可选
|
||
}
|
||
],
|
||
"data_assets": [...],
|
||
"company_info": {...}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 📤 响应格式
|
||
|
||
```json
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"optimization_suggestions": [
|
||
{
|
||
"scenario_name": "月度销售经营报表",
|
||
"current_status": "维度单一，仅统计GMV",
|
||
"suggestions": [
|
||
"增加时间维度分析（同比、环比）",
|
||
"增加商品类别维度分析",
|
||
"增加区域对比分析"
|
||
],
|
||
"potential_value": "提升决策支持能力 30%"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 💻 技术实现要点
|
||
|
||
1. **OCR 集成**: 使用 PaddleOCR 识别场景截图
|
||
2. **大模型分析**: 调用大模型分析场景不足
|
||
3. **建议生成**: 基于分析结果生成优化建议
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **图片处理**: 支持常见图片格式（PNG、JPG、JPEG）
|
||
2. **OCR 准确性**: 需要处理 OCR 识别错误的情况
|
||
3. **建议可操作性**: 优化建议必须具体、可执行
|
||
|
||
---
|
||
|
||
## 🔗 相关文档
|
||
|
||
- [接口清单表格](../Python接口清单表格.md)
|
||
- [Python技术人员工作量文档](../Python技术人员工作量文档.md)
|