Skip to main content
知識庫(Context) 是 Agent 開始工作前就已經知道的一切:整理過的參考資料、可重複使用的做法,以及先前執行時學到的東西。DataGen 提供三種工具來處理這些內容,各自回答不同的問題。 在產品中,知識庫位於側邊欄的 檔案 底下:檔案頁旁的面板標題為 檔案與知識庫,並在 知識庫 區段列出每一個知識庫。Skill 則位於 更多 → 技能。

知識庫

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

快照模型

每個知識庫都有一個 代稱(slug),在建立時設定一次。代稱就是工作區儲存空間中 .context/ 底下的資料夾名稱,因此知識庫一律發布到 .context/<slug>/。之後可以重新命名知識庫,但代稱永遠不會改變。
知識庫是一份快照,而不是連到來源的即時連結。發布會把建置器的檔案樹複製到 .context/<slug>/,並記錄為新版本。來源檔案變更時,只有在有人(或排程的自動化)再次執行建置器並發布後,知識庫才會跟著改變。
  • 來源不會進入發布的檔案樹。 建置器在自己的 .sources/ 資料夾中讀取來源的副本;只有它建立的檔案樹會被發布。
  • Agent 讀取的是上線中的版本。 發布後,每個已連結的 Agent 會在下一回合讀取已發布的版本。
  • 每個版本都會保留。 你可以回溯到任何較早的版本;回溯會把該版本的檔案發布為一個新版本,因此不會遺失任何內容。

何時使用知識庫

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

Skills

Skill 是一組可重複使用的指示:一個含有 SKILL.md(名稱、說明、指示)與任何輔助檔案的資料夾。Skill 會上傳到工作區的技能登錄庫、經過審核,然後安裝到需要的地方:
  • 安裝在 Agent 上時,Skill 會複製到 Agent 自己的 .claude/skills/,並隨每次執行一起載入。
  • 安裝在知識庫或應用(App)上時,Skill 只是 AI 建置器的建置期工具,永遠不會被發布,也不會進到使用該成果的 Agent 或 App。
當知識屬於做法(「如何撰寫我們的週報」、「如何為潛在客戶評分」)而不是事實時,就使用 Skill。請見 Skills。

記憶

Agent 的沙盒在執行結束時就會被丟棄,所以 Agent 本身沒有記憶。在 DataGen 中,Agent 的記憶就是一個它被允許寫入的知識庫。以 讀取與寫入 權限把知識庫連結到 Agent,Agent 就會取得列出、讀取與更新其中檔案的工具。每次寫入都是該知識庫的一個新版本,你可以像檢視其他版本一樣檢視並回溯。 記憶適合用來保存 Agent 在工作中發現的事:客戶更換的聯絡人、實際執行後發現有誤的作業手冊步驟、使用者表明的偏好。請見 記憶。

該用哪一個

原始檔案與已發布的分析資料與知識庫是分開的。Agent 也可以透過 workspace_data 工具隨時讀取工作區的原始檔案,並透過 datagen-data CLI 查詢已發布的分析資料。請見 使用檔案 與 使用資料。

下一步

建立知識庫

建立知識庫、挑選來源,並發布第一個版本。

使用知識庫

連結到 Agent 與 App,並選擇讀取或讀取與寫入權限。