# 从一份 PDF 创建首个知识库

MOI 知识库支持使用 Catalog 中的 PDF 构建可检索的文档知识。文件添加到知识库后，平台会自动完成内容解析和索引；用户可以直接针对文档提问，并通过回答中的参考来源核对原文。

本教程使用公开资料《国家人工智能产业综合标准化体系建设指南（2024版）》进行演示。您也可以换成自己的 PDF，操作方式相同。

## 你将完成什么

- 将一份本地 PDF 上传到 Catalog；
- 创建知识库并添加该 PDF；
- 等待 MOI 自动完成文档解析；
- 针对文档内容提问并查看参考来源。

## 开始前准备

- 准备一个 MOI 账号，可前往 [MOI 云端登录/注册](https://moi.matrixorigin.cn/)；
- 下载 [《国家人工智能产业综合标准化体系建设指南（2024版）》](https://www.cac.gov.cn/rootimages/uploadimg/1721686809515617/1721686809515617.pdf)，或准备一份自己的 PDF。

## 操作步骤

### 1. 将 PDF 上传到 Catalog

1. 登录 MOI，在左侧导航的 **数据连接** 中选择 **导入任务**。
2. 点击 **新建导入任务**，选择 **非结构化**。
3. 在数据来源中选择 **本地上传**，上传准备好的 PDF。
4. 在目标位置中选择当前工作区的 Catalog，并将文件保存到以下位置：

   ```text
   <当前工作区 Catalog> / tutorial_data / pdf_knowledge_files / documents
   ```

   其中，`tutorial_data` 是目录，`pdf_knowledge_files` 是数据库，`documents` 是数据卷。如果尚未创建，可以在选择目标位置时依次新建。

   保持其余配置为默认值，并确认文件列表中已经显示准备好的 PDF。

   ```{image} ../assets/images/tutorials/pdf-knowledge-base-local-upload.png
   :alt: 选择本地 PDF 并配置 Catalog 目录、数据库和数据卷
   ```

5. 确认目标位置后，点击 **创建并开始导入**。
6. 等待导入任务状态变为 **已完成**。

```{image} ../assets/images/tutorials/pdf-knowledge-base-import-completed.png
:alt: 导入任务列表中的 PDF 文件已完成状态
```

导入完成后，可以在 **资源中心 > Catalog > tutorial_data > pdf_knowledge_files > documents** 中找到该文件。

### 2. 创建知识库

1. 在左侧导航的 **资源中心** 中选择 **知识库**。
2. 点击 **创建知识库**。
3. 输入知识库名称，例如 `ai_standard_knowledge`，并填写用途说明。
4. 点击 **完成**。

创建完成后，页面会自动进入知识库详情页。

### 3. 添加 PDF

1. 在知识库详情页点击 **添加数据**。
2. 在 **选择数据** 窗口中，依次打开当前工作区的 Catalog、目录 `tutorial_data`、数据库 `pdf_knowledge_files` 和数据卷 `documents`。
3. 选中刚刚上传的 PDF，点击 **添加**。

```{image} ../assets/images/tutorials/pdf-knowledge-base-add-file.png
:alt: 从 Catalog 中选择 PDF 并添加到知识库
```

4. 等待文件的处理状态变为 **已完成**。

```{image} ../assets/images/tutorials/pdf-knowledge-base-processing-completed.png
:alt: 知识库中的 PDF 处理状态显示为已完成
```

MOI 会自动解析 PDF 并建立索引。处理完成后，该文件即可用于问答。

### 4. 发起问答

1. 返回知识库列表，在新建的知识库卡片上点击 **对话**。

   ```{image} ../assets/images/tutorials/pdf-knowledge-base-chat-entry.png
   :alt: 从知识库卡片上的对话按钮进入知识库问答
   ```

2. 输入一个文档中有明确答案的问题，例如：

   ```text
   人工智能产业链包括哪四个部分？
   ```

3. 查看 MOI 返回的回答和参考来源。

   ```{image} ../assets/images/tutorials/pdf-knowledge-base-answer.png
   :alt: MOI 根据 PDF 内容回答问题并显示参考来源
   ```

4. 点击来源，打开对应的 PDF 页面并核对原文。

您还可以继续追问各层包含的内容，或让 MOI 总结文档中的标准体系和重点方向。

## 教程完成

您已经完成了从本地 PDF 到知识库问答的完整流程：文件已上传到 Catalog，知识库完成了自动解析和索引，并能够根据文档内容回答问题、提供参考来源。
