python/finyx_data_frontend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
finyx_data_frontend/docs/api/06-scenario-optimization.md

2.2 KiB
Raw Blame History

接口开发说明 - 存量场景优化建议接口

📋 接口基本信息

  • 接口路径: /api/v1/value/scenario-optimization
  • 请求方法: POST
  • 接口功能: 基于存量场景信息和截图，分析场景不足，提供优化建议和改进方向
  • 涉及页面: ContextStep.vue - 生成场景挖掘与优化建议按钮
  • 是否涉及大模型: ✅ 是
  • 工作量评估: 8 人日
  • 优先级: 中

🎯 功能描述

该接口使用大模型技术分析存量场景的不足，并提供优化建议，支持：

  1. 图片识别（OCR）: 如果上传了场景截图，使用 OCR 识别内容
  2. 场景分析: 分析现有场景的功能和不足
  3. 优化建议: 提供具体的优化建议和改进方向
  4. 价值提升: 识别可提升的价值点

📥 请求格式

{
  "existing_scenarios": [
    {
      "name": "月度销售经营报表",
      "description": "统计各区域门店的月度GMV，维度单一",
      "image_url": "https://example.com/screenshot.png"  // 可选
    }
  ],
  "data_assets": [...],
  "company_info": {...}
}

📤 响应格式

{
  "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. 建议可操作性: 优化建议必须具体、可执行

🔗 相关文档