DataWorks：DataWorks 知識庫

主要能力

知識庫支援以下主要能力：

• 自動採集 DataWorks 工作空間中的表、欄位、任務、指標、資料標準、血緣和品質等資訊。

• 通過智能分析補充資產的業務名稱、說明、標籤、使用建議和風險提示。

• 將資料資產按業務主題歸類，形成業務域和語義資料關係。

• 上傳文檔、表格、網頁檔案、圖片和 ZIP 壓縮包，建立業務資料庫。

• 統一搜尋自動產生知識和人工上傳資料，並查看結果來源。

• 通過管理員和分享授權控制知識庫的維護與使用範圍。

• 通過全量、增量和定時構建持續更新知識。

知識庫不會修改源工作空間中的表、任務或檔案。系統讀取相關資訊並產生獨立的知識內容。

與 AI 助理服務、Data Agent 的關係

知識庫已從 AI 助理服務中抽離為獨立模組 Context Graph（知識庫），在 DataWorks 控制台左側導覽列中與 Data Agent、AI 助理服務 同級，由該模組統一建立和管理知識庫執行個體。在 Context Graph（知識庫）中建立的知識庫，可以在 AI 助理服務和 Data Agent 中使用。

如果您是 AI 助理服務的存量使用者，此前在 AI 助理服務中建立的知識庫將作為本地知識庫繼續在介面中展示。建立的 AI 助理服務不再支援建立本地知識庫，如需建立新的知識庫，請在 Context Graph（知識庫）中統一建立和管理。詳情參見本地知識庫（AI 助理服務存量使用者）。

進入知識庫列表

1. 登入 DataWorks 控制台。

2. 在頂部功能表列切換至目標地區。

3. 在左側導覽列單擊 Context Graph（知識庫）。

知識庫列表以卡片形式展示當前帳號可訪問的知識庫，每張卡片包含名稱、描述、當前帳號在該知識庫中的角色、知識庫類型（個人或企業）、所有者和建立時間。您可以在頁面上方的搜尋方塊中按知識庫名稱搜尋。

建立知識庫

1. 在知識庫列表頁，單擊建立知識庫。

2. 在建立知識庫對話方塊中，配置知識庫資訊。

   配置項	說明
   名稱	必填。輸入便於識別的名稱，建議體現業務範圍，例如"零售經營知識庫"。
   類型	必填。選擇個人或企業：個人知識庫僅建立者可見和管理；企業知識庫同租戶可見，僅建立者可管理。詳情參見知識庫類型與存取範圍。
   描述	選填。說明知識庫的業務範圍、主要使用者和更新方式。最多支援 1,024 個字元。

3. 單擊建立知識庫。

建立後，您可以通過自動產生或人工上傳為知識庫新增內容。在知識庫列表的卡片上，還可以對已建立的知識庫執行分享、管理員設定、編輯和刪除操作。

自動產生

根據源資產及其中繼資料的完整程度，結果可能包括：

• 業務域及資產分布。

• 表、欄位和任務的業務名稱與說明。

• 資產粒度、分層、負責人、引擎和健康度等資訊。

• 欄位語義角色、敏感類型和信賴度。

• 指標、邏輯表、業務術語和資料標準。

• 同義字、查詢樣本和跨表關聯樣本。

• 適用情境、已知風險和分析提示。

• 表級、欄位級關係及語義資料圖。

並非所有資產都會產生上述全部內容。產生效果取決於源中繼資料、資產命名、注釋、樣本、畫像和血緣等資訊是否完整。

人工上傳

除自動產生的語義知識外，您還可以上傳本地業務資料作為知識庫的補充，用於注入系統掃描不到的業務知識（如指標口徑說明、專有名詞解釋、規章制度等）。上傳的資料與自動產生知識統一儲存、統一檢索。

查看知識庫內容

構建成功後，可以從以下頁面查看結果：

頁面中的內容可能來自源系統、DataWorks 平台中繼資料或系統推斷。系統會儘可能保留語義來源和信賴度。重要業務定義和低信賴度內容應結合源資產及業務負責人進行確認。

搜尋知識

知識搜尋可以同時檢索自動產生的語義知識和人工上傳資料。您可以使用業務詞、技術名稱、檔案名稱或自然語言問題進行搜尋。例如：

• 成交金額是什麼意思

• 使用者畫像相關的表

• 包含手機號的欄位

• 資料品質巡檢流程

• 訂單表按天統計的查詢樣本

使用搜尋結果時，請注意以下事項：

• 結合知識庫、業務域、物件類型和來源判斷結果是否適用。

• 單擊結果查看資產詳情或原始資料，核對重要結論。

