什么是表格格式知识库？
表格格式知识库是百数知识库里专门存放结构化业务数据的类型：销售报表、产品价格表、人员名单、台账清单、参数表等 Excel/CSV 文件都可以传进来。和文本知识库按语义「找段落」不同，表格知识库让智能体能像查数据库一样对行做查询、筛选、统计和数值计算，背后用的是 NL2SQL------用户用大白话提问，系统自动转成查表格的语句。
为什么不直接把 Excel 传到文本知识库里？
| 对比维度 | 文本知识库传 Excel | 表格格式知识库 |
|---|---|---|
| 识别方式 | 把表格当一大段文字切分 | 识别行列结构，按列理解 |
| 查「某产品价格」 | 可能召回一段带数字的文字，不一定准 | 精确定位到那一行那一列 |
| 统计「共多少条」「总价多少」 | 做不了 | 支持 count、sum、平均值等聚合 |
| 筛选「华东区所有客户」 | 靠语义猜 | 按条件精确过滤行 |
| 字段类型 | 全是文本 | 区分文本/整数/数值/时间，才能算数 |
功能说明
表格格式知识库适用于结构化业务数据，如销售报表、人员信息、台账清单等，支持自定义表结构或通过上传表格文件快速创建知识库。
入库后智能体支持对表格数据做查询、筛选、统计、数值计算。
创建流程
创建完 表格格式 的知识库后，进入知识库详情页，添加内容。
支持2种方式：本地文档和自定义。
本地文档方式
是将电脑本地文档导入知识库。
创建步骤如下：
1）上传文件，支持Excel或CSV格式的文档，文件大小限制20MB以内。
上传前把表格整理成这样，入库最稳：
-
第一行就是表头（列名），不要有合并单元格、大标题、备注行；
-
一列只放一种含义：不要把「产品名」和「规格」塞在同一列；
-
数字列保持纯数字，不要带「约」「左右」「元」这种混排单位；
-
单个文件 ≤20MB；超量请拆表或分批追加。
2）表结构配置
在表格知识库上传文件后，进入表结构配置环节。
- 基础设置：选择数据表，指定表头行 （字段名称所在行）、数据起始行（真实业务数据从哪一行开始读取）。
- 字段配置：对每一列进行定义：
- 列名：表格字段名称；
- 描述：补充字段含义，辅助智能体理解业务；
- 数据类型：String文本、Integer整数、Number数值等
数据类型怎么选？选错了会影响统计：
| 数据类型 | 用于哪类列 | 举例 |
|---|---|---|
| String 文本 | 名称、编号、描述、地址等不可计算内容 | 产品名、客户名、订单号 |
| Integer 整数 | 数量、个数、年份等整数 | 库存数、员工人数 |
| Number 数值 | 带小数的金额、单价、比率 | 价格、折扣率、销售额 |
| Time 时间 | 日期、时间戳 | 下单时间、入职日期 |
3）预览
预览上传文件，在正式执行数据处理前，查看解析出来的原始表格内容。
可以核对表头、数据行是否识别正确，检查单元格文字、数字有没有乱码、错位、内容丢失，确认行列划分是否和业务表格一致。如果解析异常，可返回调整表结构配置，避免错误数据入库。
4）数据处理
完成预览确认无误后，进入数据处理阶段。
系统将依据已配置的表结构规则，对表格数据做解析、类型转换、入库索引构建；会把单元格内容按照定义的数据类型（String、Integer、Number）进行转换校验。处理完成后，表格数据正式存入知识库，智能体才能够查询、筛选、统计表格内的业务数据。
5）内容预览：
数据处理任务执行完毕后，可打开知识库查看数据详情，对已入库的数据进行复核，检验内容、格式是否符合业务预期。若存在需要调整的内容，可重新编辑修改。
注意：
在同一个表格知识库（同一张数据表）追加上传新文件时，表头（列名）必须和当前数据表已配置的表结构完全一致，列名、列数量需要匹配，同时单元格数据类型也要符合预先设置，否则导入校验失败，无法完成数据处理。
如果新文件表头不一样，有两种方案：①新建独立表格知识库；②修改源文件表头，对齐现有数据表结构后再上传。
字段描述为什么一定要填？
字段描述是写给 AI 看的业务说明书。列名可能叫「状态」，AI 不知道是订单状态还是发货状态；在描述里写清「1=待付款 2=已付款 3=已发货」，NL2SQL 才能把用户的自然语言准确翻译成查询条件。
自定义方式
选择自定义方式，创建步骤如下：
1）自定义表结构
自定义添加字段，点击【增加字段】，录入列名 、补充字段描述 ，并选择匹配的数据类型（String 文本、Time 时间等）。可按需新增、删除字段，完成整张数据表结构的自定义定义，用于匹配业务表格的字段，为后续文件解析、数据入库提供结构规则。
知识库添加内容
表格知识库支持后续追加数据，使用文件导入或自定义表结构的方式创建表格知识库后，可继续向当前知识库添加新的数据记录，实现数据增量维护。
支持两种录入方式：手动新增单条记录，或是导入本地文件批量上传数据。
上传文件：导入的文件表头需要与现有表格结构保持一致。
上传符合规范的文档后，跟随页面指引完成操作，即可完成数据追加。
操作步骤与前文的知识库创建流程基本一致。
手动新增单条记录
常见问题 FAQ
Q1：表格知识库支持什么格式？多大？
A：Excel 或 CSV，单文件 ≤20MB。
Q2：什么叫 NL2SQL？
A：Natural Language to SQL，用户用大白话问「华东区销售额最高的三个客户」，系统自动转成对表格的查询语句，不用人工写 SQL。
Q3：为什么追加文件会导入失败？
A：同一张表追加数据时，列名、列数、列顺序、数据类型必须和首次配置完全一致。新文件表头不同就新建一个知识库，或改源文件对齐后再传。
Q4：智能体查表格时算错了，怎么排查？
A：先看字段类型------价格列是不是被识别成了文本（文本不能求和）；再看字段描述有没有写清业务含义；最后在预览里核对数据有没有错位。
Q5：能只上传一部分列吗？
A：建议只保留查询需要的列。多余列会干扰 NL2SQL 选字段，也增加 Token 消耗。
Q6：表格知识库和文本知识库能一起挂吗？
A：可以。文本知识库答「为什么」「怎么用」，表格知识库答「是多少」「有哪些」，两者互补。
上线前检查清单
□ 第一行是表头，没有合并单元格和备注行吗？
□ 每列数据类型选对了吗？金额用 Number、数量用 Integer、时间用 Time？
□ 每个字段都写了业务描述吗？
□ 预览里表头、数据行、数字格式都识别正确？
□ 后续追加的文件表头是否和首次完全一致？
核心概念术语表
| 术语 | 一句话解释 |
|---|---|
| 表格知识库 | 存放 Excel/CSV 结构化数据的知识库，支持按行查询和统计 |
| NL2SQL | 自然语言自动转 SQL，让用户用大白话查表格 |
| 表头行 | 列名所在的那一行，系统靠它理解每列是什么 |
| 数据起始行 | 真实业务数据从哪一行开始读，跳过标题和说明行 |
| 字段类型 | 列的数据类型：String/Integer/Number/Time，决定能否计算 |
| 字段描述 | 写给 AI 看的业务说明，帮助它正确翻译查询意图 |
| 追加数据 | 在已有表格知识库里继续加行，表头必须一致 |
| 数据处理 | 系统按表结构解析、类型转换、建索引的过程 |
元信息
适用产品：百数AI 知识库 / 表格格式｜支持格式 Excel、CSV｜单文件 ≤20MB｜能力：查询、筛选、统计、NL2SQL｜文档更新时间：2026-09