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

# 知識庫總覽

> 知識庫、Skill 與記憶：各自是什麼、存放在哪裡，以及何時該用哪一個

**知識庫（Context）** 是 Agent 開始工作前就已經知道的一切：整理過的參考資料、可重複使用的做法，以及先前執行時學到的東西。DataGen 提供三種工具來處理這些內容，各自回答不同的問題。

| | 知識庫 | Skill | 記憶 |
| - | - | - | - |
| **回答的問題** | 「Agent 需要知道什麼？」 | 「Agent 該怎麼做這類工作？」 | 「Agent 上次學到了什麼？」 |
| **它是什麼** | 由工作區檔案建立、具名且有版本的檔案樹 | 含 `SKILL.md` 與輔助檔案的資料夾，使用前需經過審核 | Agent 寫入它有寫入權限之知識庫的檔案 |
| **由誰撰寫** | 你，透過 AI Context Builder | 你上傳，審核者核准 | Agent 在執行過程中寫入 |
| **Agent 在哪裡看到它** | 以唯讀方式位於 `/mnt/context/contexts/<slug>/` | 在 Agent 的 `.claude/skills/` | 透過 `list_context_files`、`read_context_file` 與 `write_context` 工具 |
| **版本** | 每次發布都是一個版本，可回溯 | 每次上傳都是一個版本，每次安裝都會固定版本 | Agent 每次寫入都是知識庫的一個版本 |
| **頁面** | [建立](/zh/context/build) 與 [使用](/zh/context/use) | [Skills](/zh/context/skills) | [記憶](/zh/context/memory) |

在產品中，知識庫位於側邊欄的 **檔案** 底下：檔案頁旁的面板標題為 **檔案與知識庫**，並在 **知識庫** 區段列出每一個知識庫。Skill 則位於 **更多 → 技能**。

## 知識庫

知識庫（`WorkspaceContext`）把原始上傳的檔案整理成 Agent 可以信賴的精簡檔案樹。你挑選來源檔案，在與 AI Context Builder 的對話中描述想要的內容，檢查它寫出的檔案，然後發布。

### 快照模型

每個知識庫都有一個 **代稱（slug）**，在建立時設定一次。代稱就是工作區儲存空間中 `.context/` 底下的資料夾名稱，因此知識庫一律發布到 `.context/<slug>/`。之後可以重新命名知識庫，但代稱永遠不會改變。

<Note>
  知識庫是一份**快照**，而不是連到來源的即時連結。發布會把建置器的檔案樹複製到 `.context/<slug>/`，並記錄為新版本。來源檔案變更時，只有在有人（或排程的自動化）再次執行建置器並發布後，知識庫才會跟著改變。
</Note>

* **來源不會進入發布的檔案樹。** 建置器在自己的 `.sources/` 資料夾中讀取來源的副本；只有它建立的檔案樹會被發布。
* **Agent 讀取的是上線中的版本。** 發布後，每個已連結的 Agent 會在下一回合讀取已發布的版本。
* **每個版本都會保留。** 你可以回溯到任何較早的版本；回溯會把該版本的檔案發布為一個新版本，因此不會遺失任何內容。

### 何時使用知識庫

* Agent 需要查閱的政策、產品文件、作業手冊或參考表。
* 大量檔案的精煉摘要，讓 Agent 不必每次執行都讀過數百份原始文件。
* 由多個 Agent 的產出整理而成的單一共用參考資料。

## Skills

Skill 是一組可重複使用的指示：一個含有 `SKILL.md`（名稱、說明、指示）與任何輔助檔案的資料夾。Skill 會上傳到工作區的技能登錄庫、經過審核，然後安裝到需要的地方：

* **安裝在 Agent 上**時，Skill 會複製到 Agent 自己的 `.claude/skills/`，並隨每次執行一起載入。
* **安裝在知識庫或應用（App）上**時，Skill 只是 AI 建置器的建置期工具，永遠不會被發布，也不會進到使用該成果的 Agent 或 App。

當知識屬於**做法**（「如何撰寫我們的週報」、「如何為潛在客戶評分」）而不是**事實**時，就使用 Skill。請見 [Skills](/zh/context/skills)。

## 記憶

Agent 的沙盒在執行結束時就會被丟棄，所以 Agent 本身沒有記憶。在 DataGen 中，Agent 的記憶就是一個它被允許寫入的知識庫。以 **讀取與寫入** 權限把知識庫連結到 Agent，Agent 就會取得列出、讀取與更新其中檔案的工具。每次寫入都是該知識庫的一個新版本，你可以像檢視其他版本一樣檢視並回溯。

記憶適合用來保存 Agent 在工作中發現的事：客戶更換的聯絡人、實際執行後發現有誤的作業手冊步驟、使用者表明的偏好。請見 [記憶](/zh/context/memory)。

## 該用哪一個

| 如果你希望 Agent… | 使用 |
| - | - |
| 根據你的文件、政策或參考資料回答 | 以 **讀取** 權限連結的知識庫 |
| 遵循可重複的流程或公司寫作風格 | 安裝在 Agent 上的 Skill |
| 在多次執行之間記住學到的東西 | 以 **讀取與寫入** 權限連結的知識庫 |
| 讓 AI Context Builder 或 App Builder 有更好的工作方式 | 安裝在該知識庫或 App 上的 Skill |

<Tip>
  原始檔案與已發布的分析資料與知識庫是分開的。Agent 也可以透過 `workspace_data` 工具隨時讀取工作區的原始檔案，並透過 `datagen-data` CLI 查詢已發布的分析資料。請見 [使用檔案](/zh/files/use) 與 [使用資料](/zh/data/use)。
</Tip>

## 下一步

<CardGroup cols={2}>
  <Card title="建立知識庫" icon="hammer" href="/zh/context/build">
    建立知識庫、挑選來源，並發布第一個版本。
  </Card>

  <Card title="使用知識庫" icon="plug" href="/zh/context/use">
    連結到 Agent 與 App，並選擇讀取或讀取與寫入權限。
  </Card>
</CardGroup>


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