# 管理数据源和文档

向已有知识库添加、预览、查询或删除数据源，并查看相应文档和处理产物。本页不创建知识库本身，也不修改分段内容。

## 前提条件

准备可访问目标工作区的凭据和目标知识库标识。有关服务地址、认证和通用请求格式，请参阅 [调用前准备](../../api-call-basics.md)。

如果数据来自本地文件，先选择与创建时机对应的上传动作；文件上传成功不等于数据源已经加入知识库。

## 调用顺序

1. 先[查看数据列表](../../../../reference/api/ai-studio/resource-center/knowledge-bases/list-data-sources.md)，确认目标知识库中的已有数据源。
2. 需要上传本地文件时，按是否处于知识库创建前选择上传动作，并保留动作页返回的文件或数据源信息。
3. 添加前使用预览动作检查待添加的数据源；确认后再[添加数据](../../../../reference/api/ai-studio/resource-center/knowledge-bases/add-data-sources.md)。
4. 添加后查询数据源、文档或解析产物，确认可查看的结果；需要移除时，使用目标数据源标识删除。

## API 操作

### 上传、预览和添加数据源

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建前上传本地文件 | [创建知识库前上传本地文件](../../../../reference/api/ai-studio/resource-center/knowledge-bases/upload-local-file-before-creation.md) | 创建知识库前准备本地文件时使用。 |
| 上传本地文件 | [上传本地文件到知识库](../../../../reference/api/ai-studio/resource-center/knowledge-bases/upload-local-file.md) | 向已有知识库准备本地文件时使用。 |
| 预览待添加的数据源 | [预览待添加数据](../../../../reference/api/ai-studio/resource-center/knowledge-bases/preview-data-sources.md) | 添加已有知识库的数据源前检查输入时使用。 |
| 预览创建时的数据源 | [创建知识库前预览数据](../../../../reference/api/ai-studio/resource-center/knowledge-bases/preview-initial-data-sources.md) | 创建知识库时同时提供数据源前检查输入时使用。 |
| 添加数据源 | [添加数据](../../../../reference/api/ai-studio/resource-center/knowledge-bases/add-data-sources.md) | 预览无误后向目标知识库添加数据源时使用。 |
| 补齐历史数据源关系 | [补建知识库的数据记录](../../../../reference/api/ai-studio/resource-center/knowledge-bases/backfill-legacy-data-sources.md) | 需要补齐历史数据源关系时使用。 |

### 查询、预览和维护数据源

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 检查数据源是否已添加 | [校验数据是否已添加](../../../../reference/api/ai-studio/resource-center/knowledge-bases/check-data-sources-exist.md) | 添加前或后确认指定数据源的关联情况时使用。 |
| 查询数据源列表 | [查看数据列表](../../../../reference/api/ai-studio/resource-center/knowledge-bases/list-data-sources.md) | 获取目标知识库中的数据源及其标识时使用。 |
| 查询文档详情 | [查看文档详情](../../../../reference/api/ai-studio/resource-center/knowledge-bases/get-document.md) | 已获得文档标识，需要查看文档时使用。 |
| 预览来源原文件 | [预览来源文件](../../../../reference/api/ai-studio/resource-center/knowledge-bases/preview-source-file.md) | 检查数据源的原始文件时使用。 |
| 预览解析产物 | [预览处理结果图片](../../../../reference/api/ai-studio/resource-center/knowledge-bases/preview-processed-artifact.md) | 检查数据源的解析结果时使用。 |
| 更新数据源治理设置 | [更新数据设置](../../../../reference/api/ai-studio/resource-center/knowledge-bases/update-data-source-governance.md) | 已确定目标数据源，需要调整治理设置时使用。 |
| 删除数据源 | [删除数据](../../../../reference/api/ai-studio/resource-center/knowledge-bases/delete-data-source.md) | 删除前先在动作页确认影响和条件。 |

## 结果确认

添加或更新后，使用[查看数据列表](../../../../reference/api/ai-studio/resource-center/knowledge-bases/list-data-sources.md)确认数据源关联情况；需要核对内容时，使用[查看文档详情](../../../../reference/api/ai-studio/resource-center/knowledge-bases/get-document.md)、[预览来源文件](../../../../reference/api/ai-studio/resource-center/knowledge-bases/preview-source-file.md)或[预览处理结果图片](../../../../reference/api/ai-studio/resource-center/knowledge-bases/preview-processed-artifact.md)。

## 限制和注意事项

删除数据源会影响目标知识库中的该数据源。执行前请在[删除数据](../../../../reference/api/ai-studio/resource-center/knowledge-bases/delete-data-source.md)中确认条件和结果。

## 下一步

- [管理知识库](knowledge-bases.md)
- [管理分段和处理任务](segments-processing.md)