# 语义模型

语义模型把业务概念、指标和数据来源组织成可复用的知识对象。你可以先创建模型，再添加表或文件来源，并通过来源和任务状态确认内容是否已经可用。

## 语义模型如何工作

```text
创建语义模型并保存 model_id
→ 添加 Entry 描述业务语义
→ 选择数据目录（Catalog）表、文件或本地文件
→ 添加来源并保存 source row_id
→ 查询 ingest_status 和 source jobs
→ 验证模型
```

来源出现在模型列表中，只表示关联已经建立。只有来源处理成功、保持启用且未失效时，相关内容才具备后续使用条件。

## 选择任务

| 要完成的任务 | 页面 | 需要保存的结果 |
| --- | --- | --- |
| 创建、更新、导入或导出模型 | [创建和管理语义模型](semantic-models/model-lifecycle.md) | `model_id` 和校验结果 |
| 添加指标、术语等业务定义 | [管理语义模型 Entry](semantic-models/entries.md) | `entry_id` |
| 添加表或文件并查看处理状态 | [管理数据来源与处理状态](semantic-models/sources-processing.md) | 来源 `row_id`、任务 ID 和处理状态 |

Explore Session 和消息不属于当前稳定语义模型导航。需要调用智能体时，请使用[调用智能体](agents-a2a/index.md)中的任务流程。

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

创建和管理语义模型 <semantic-models/model-lifecycle>
管理语义模型 Entry <semantic-models/entries>
管理数据来源与处理状态 <semantic-models/sources-processing>
```

## 下一步

- [创建第一个语义模型](semantic-models/model-lifecycle.md)
- [把数据目录表或文件加入模型](semantic-models/sources-processing.md)
- [配置语义模型使用的 Embedding Provider](provider-backend-router/provider.md)