主题
Parse 接受电子表格作为输入，并把每个工作表作为结果的一页返回。工作表会变成一个保留行列位置的 markdown 表格，因此一个自上而下堆着标题区、假设区与两张预测表的 worksheets，会原样返回成一张可自上而下阅读的网格。input_options.spreadsheet 下的几个控件会改变杂乱表格如何被拆分，以及公式如何求值。
什么时候用它
- 财务模型、预算与预测 —— 单元格取值有意义，而版式并不是单张干净表格的场景。
- 一个 sheet 里纵向堆叠了多张逻辑表、用空行分隔的工作簿。
- 编辑过却从未重算的文件，其中缓存的公式值是陈旧的。
csv、tsv或ods的导出与数据转储，你想让它们与其他内容一样变成 markdown。
支持的输入包括 xlsx、xls、csv、tsv、numbers 与 ods，以及 xlsm、xlsb、dif、sylk、dbf 等，完整清单见支持的文档类型。Excel 示例用的是 agentic 档，对表格密集的文档是很好的默认选择。
选项
| 选项 | 类型 | 默认值 | 作用 |
|---|---|---|---|
input_options.spreadsheet.detect_sub_tables_in_sheets | boolean | 未设 | 在一个 sheet 里找出并抽出多张表，而不是把它们合并。数据区之间用空行或空列分隔时很有用。 |
input_options.spreadsheet.force_formula_computation_in_sheets | boolean | 未设 | 重算公式单元格，而不是用缓存值。编辑过却从未重算的文件、或带占位值的模板应开启。在公式密集的 sheet 上会拖慢解析。 |
input_options.spreadsheet.include_hidden_sheets | boolean | 未设 | 隐藏的工作表也一并解析。默认跳过隐藏表。 |
output_options.save_output_pdf | boolean | 未设 | 保存解析结果的一份 PDF 副本；电子表格、纯文本与音频输入不会产出。 |
这些选项只作用于电子表格输入，其他文件类型会忽略它们。反方向的用法 —— 把 PDF 里发现的表格另存为 XLSX 工作簿 —— 是 output_options.tables_as_spreadsheet，见表格。
示例
从 Excel 示例 下载那份 DCF 模板工作簿：
终端窗口
curl -fL -o dcf_template.xlsx https://eqvista.com/wp-content/uploads/2020/09/Eqvista_DCF-Excel-Template.xlsx上传它、在其上跑一个 Parse 任务，然后打印第二个工作表：
from llama_cloud import LlamaCloud
client = LlamaCloud() # reads LLAMA_CLOUD_API_KEY from the environment
file = client.files.create(file="./dcf_template.xlsx", purpose="parse")
result = client.parsing.parse(
file_id=file.id,
tier="agentic",
version="latest",
input_options={
"spreadsheet": {
"detect_sub_tables_in_sheets": True,
"force_formula_computation_in_sheets": True,
}
},
expand=["markdown"],
)
# One result page per sheet, in workbook order; page_number 2 is the second sheet
second_sheet = next(p for p in result.markdown.pages if p.success and p.page_number == 2)
print(second_sheet.markdown)你会拿到什么
一个 sheet 的 markdown 就是一张竖线表，列与 sheet 的列一一对应，空单元格保持为空。这段摘录是 Excel 示例 里那份 DCF 模板的第二个工作表，它在同一个 sheet 里堆着说明区、假设区与一张预测表：
|Discounted Cash Flow Excel Template||||||||||||
|-|-|-|-|-|-|-|-|-|-|-|-|
|Assumptions||||||||||||
|Tax Rate|20%|||||||||||
|Discount Rate|15%|||||||||||
|||||||||||||
||5 Year Weighted Moving Average|||||||||||
||Year 1|Year 2|Year 3|Year 4|Year 5|Year 6|Year 7|Year 8|Year 9|Year 10|Terminal Value|
|Pre-tax income|50,000.00|55,000.00|45,000.00|52,000.00|60,000.00|||||||
|Net Cash Flow|20,000.00|27,000.00|23,000.00|29,600.00|35,000.00|29,093.33|29,817.78|30,177.48|30,469.23|30,379.74|287,188.00|
|Discounting Factor||||||0.8696|0.7561|0.6575|0.5718|0.4972|0.4972|由于整个 sheet 就是一张网格，把这些页拼接后作为提示词交给模型，就足以回答诸如“哪些年份的所得税等于税前收入的 20%”这类问题。Excel 示例结尾做的正是这件事：在解析出的 markdown 上跑一小步问答。
另请参阅
- 解析并分析 Excel 电子表格：Python、TypeScript、Go、Java 与 CLI 的完整示例，含可选的问答步骤
- 配置 Parse：电子表格
- 支持的文档类型：Parse 接受的全部电子表格格式
- 表格：从 PDF 与扫描件得到的表格输出，含 XLSX 导出