# 知识库

知识库数据可来自本地上传，或来自 Catalog 中已有的文件和数据表。通过控制台或 `source_selections` 批量选择时，范围仅限 Catalog：选择 `database_tables` 时从一个 Database 选择表，选择 `volume_files` 时从一个 Volume 选择文件。不能用该选择方式接入 Catalog 之外的数据源；Catalog 层级或数据列表加载失败时，当前范围不能选择，修复加载问题后再提交。

对于已添加的数据表，可使用语义条目配置维度、事实、指标、表关联等业务含义，以改善数据问答和 SQL 生成。各个控制台条目名称、对应 API `kind` 及必填配置字段见[创建语义条目](create-semantic-entry.md)。

```{toctree}
:hidden:
:maxdepth: 1

查询知识库列表 <list-knowledge-bases>
查询知识库标签 <list-knowledge-base-tags>
查询知识库详情 <get-knowledge-base>
创建知识库 <create-knowledge-base>
创建数据侧空知识库 <create-empty-knowledge-base>
创建知识库并添加数据源 <create-knowledge-base-with-sources>
更新知识库 <update-knowledge-base>
删除知识库 <delete-knowledge-base>
上传本地文件 <upload-local-file>
创建前上传本地文件 <upload-local-file-before-creation>
查询数据源列表 <list-data-sources>
预览待添加的数据源 <preview-data-sources>
预览创建时的数据源 <preview-initial-data-sources>
检查数据源是否已添加 <check-data-sources-exist>
添加数据源 <add-data-sources>
补齐历史数据源关系 <backfill-legacy-data-sources>
更新数据源治理设置 <update-data-source-governance>
删除数据源 <delete-data-source>
查询文档详情 <get-document>
预览来源原文件 <preview-source-file>
预览解析产物 <preview-processed-artifact>
导入初始分段 <import-initial-segments>
创建分段 <create-segment>
更新分段 <update-segment>
启用或停用分段 <set-segment-enabled>
删除分段 <delete-segment>
重新向量化 <revectorize-data-source>
切换当前分段版本 <set-current-segment-version>
查询数据处理任务 <list-data-processing-jobs>
协调数据处理任务 <reconcile-data-processing-jobs>
查询语义条目 <list-semantic-entries>
创建语义条目 <create-semantic-entry>
更新语义条目 <update-semantic-entry>
删除语义条目 <delete-semantic-entry>
导入语义条目 <import-semantic-entries>
导出语义条目 <export-semantic-entries>
校验语义条目 <validate-semantic-entries>
```