• 系統不會修改或翻譯物理表名、欄位名、SQL、代碼和 ID。

• 使用者只能搜尋自己有權檢索的知識庫。

在 AI 助理服務和 Data Agent 中使用

在 Context Graph（知識庫）中建立並構建成功的知識庫，可以在 AI 助理服務和 Data Agent 中使用，為其提供業務知識。

可使用的知識庫範圍取決於知識庫類型與授權情況：

• 企業知識庫：同一租戶下的所有成員均可使用。

• 個人知識庫：預設僅所有者可用。如需供 Data Agent 或 AI 助理服務使用，需由所有者或管理員通過分享為對應執行個體添加授權。

Data Agent 和 AI 助理服務不能作為知識庫的管理員，只能通過分享獲得授權後使用知識庫。詳情參見分享知識庫。

知識庫類型與存取範圍

分享知識庫

通過分享可以將知識庫授權給其他對象使用，被授權對象可以使用該知識庫中的知識進行知識搜尋。支援授權的物件類型如下：

操作步驟：

1. 在知識庫列表中找到目標知識庫，單擊分享。

2. 在添加授權對象地區，選擇使用者、Data Agent 或 AI 助理服務頁簽。

3. 通過名稱或 ID 搜尋目標對象。

4. 單擊目標對象右側的授權。

設定管理員

通過管理員設定可以為知識庫配置協同維護的租戶使用者。管理員擁有配置、構建和上傳許可權，但刪除和清空知識庫仍僅限所有者。

操作步驟：

1. 在知識庫列表中找到目標知識庫，單擊管理員設定。

2. 在添加管理員地區，通過姓名或帳號搜尋目標使用者。

3. 單擊目標使用者右側的添加。

已添加的管理員展示在管理員列表中，列表同時顯示所有者。如需移除某個管理員，單擊其右側的移除。所有者不可被移除。

角色許可權

授許可權制

管理員必須是當前租戶中的使用者。Data Agent 和 AI 助理服務不能成為管理員，需通過分享獲得授權後使用知識庫。單個知識庫最多支援 200 名管理員和 200 條分享授權。

企業知識庫預設允許同租戶成員檢索，因此通常無需逐個為使用者添加授權。個人知識庫可以按需通過分享授權給指定使用者、Data Agent 或 AI 助理服務。

• Q：上傳成功後為什麼搜尋不到檔案？

  A：上傳和構建是兩個步驟。請確認已發起人工上傳內容構建，並且任務已經成功發布。

• Q：刪除檔案後為什麼仍能搜尋到相關內容？

  A：刪除檔案後需要再完成一次構建，相關知識才會從當前檢索版本中移除。

• Q：ZIP 中部分檔案為什麼沒有產生知識？

  A：請檢查包內檔案格式、大小和檔案完整性，並查看構建日誌是否存在跳過提示。不支援的普通檔案不會產生知識。

• Q：自動產生的名稱或說明不準確怎麼辦？

  A：請先完善源資產的名稱、注釋、負責人、標準和血緣，再重新構建。系統推斷結果僅用於輔助理解，重要業務口徑應由業務負責人確認。

• Q：切換為英文介面後，為什麼知識仍是中文？

  A：知識內容語言在首次構建時確定。切換控制台語言不會翻譯或改變已有知識。

• Q：為什麼部分頁面沒有資料？

  A：只有來源資料存在且分析成功時，系統才會產生對應知識。例如，沒有品質規則時不會展示相關規則，沒有可靠關係時可能不會產生跨表查詢樣本。頁面為空白不一定表示構建失敗。

• Q：管理員和分享授權有什麼區別？

  A：管理員可以配置、上傳和構建知識庫；通過分享獲得授權的使用者、Data Agent 或 AI 助理服務只能使用知識進行搜尋或問答，不能修改知識庫。

• Q：個人知識庫可以分享給其他人使用嗎？

  A：可以。個人知識庫預設僅所有者可用，所有者或管理員可以通過分享，將知識庫授權給指定使用者、Data Agent 或 AI 助理服務使用。

• Q：為什麼在 AI 助理服務中無法建立知識庫？

  A：知識庫已抽離為獨立模組統一管理，建立的 AI 助理服務不再產生本地知識庫。請在 Context Graph（知識庫）中建立知識庫，建立後可在 AI 助理服務和 Data Agent 中使用。

• Q：存量的本地知識庫還能繼續使用嗎？

  A：可以。存量使用者此前在 AI 助理服務中建立的知識庫將作為本地知識庫繼續在介面中展示，並支援再次產生、匯出和清空，不影響原有使用。