> ## Documentation Index
> Fetch the complete documentation index at: https://datagen.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 3. 建立知識庫

> 把上傳的文件整理成供 Agent 使用、有版本的知識庫

原始上傳的檔案不是 Agent 最好的輸入：內容互相重複、格式混雜，重要的事實也被埋沒。**知識庫**（Context）是 AI 建構器根據你的來源整理出的檔案樹。每次發布都會產生一個版本，Agent 讀取的是這份已發布的快照，而不是原始檔案。

在這一部分，你會用第 2 部分上傳的資料夾建立知識庫並發布它。

## 開始之前

* 你已完成 [2. 上傳檔案](/zh/tutorial/02-upload-files)。

<Note>
  知識庫是由檔案建立的：工作區檔案、個人檔案、Agent 產出、某個 Agent 自己的檔案，或外部來源。已發布的分析模型不是知識庫的來源。你會在[第 4 部分](/zh/tutorial/04-build-agent)把第 1 部分的模型直接連結到 Agent，讓 Agent 同時使用兩者。
</Note>

## 1. 建立知識庫

<Steps>
  <Step title="開啟知識庫">
    在左側導覽列點選「**檔案**」。若看不到「**檔案與知識庫**」面板，先點選左上角的「**顯示清單**」。在面板中點選「**知識庫**」下的「**全部知識庫**」，再點選「**新增知識庫**」。
  </Step>

  <Step title="命名">
    | 欄位 | 值 |
    | - | - |
    | 名稱 | Agent 與同事都認得出來的名稱。 |
    | 代稱 | 小寫。Agent 會以這個名稱找到知識庫的檔案。建立後無法修改。 |
    | 說明 | 知識庫涵蓋的內容。 |
  </Step>

  <Step title="選擇來源">
    在「**原始資料**」下選取第 2 部分上傳的資料夾。選取資料夾會持續追蹤它，之後重新建置時會納入新增的檔案。
  </Step>

  <Step title="建立">
    點選「**建立**」。知識庫建構器會開啟。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/datagen/rusBmwP8bd_Srmdm/images/browser-guide/zh/context-select-sources.jpg?fit=max&auto=format&n=rusBmwP8bd_Srmdm&q=85&s=4251bccc2cd14127aca0686155bef18d" alt="新增知識庫：勾選示例資料夾，尚未建立" width="838" height="863" data-path="images/browser-guide/zh/context-select-sources.jpg" />
</Frame>

## 2. 用 AI 建構器建立內容

建構器在自己的沙盒中工作。選取的檔案會以唯讀方式複製進來作為輸入；在你發布之前，建構的內容都不會儲存。

<Steps>
  <Step title="了解來源">
    先使用建議的提示「**來源裡有什麼？**」。建構器會摘要它找到的文件。
  </Step>

  <Step title="描述知識庫">
    告訴建構器要如何為 Agent 整理內容。

    ```text 範例提示 theme={null}
    建立一個分析型 Agent 可以信賴的知識庫：
    - 每個主題一個檔案，標題簡短
    - 業務名詞與每個指標定義的詞彙表
    - 會影響數字解讀的政策與規則
    - 一份 index.md，說明每個檔案的內容
    排除重複與過時的內容。
    ```
  </Step>

  <Step title="檢查結果">
    檢查產生的檔案樹，並持續要求修改，直到內容清楚易讀為止。
  </Step>
</Steps>

## 3. 發布

1. 點選頁首的「**發布知識庫**」。按鈕上會顯示這次要發布的變更數量。
2. 在「**發布此知識庫**」中填寫「**版本說明（選填）**」，例如 `由參考文件建立的第一個版本`。
3. 點選「**發布**」。

知識庫現在有了上線版本。開啟它的詳細頁面並前往「**版本**」分頁：上線版本會標示「**上線中**」。

<Frame>
  <img src="https://mintcdn.com/datagen/rusBmwP8bd_Srmdm/images/browser-guide/zh/context-versions.jpg?fit=max&auto=format&n=rusBmwP8bd_Srmdm&q=85&s=e5a863f2497f62b05a3351ba5b16bab7" alt="NEON DB schema 版本分頁，v1 上線中" width="838" height="863" data-path="images/browser-guide/zh/context-versions.jpg" />
</Frame>

<Tip>
  知識庫是快照，不是即時連結。文件變更時，請開啟建構器並再次發布。若要回溯，請在較早的版本上點選「**回復到此版本**」；它會以最新版本的形式重新發布。
</Tip>

<Accordion title="選用：用自動化保持內容最新">
  在知識庫的「**自動化**」分頁點選「**新增自動化**」。輸入「**名稱**」，在「**要做什麼？**」中描述工作內容，加入「**定時排程**」觸發條件，然後點選「**儲存自動化**」。排程執行只會更新草稿，永遠不會發布，因此結果由你檢查後自行發布。
</Accordion>

## 你完成了什麼

* 一個由你的文件建立、已發布並保有版本紀錄的知識庫。

下一部分會把它掛載到 Agent。進一步了解：[建立知識庫](/zh/context/build)與[使用知識庫](/zh/context/use)。

<CardGroup cols={2}>
  <Card title="上一步：上傳檔案" icon="arrow-left" href="/zh/tutorial/02-upload-files">
    上傳參考文件。
  </Card>

  <Card title="下一步：建立 Agent" icon="arrow-right" href="/zh/tutorial/04-build-agent">
    讓模型與知識庫開始工作。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.