requirements-analysis.md 8.3 KB

财顾报告Agent MVP 需求分析文档

分析依据:

  • 《财顾报告智能化生成产品MVP版本需求文档.md》
  • 《财顾报告Agent-技术架构与选型.md》
  • 《财顾报告生成智能体后端及算法端功能模块描述及其实现思路.md》

1. 背景与目标

1.1 建设背景

本项目拟建设财务顾问报告智能生成系统,以MVP(最小可行产品)方式优先验证核心链路可行性。系统服务于财务顾问主服务报告的智能化撰写支持,覆盖项目融资、资产管理、并购重组三类报告类型。

1.2 本期目标

  1. 验证报告智能生成主链路可跑通:从任务发起到结果输出的最短业务闭环
  2. 验证结构化生成方式有效性:采用"大纲生成→数据准备→报告生成"三阶段执行机制
  3. 验证知识单元驱动设计:以知识单元作为最小执行对象,支撑大纲决策、数据准备和段落生成
  4. 形成可演示原型:页面可操作、流程可执行、结果可展示

2. 用户角色与关键场景

2.1 用户角色(本期简化)

本期MVP阶段用户按单一业务角色设计,不区分客户经理、审批支持人员、运维人员等:

角色 职责描述
业务人员 发起任务、录入信息、大纲确认、数据补录、结果查看与导出

2.2 关键场景

场景1:任务发起

  • 选择报告类型(项目融资/资产管理/并购重组)
  • 录入客户及项目基础信息
  • 上传辅助材料(Excel模板,RAG召回使用)

场景2:大纲生成与确认(核心控制环节)

  • 系统生成一级章节结构及知识单元数量分配
  • 逐章生成末级知识单元清单
  • 业务人员在树状结构中进行勾选/取消勾选/顺序调整
  • 受控生成:不允许自由新增未配置内容

场景3:数据准备与补录

  • 系统按知识单元调用数据处理逻辑
  • 展示自动获取结果(API接口/指标平台/RAG召回)
  • 业务人员进行文本补录
  • 确认数据准备完成

场景4:报告生成与导出

  • 系统逐知识单元生成段落内容
  • 按大纲顺序拼接完整报告
  • 在线查看与导出DOCX/PDF

3. 需求清单(P0/P1/P2)

3.1 P0需求(本期必须交付)

模块 需求项 优先级 验收标准
任务管理 创建报告任务 P0 支持三类报告类型选择,必填字段校验通过
任务管理 保存任务输入信息 P0 结构化保存客户、项目、业务要素信息
大纲生成 一级大纲生成 P0 根据协议金额、企业类型等生成一级章节结构
大纲生成 二级大纲生成 P0 按一级章节逐一生成知识单元清单
大纲确认 树状结构展示 P0 展示模型默认选中状态,支持勾选/取消/排序
大纲确认 受控调整 P0 仅在预置知识体系范围内调整,禁止新增
数据准备 多源数据获取 P0 支持API接口、指标平台、RAG三类数据源
数据准备 按知识单元组织 P0 数据结果与知识单元一对一绑定
数据确认 结果展示 P0 展示自动获取结果,支持文本补录
报告生成 逐段生成 P0 按知识单元逐个调用模型生成段落
报告生成 顺序拼接 P0 按大纲顺序拼接为完整报告
结果展示 在线查看 P0 按章节段落结构展示报告内容
结果展示 文档导出 P0 支持导出标准格式文档(DOCX)
状态管理 任务状态流转 P0 9个状态正常流转,状态控制页面行为

3.2 P1需求(本期酌情开发)

模块 需求项 优先级 说明
大纲确认 版本记录 P1 记录确认人、确认时间、与模型草稿差异
数据确认 批量确认 P1 支持知识单元批量确认
报告生成 进度展示 P1 实时展示生成进度
结果展示 章节导航 P1 左侧章节树快速定位
后台预置 知识体系初始化 P1 项目融资类知识体系预置数据

3.3 P2需求(本期不做,预留扩展)

模块 需求项 优先级 说明
配置端 知识体系配置页面 P2 在线新增/修改/删除知识单元
配置端 数据资源配置页面 P2 在线配置接口参数映射
报告编辑 段落级重生成 P2 单段内容重新生成
报告编辑 在线精细编辑 P2 富文本编辑器在线修改
协同 多人协同编辑 P2 多人协作与审核流转
权限 精细角色权限 P2 分角色权限控制体系

4. 验收标准

4.1 功能验收

验收项 验收标准
任务创建 必填字段缺失时给出明确提示;创建成功后生成任务ID
大纲生成 一级大纲返回JSON结构,包含chapter_results和overall_logic;二级大纲返回完整章节编号树
大纲确认 树状展示响应时间<2s;勾选/取消操作即时生效;确认后生成最终知识单元清单
数据准备 每个知识单元数据获取<10s;失败时给出明确错误提示
报告生成 单段生成<30s;整篇报告生成可接受异步处理
结果导出 DOCX导出格式符合行内报告规范

4.2 业务验收

验收项 验收标准
生成稳定性 10次相同输入的大纲生成,结构一致性>80%
内容可用性 生成报告经业务老师评估,可直接使用或少量修改即可使用
可控性 大纲确认、数据确认两个卡点有效降低模型输出风险

5. 范围边界(本期不做)

5.1 明确排除范围

  1. 完整知识配置端:不建设在线知识体系维护页面,通过后台预置实现
  2. 完整数据资源配置端:不建设在线接口配置页面,通过代码绑定实现
  3. 段落级编辑与重生成:不支持单段重跑、在线逐段编辑、多版本对比
  4. 精细角色权限:本期统一按"业务人员"处理
  5. 复杂协同流程:不支持多人协同、审批流转、操作留痕追踪

5.2 简化实现内容

能力 简化方式
知识体系配置 数据库初始化脚本维护
数据资源绑定 代码或配置文件绑定
大纲调整 仅支持勾选/取消/排序,不支持自由新增改写
数据编辑 仅支持查看+文本补录,不支持复杂结构化编辑
结果处理 仅支持查看与导出,不支持富文本在线编辑

6. 风险与待确认

6.1 已知风险

风险项 风险等级 应对措施
模型输出不稳定 通过大纲确认、数据确认两个卡点控制;分段生成降低单次调用复杂度
知识单元配置工作量大 MVP阶段聚焦项目融资类报告;采用后台预置方式减少配置端开发
行内接口集成复杂度 早期识别接口依赖,预留联调时间;准备Mock数据
生成时间较长 长耗时阶段采用MQ异步化;提供进度反馈

6.2 待确认事项(TBD)

序号 待确认项 影响范围 建议处理
TBD-1 行内SSO对接方式 接入层 待与行内安全团队确认
TBD-2 模型集群访问方式 算法端 待与模型平台团队确认
TBD-3 工商/风险接口具体规格 数据准备 待与数据提供方确认
TBD-4 导出文档格式详细规范 结果展示 待与业务老师确认
TBD-5 租户隔离级别要求 整体架构 待与运维团队确认
TBD-6 OSS存储桶命名规范 文件存储 待与基础设施团队确认

7. 附录:核心术语表

术语 说明
知识单元 大纲最末级节点,对应一个最终输出段落
单元呈现型 每次执行生成一个固定段落的知识单元类型
批次处理型 针对多个对象重复生成相同结构段落的知识单元类型
外部获取型 通过外部渠道直接获取分析结果的知识单元类型
四级模板 信息陈述型、对象分析型、指标数据描述型、综合判断型

文档版本:MVP阶段 最后更新:2026-03-31