财报分析助手如何保留数据依据真正困难的通常不是完成一次 API 调用而是让结果可以校验、失败可以定位、后续能够回到原始证据。本文围绕“如何把 A 股基础信息、财务报表、业绩和资金流组织成可复核的财报分析流程”给出一套可以直接落到任务状态和数据契约上的实现方式。问题与结果原始指标、计算口径和 AI 解读分别存储报告观点能够回到具体报表期和数据字段。最终交付不是一段不可追溯的模型回答而是一组带来源、版本、状态和失败记录的数据。这样既方便接入后续系统也能在接口、页面或模型输出变化时定位问题。适用场景财报季公司跟踪投研资料初步整理财务指标异常提醒实现前先确定边界证券代码、报告期和公告日期必须同时记录原始报表与派生指标分层缺失值不得自动补零AI 解读不得写成投资结论可验证工作流API 编排与职责数据层接口请求方式用途公司基础信息A 股个股信息查询GET获取公司基础资料和证券信息财务报表A 股历年三大财务报表GET获取资产负债、利润、现金流等历史数据业绩数据A 股业绩报表数据GET获取业绩披露数据资金流A 股个股资金流GET观察市场资金变化智能解读A 股财报 AI 智能解读POST生成财报解读文本最小可运行实现curl -G https://api.gugudata.com/stock/cn/fundamentalinfo \ --data-urlencode appkeyYOUR_APPKEY \ --data-urlencode symbol600519curl -X POST https://api.gugudata.com/ai/stock-financial-report-analysis \ -H Content-Type: application/json \ -d { appkey: YOUR_APPKEY, symbol: 600519, startYear: 2020, includeNews: true, includeFundFlow: true, language: zh-CN }在服务端可以把多个接口结果合并成一个分析上下文def build_research_context(profile: dict, finance: dict, cash_flow: dict) - dict: Build a compact context for a financial research agent. return { company: profile.get(companyName), industry: profile.get(industry), latestFinance: finance, cashFlow: cash_flow, }输出建议一个可读的投研摘要可以分成四段段落内容公司画像公司名称、行业、主营业务和证券信息财务变化收入、利润、现金流等关键变化市场行为资金流或行情相关观察风险提示数据更新时间、异常值、仍需人工判断的事项失败分类与降级股票代码不存在、接口无数据或财报期数不完整时Agent 应返回“数据不足”而不是补写不存在的趋势。资金流数据也不应被单独解释为投资建议它只适合作为观察指标之一。工程化注意事项文章和产品输出都要避免写成投资承诺重点是公开数据整理和辅助分析。每个结论都保留来源接口和查询参数方便复核。财报类接口适合异步任务避免用户等待过久。对异常波动设置人工复核流程不让 Agent 自动发布高风险结论。数据契约与留痕建议至少保存以下字段真实项目可以继续拆分但不要删除来源、版本和状态信息。字段作用symbol业务数据字段保存时记录来源、口径和缺失状态report_period业务数据字段保存时记录来源、口径和缺失状态announcement_date带时区的采样或生成时间判断数据新鲜度raw_statements原始来源或原始响应供后续复核derived_metrics业务数据字段保存时记录来源、口径和缺失状态cashflow业务数据字段保存时记录来源、口径和缺失状态analysis_version规则、输入或产物版本变更时保留旧版本所有派生结果都应带生成时间和输入版本。发生重试时新增尝试记录不要覆盖最后一次失败以免排查时只剩“最终成功”而看不到中间问题。验收清单同一指标能追溯到原报表字段跨期比较使用一致口径报告包含数据时间与风险声明能力边界内容仅用于公开数据整理和技术实现说明不构成投资建议也不保证数据实时性。示例中的YOUR_APPKEY仅为占位符。真实密钥只能放在服务端环境变量或密钥管理系统中不应进入前端、文章、日志或版本库。
