# 管理语义条目

在目标知识库中创建、校验、查询、更新、导入、导出或删除语义条目。本页只处理语义条目；知识库、数据源和分段由相邻任务页管理。

## 前提条件

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

批量导入、导出或修改前，先查询现有语义条目并从结果中确定操作对象。

## 调用顺序

1. 先[查看语义条目列表](../../../../reference/api/ai-studio/resource-center/knowledge-bases/list-semantic-entries.md)，确认目标知识库中的现有条目。
2. 新增或批量导入前，使用[校验语义条目](../../../../reference/api/ai-studio/resource-center/knowledge-bases/validate-semantic-entries.md)检查待写入内容。
3. 校验后创建、导入或更新条目；需要交换内容时导出已有条目，或导入已准备的条目。
4. 完成后重新查询条目；删除前先确认目标条目和影响范围。

## API 操作

### 校验和写入语义条目

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 校验语义条目 | [校验语义条目](../../../../reference/api/ai-studio/resource-center/knowledge-bases/validate-semantic-entries.md) | 创建、导入或更新前检查待写入内容时使用。 |
| 创建语义条目 | [创建语义条目](../../../../reference/api/ai-studio/resource-center/knowledge-bases/create-semantic-entry.md) | 已准备单个条目时使用。 |
| 更新语义条目 | [更新语义条目](../../../../reference/api/ai-studio/resource-center/knowledge-bases/update-semantic-entry.md) | 已确定目标条目，需要修改时使用。 |
| 导入语义条目 | [导入语义条目](../../../../reference/api/ai-studio/resource-center/knowledge-bases/import-semantic-entries.md) | 已准备批量条目且通过必要检查时使用。 |

### 查询、交换和删除语义条目

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询语义条目 | [查看语义条目列表](../../../../reference/api/ai-studio/resource-center/knowledge-bases/list-semantic-entries.md) | 选择、复查或确认目标条目时使用。 |
| 导出语义条目 | [导出语义条目](../../../../reference/api/ai-studio/resource-center/knowledge-bases/export-semantic-entries.md) | 需要取得已有条目用于保存或迁移时使用。 |
| 删除语义条目 | [删除语义条目](../../../../reference/api/ai-studio/resource-center/knowledge-bases/delete-semantic-entry.md) | 删除前先在动作页确认影响和条件。 |

## 结果确认

创建、导入或更新后，使用[查看语义条目列表](../../../../reference/api/ai-studio/resource-center/knowledge-bases/list-semantic-entries.md)确认目标条目。删除后也通过该动作确认条目是否仍在结果中。

## 限制和注意事项

删除会影响目标语义条目；导入和更新会改变现有内容。执行前请在相应动作页确认条件和结果。

## 下一步

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