这个项目能做什么

Vouch是一款金融级工具调用代理，利用SEC文件回答任何美国上市公司的财务问题。它采用双路径架构：精确数字来自基于实时XBRL数据的确定性工具（LLM从不执行财务算术），而叙述性上下文则通过pgvector对10-K、10-Q和8-K文件进行稠密检索获取。输出防护栏会阻止任何无法追溯至来源（XBRL工具或引用的文件段落）的数字，确保系统宁可弃答也不捏造。 关键功能包括获取精确数字（`get_financials`）、标准比率（`get_ratio`）、同比增速（`get_growth`）、自定义公式（`compute_formula`）、完整报表（`get_statement`）、最大/最小行项目、分部/地域细分以及定性搜索的工具。比率和增速采用固定约定计算，以避免LLM常见的选错基准指标错误。已退市或更名的公司按名称解析，而非失效的股票代码。 系统通过三层评估验证：内部CI门控包含84个案例，评分数字依据、引用、弃答和轨迹指标；校准的LLM评判员（忠实度Cohen's κ = 0.76，弃答回答零误报）；以及外部基准测试FinanceBench（Patronus AI），在数字集上实现94%的可处理覆盖率且零捏造率，叙述性依据度达96%。对抗性红队测试将捏造率从11%降至0。 用户可上传自己的财务文件（内部报告、非上市公司），代理通过Docling进行表格单元格提取来回答，并提供单元格级引用（`文件名 · 页码 · 行/列`）。每个文件按用户隔离并限定范围，防止跨文件归因。 部署提供本地服务，包含`/ask`、`/export`、`/upload`端点以及兼容OpenAI的聊天端点。默认模型为o4-mini，系统包含一个未处理指标日志队列，供未来扩展。Vouch基于LangGraph和pgvector构建，复用了早期Slug Advisor项目中的检索和CI评估工程。