# 知识库

## 知识库是什么

知识库把文件资料和结构化数据整理成可管理、可检索、可问答的知识来源。它不是另一套物理存储，而是 Catalog 上的**逻辑封装**：对智能体开发者屏蔽 Catalog 路径复杂度，让智能体不必直接浏览 Catalog。

因为是逻辑封装而不是另存一份，**同一份 Catalog 数据可被多个知识库引用**。这也是知识库充当**数据工程师与智能体开发者协作接口**的原因：一边做数据治理，一边把处理好的内容交给智能体，底层仍是同一份数据。

| 视角 | 主要关心 |
| --- | --- |
| 智能体开发者 | 数据是否就绪、对话效果、智能体关联 |
| 数据工程师 | Catalog 路径、处理状态、分段与语义质量、智能体关联 |

## 两类数据，两种后续路径

文件类资料与结构化表可同库共存，但处理与用法不同：

| 数据类型 | 系统如何处理 | 主要用途 |
| --- | --- | --- |
| 文件类（文档、图片、音视频等） | 解析、图文理解、音视频转写、分段与索引 | 检索与问答 |
| 结构化表 | 纳入数据范围，再配语义（维度、指标、关联等） | 数据问答 / NL2SQL |

每个知识库在 Catalog 中有系统维护的专属空间：原始资料与处理产物分开存放。确认资料是否生效时，应同时看**处理状态**与**实际检索结果**，不要只看原始文件是否存在。

## 使用时必须建立的两点预期

1. **数据已添加 ≠ 内容已可问答。** 上传或关联后还需处理至就绪，才能稳定参与检索。
2. **知识库权限不替代底层数据权限。** 即使持有知识库「使用」权，对 Catalog / 数据库表 / 原文件的访问仍受相应权限约束。

知识库权限由工作区管理员在[角色权限](../../guides/ai-studio/permissions/roles.md)中配置。

## 在链路中的位置

```text
Catalog 资产 → 知识库（逻辑封装 / 处理 / 语义）→ 对话验证 或 智能体绑定
```

- **上游**：数据经[数据连接](../../guides/ai-studio/data-sources/index.md)落入 Catalog，或在知识库内本地上传（底层仍落 Catalog）。  
- **本域**：创建知识库、接入与治理来源、检查分段、配置表语义、用对话验收。  
- **下游**：在智能体中绑定知识库，作为正式应用能力；知识库对话本身偏**验证层**，不是唯一对外发布形态。

| | 知识库对话 | 智能体 |
| --- | --- | --- |
| 目的 | 验证知识范围、临时问答 | 可配置技能 / 工具 / 通道的应用 |
| 知识范围 | 本轮所选知识库 | 智能体绑定的知识库与能力 |
| 能力边界 | 轻量入口 | 完整智能体生命周期 |

## 操作指南 →

按顺序完成一条知识库链路：

1. [创建与数据](../../guides/ai-studio/knowledge-bases/create-and-sources.md)
2. [知识库数据管理](../../guides/ai-studio/knowledge-bases/files-and-tables.md)
3. [分段与语义](../../guides/ai-studio/knowledge-bases/chunks-semantics.md)  
4. [对话与检索](../../guides/ai-studio/knowledge-bases/chat-search.md)