建立知識庫 - DataWorks

功能介紹

知識庫是 DataWorks 的統一知識管理模組，為 Data Agent、AI 助理服務等智能應用提供統一的知識底座。它將分散在工作空間中繼資料、資料來源和業務文檔中的資訊，整理為可瀏覽、可檢索、可授權的知識，使智能應用在問答、取數和分析時具備一致的業務上下文。

知識庫以獨立執行個體的形式管理，一個知識庫可以被多個智能應用複用，無需在每個應用中重複建設。

核心能力與使用情境

自動構建中繼資料知識：掃描DataWorks工作空間，自動構建表、欄位、任務、指標、血緣等中繼資料的業務域和語義知識。
產生與管理語義模型：基於資料來源產生描述業務實體、維度、指標及其關係的語義模型，統一業務口徑。
融合多源業務文檔：支援上傳本地檔案或同步DingTalk、飛書、Lark、企業微信、語雀等線上文檔，將規章制度、產品手冊、資料字典等非結構化資料納入統一檢索。
結構化呈現知識內容：由大模型將知識整理成 Wiki 的目錄、主題和頁面，便於按業務主題瀏覽和定位，並可追溯每段內容的來源與依據。
探索知識之間的關係：以知識圖譜展示知識對象及其關係，並圍繞業務問題給出推理鏈路和支撐證據，用於分析影響範圍、核對指標口徑等情境。
統一檢索知識：在一個入口同時檢索知識對象、Wiki 頁面和圖譜實體，支援業務詞、技術名稱、檔案名稱和自然語言問題。
賦能智能應用：作為Data Agent和AI助理的知識底座，使其在自然語言問答、資料探查和代碼產生時，能夠理解業務術語並提供更精準的回答。
自動化更新與統一授權：通過周期性構建任務保持知識同步，並通過精細化授權控制使用範圍。

知識構建任務運行後，系統產生知識對象（語義模型和業務文檔），並由大模型進一步整理知識內容，形成 Wiki 和知識圖譜。知識對象的查看、審核與發布方法參見管理知識對象；Wiki、知識圖譜和知識搜尋的使用方法參見使用知識庫。

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

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

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

使用前提

使用知識庫前，請完成以下準備：

已開通 DataWorks，並進入需要建立知識庫的租戶。
如需通過工作空間語義構建產生知識，當前帳號具有待採集工作空間及相關資料資產的讀取許可權。
已準備可執行知識構建任務的 Serverless 資源群組及其所屬專案空間，且所選資源群組具備與構建所需的資料來源或雲端服務的網路連通和存取權限，並預留滿足任務計算 CU 的可用容量（預設 4 CU）。

核心概念

概念	說明
知識庫類型	個人知識庫：預設僅所有者可用。所有者或管理員可以通過分享將知識庫授權給指定使用者使用，並通過管理員配置添加管理員。企業知識庫：同一 DataWorks 租戶下的所有成員預設可以查看和檢索；只有所有者和管理員可以管理。
本地知識庫	AI 助理服務存量使用者此前在 AI 助理服務中建立的知識庫。繼續在介面中展示，並支援再次產生、匯出和清空；建立的 AI 助理服務不再產生本地知識庫。
來源管理	配置知識構建可選擇的工作空間和資料來源。
知識構建	將工作空間中繼資料、資料來源或上傳檔案轉換為可瀏覽、可檢索知識的過程。
任務定義	描述構建任務的長期配置，包括任務名稱、構建範圍、觸發方式和運行環境。
運行執行個體	任務定義的一次真實執行。一個任務定義可以產生多個運行執行個體，每個執行個體有獨立的運行狀態和日誌。
語義模型	以結構化方式描述業務實體、維度、指標及其關係的模型，支援版本管理和發布。
業務文檔	納入知識庫的業務資料，例如業務術語表、設計文檔和操作說明，可以上傳本地檔案或同步DingTalk、飛書、Lark、企業微信、語雀等線上文檔，解析後納入統一檢索。
Wiki	由大模型基於發行的知識對象整理產生，將知識內容組織為目錄、主題和頁面，便於瀏覽和定位。
業務域	按業務主題歸類的一組資料資產。
語義知識	從中繼資料和業務資料中整理出的業務名稱、定義、關係、提示、同義字和查詢樣本等內容。

步驟一：建立知識庫

登入 DataWorks 控制台。在頂部功能表列切換至目標地區。
在左側導覽列單擊語義圖譜，預設進入知識庫列表頁。在知識庫列表頁，單擊建立知識庫。

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

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

單擊建立知識庫。知識庫建立完成後可以為知識庫設定管理員，或者將知識庫分享給租戶下的其他帳號。詳見步驟六：配置與許可權。

重要

刪除知識庫時會將知識庫下的知識同步刪除，請謹慎操作。

步驟二：配置來源（可選）

由於訪問線上文檔需要憑證，必須先在來源管理中將其配置為文檔來源，之後才能在文檔知識構建任務中選用。支援的文檔來源包括DingTalk文檔、飛書文檔、Lark 文檔、企業微信文檔和語雀文檔。

移除來源後，新任務不能再選擇該來源，但不會刪除由歷史任務產生的知識結果。

添加DingTalk文檔

前提條件：在DingTalkMCP官方門戶建立串連，並擷取包含key參數的完整HTTPS地址。

進入DataWorks的來源管理頁面，單擊新增來源。
來源類型選擇 DingTalk文檔。
配置以下參數：
- 來源名稱：自訂名稱，長度不超過256個字元。
- MCP完整地址：粘貼在前提條件中擷取的完整HTTPS地址。
選擇文檔範圍：
- 我的文件：同步目前使用者的個人文檔。
- 指定知識庫、目錄或文檔：限定同步範圍至指定的資源。
單擊校正憑證與範圍。
- 若校正失敗，需檢查憑證、授權範圍、文檔連結及網路訪問配置。
校正通過後，單擊添加來源。

說明

支援格式：僅支援同步DingTalk原生文檔（副檔名為.adoc）。表格、多維表、思維導圖及上傳的獨立檔案（如PDF、Word）不在同步範圍內。
內容轉換：同步時，文檔本文將轉換為Markdown格式。圖片和附件僅保留其文字說明。
憑證安全：出於安全原因，已儲存的MCP Key不會在編輯頁面回顯。若編輯來源時無需更換憑-證，將對應輸入框留空即可沿用原有配置。

添加飛書文檔

前提條件：在飛書開放平台建立或選擇一個企業自建應用，並擷取其 App ID 與 App Secret。為該應用添加機器人能力，並開通以下唯讀許可權：

wiki:wiki:readonly
docx:document:readonly
drive:drive:readonly

建立並發布應用版本。在每個需要同步的飛書知識庫中，添加該應用機器人為成員，並授予其“可閱讀”許可權。

操作步驟

進入DataWorks的來源管理頁面，單擊新增來源。
來源類型選擇飛書文檔。
配置以下參數：
- 來源名稱：自訂名稱，長度不超過256個字元。
- App ID：在前提條件中擷取的App ID。
- App Secret：在前提條件中擷取的App Secret。
選擇文檔範圍：
- 全部授權範圍：同步應用機器人可訪問的所有Wiki空間。
- 指定知識庫、目錄或文檔：精確限定同步範圍。若同步獨立Docx文檔，需提供其連結。
單擊校正憑證與範圍。
- 若校正失敗，需檢查憑證、授權範圍、文檔連結及網路訪問配置。
校正通過後，單擊添加來源。

說明

支援格式：僅支援同步飛書知識庫中的原生文檔（Wiki節點obj_type=docx）。
不支援格式：多維表格（Bitable）、思維導圖（Mindnote）、試算表（Sheets）及直接上傳的檔案（如PDF、Word）不在同步範圍內。
憑證安全：出於安全原因，已儲存的App Secret不會在編輯頁面回顯。
編輯規則：編輯已儲存的來源時，若不更換憑證，可將App Secret輸入框留空以沿用原配置。若修改App ID，則必須同時提供新的App Secret。

添加 Lark 文檔

前提條件：在 Lark 開放平台建立或選擇一個企業自建應用，並擷取其 App ID 與 App Secret。為該應用添加機器人能力，並開通以下唯讀許可權：

wiki:wiki:readonly
docx:document:readonly
drive:drive:readonly

建立並發布應用版本。在每個需要同步的 Lark Wiki 空間中，添加該應用機器人為成員，並授予其“可閱讀”許可權。

操作步驟

進入DataWorks的來源管理頁面，單擊新增來源。
來源類型選擇 Lark 文檔。
配置以下參數：
- 來源名稱：自訂名稱，長度不超過256個字元。
- App ID：在前提條件中擷取的App ID。
- App Secret：在前提條件中擷取的App Secret。
選擇文檔範圍：
- 全部授權範圍：同步應用機器人可訪問的所有 Lark Wiki 空間。
- 指定 Wiki 空間：精確限定同步範圍，僅支援 Wiki 空間或設定頁連結。
單擊校正憑證與範圍。校正失敗時，需檢查憑證、授權範圍、文檔連結及網路訪問配置。
校正通過後，單擊添加來源。

說明

支援格式：Lark Wiki 中的 Docx 文檔，同步時轉換為 Markdown 格式。
不支援格式：Sheet、Base/Bitable、MindNote 及附件不在同步範圍內。
憑證安全：出於安全原因，已儲存的App Secret不會在編輯頁面回顯。編輯已儲存的來源時，若不更換憑證，可將App Secret輸入框留空以沿用原配置。若修改App ID，則必須同時提供新的App Secret。

添加企業微信文檔

前提條件：使用企業微信 API 模式的智能機器人，並擷取其 Bot ID 與 Bot Secret。建立機器人的方法如下：

使用管理員或具備應用系統管理權限的帳號登入企業微信管理後台。
進入“管理工具”→“智能機器人”，建立或選擇需要接入的機器人。
選擇 API 模式，配置機器人名稱、頭像和可見範圍後儲存。
在機器人授權配置中開通文檔、微盤相關許可權。
在機器人詳情或開發配置頁面複製 Bot ID 和 Secret。

操作步驟

進入DataWorks的來源管理頁面，單擊新增來源。
來源類型選擇企業微信文檔。
配置以下參數：
- 來源名稱：自訂名稱，長度不超過256個字元。
- Bot ID：在前提條件中擷取的 Bot ID。
- Bot Secret：在前提條件中擷取的 Bot Secret。
選擇需要同步的共用空間。可以輸入空間名稱查詢，也可留空查詢全部；無需把機器人添加為共用空間成員，同步範圍以機器人實際可搜尋、可讀取的共用空間和文檔為準。
單擊校正憑證與範圍。校正失敗時，需檢查機器人憑證和許可權。
校正通過後，單擊添加來源。

說明

支援格式：企業微信 Word、普通表格和智能表格。
憑證安全：出於安全原因，已儲存的 Bot Secret 不會在編輯頁面回顯。編輯已儲存的來源時，若不更換憑證，可將 Bot Secret 輸入框留空以沿用原配置；若修改 Bot ID，則必須同時提供新的 Bot Secret。重新查詢空間時需要輸入 Bot Secret，留空仍可保留當前已選空間。
Secret 泄露、遺失或重設後，請產生新的 Secret 並重新校正。

添加語雀文檔

前提條件：為每個需要同步的語雀團隊建立唯讀 Token，並記錄團隊對應的空間 Host。建立方法如下：

建立語雀團隊，或進入已有目標團隊。
開啟“團隊管理”頁面，進入“開發人員”欄目，選擇“建立 Token”。
僅授予讀取文檔、讀取知識庫許可權，不授予寫入或成員系統管理權限。
複製 Token，並記錄團隊對應的完整空間 Host。Token 與 Host 必須成組配置。

說明

請使用團隊唯讀 Token，不要使用個人 Token 作為生產資料來源憑證。

操作步驟

進入DataWorks的來源管理頁面，單擊新增來源。
來源類型選擇語雀文檔。
填寫來源名稱（自訂名稱，長度不超過256個字元），並配置 1 至 32 個語雀團隊。每個團隊需填寫：
- 語雀 Host：團隊對應的空間地址，例如 https://example.yuque.com。
- 團隊唯讀 Token：在前提條件中為該團隊建立的唯讀 Token。
選擇文檔範圍：
- 全部團隊知識庫：同步該團隊下所有知識庫。
- 指定知識庫：提供知識庫連結以限定同步範圍，例如 https://example.yuque.com/team/repository。
單擊校正憑證與範圍，各團隊會分別顯示校正結果。
校正通過後，單擊添加來源。

說明

支援格式：語雀文檔和語雀資料表。Sheet 不在同步範圍內。
憑證安全：出於安全原因，已儲存的 Token 不會在編輯頁面回顯。編輯已儲存的來源時，若不更換憑證，可將 Token 輸入框留空以沿用原配置。
Token 泄露、撤銷、失效或更換 Host 時，請建立並提交匹配的新 Token 後重新校正。

步驟三：知識構建

進入目標知識庫後，單擊詳情頁右上方的知識構建，首先選擇構建方式。系統提供三種構建方式：

工作空間語義構建：選擇一個工作空間，直接建立全新的知識構建任務。
資料來源語義構建：選擇一個資料來源，精細化圈選表範圍構建知識。
文檔知識構建：同步DingTalk、飛書、Lark、企業微信、語雀等線上文檔，或上傳本地檔案，構建文檔知識。

三種構建方式都在更新方式中配置運行策略：選擇手動時任務僅在手動觸發時運行；選擇周期時，可按每月、每周、每天或每小時設定執行循環和執行時間，由系統自動運行。

三種構建方式都需要配置以下運行環境參數：

參數名稱	是否必填	說明
運行工作空間	是	指定執行本次構建任務的工作空間。它定義了任務的運行位置，可以與作為分析對象的工作空間不同。
運行資源群組	是	選擇一個用於執行構建任務的 Serverless 資源群組，並確保資源群組具備訪問所需資料來源和大模型服務的網路連通性，以及滿足計算 CU 所需的可用容量。
計算 CU	否	本次構建佔用的計算資源，可配置 4–16 CU，預設為 4。表數量大於 3 萬時，建議增加 CU 數。
資源群組專案	是	選擇所選資源群組關聯的專案空間。知識構建任務在資源群組及其專案空間中運行，請確保專案空間已與資源群組關聯，具體可選項以頁面顯示為準。
大模型	是	選擇用於語義增強或文檔解析的大語言模型，可選模型以頁面顯示的列表為準。不同模型在能力和 Token 消耗上存在差異，直接影響知識構建的品質和成本。

以下分別說明三種構建方式的專有參數。

工作空間語義構建

適合從一個已配置的工作空間進行完整掃描和首次構建。

參數名稱	是否必填	說明
任務名稱	是	為本次構建任務指定一個唯一且易於識別的名稱，方便後續管理。最多 128 個字元。
掃描範圍	是	選擇一個DataWorks工作空間作為知識的來源，系統將分析其中的任務和資料表。選中後，頁面會顯示預計參與分析的任務數和表數。
資料探查	否	一個開關選項，強烈建議開啟以提升知識品質。關閉時：僅進行基礎中繼資料分析，包括：解析中繼資料 Schema、整合資料建模資訊、解析任務代碼與血緣關係。開啟時（預設）：在基礎分析之上，額外執行深度分析，包括：資料採樣與畫像統計：如 `distinct`/`null` 值分布，輔助PII識別。 LLM深度語義增強：如自動產生表/列描述、業務域劃分、識別派生指標、彙總產生同義字與術語庫。
更新方式	是	此部分用於定義任務的觸發方式，包含以下配置：運行策略：定義任務的觸發方式。手動：任務建立後不自動運行，需在“構建管理”中手動觸發。周期：任務將根據您設定的周期和時間自動定時運行。執行循環：當“運行策略”選擇為“周期”時必填，用於設定自動執行的頻率。可選：每月、每周、每天、每小時。執行時間：當“運行策略”選擇為“周期”時必填，用於設定任務在執行循環內的具體啟動時間點。

說明

知識掃描會調用大語言模型（LLM）進行語義分析，產生 Token 消耗。請根據實際需要發起構建任務。
通過工作空間語義構建時，對與資料表的採集不區分資料來源類型，選中空間下的大部分資料來源均可被構建為結構化知識。

資料來源語義構建

適合基於明確的資料來源構建知識，通過精細化圈選表範圍產生語義模型。

參數	必填	說明
任務名稱	是	自訂任務名稱，用於在構建管理中識別和檢索。格式：2~64個字元，以字母或數字開頭和結尾。
營運目標與關注點	是	使用業務語言描述營運目標與關注點，系統據此規劃掃描範圍與模型產出，例如`統一分析各地區收入與續約情況，並確保收入指標使用一致口徑`。
資料範圍		選擇分析對象：資料來源類型：選擇要分析的資料來源引擎（如 MaxCompute, Hologres、StarRocks 、 DLF）。資料來源：在所選類型下選擇已配置的資料來源。沒有可選項時，請先在 DataWorks 中完成資料來源配置。配置運行環境與連通性：工作空間：任務執行所在的工作空間，選擇 MaxCompute 或 DLF 類型時手動選擇；選擇 Hologres 或 StarRocks 類型時，隨所選資料來源自動確定，無需手動選擇。運行資源群組：選擇執行任務的Serverless資源群組（需預留滿足計算 CU 的可用容量）。連通性檢測：必須通過此檢測，以確保資源群組能訪問資料來源。圈定分析內容：分析範圍：按專案或 Schema 圈選參與分析的範圍，只有圈選範圍內的表會參與語義模型產生。起點表：選擇圈表的起點表，或匯入 Schema 模板作為種子輸入，協助系統確定從哪些表開始分析和擴充。
指標匯入	否	通過固定 Excel 模板匯入指標定義檔案，補充指標口徑和依賴欄位，提高產生結果準確度。匯入後頁面會顯示已校正的指標數量，任務運行時按最終圈表範圍決定準入結果。
喜好設定	否，預設全選	設定資料過濾規則，命中規則的表不會參與分析，預設全部開啟，可按需取消：排除暫存資料表（表名含 tmp、temp、bak、backup 或 old 等獨立欄位時排除）；排除版本副本（表名以 _v 加數字、_new 或 _copy 結尾時排除）；排除測試表（表名含 test、demo、sandbox 或 mock 等獨立欄位時排除）；排除測試環境中的表（Catalog、Database 或 Schema 點擊測試環境標識時排除其中的表）；排除帶測試說明的表（表注釋含測試、聯調、範例或沙箱等關鍵詞時排除）；僅保留最新周期表（識別日期或周期尾碼，同一表族僅保留名稱排序最新的 3 張表）。
引用檔案	否	上傳本地檔案或添加 URL，作為業務參考資料輔助語義產生，協助系統理解業務語境。支援 PDF、Word、Markdown、文本和 YAML 格式的檔案。
更新方式	是	此部分用於定義任務的觸發方式，包含以下配置：運行策略：定義任務的觸發方式。手動：任務建立後不自動運行，需在“構建管理”中手動觸發。周期：任務將根據您設定的周期和時間自動定時運行。執行循環：當“運行策略”選擇為“周期”時必填，用於設定自動執行的頻率。可選：每月、每周、每天、每小時。執行時間：當“運行策略”選擇為“周期”時必填，用於設定任務在執行循環內的具體啟動時間點。

文檔知識構建

適合以文檔為主要知識來源，將DingTalk、飛書、Lark、企業微信、語雀等線上文檔或本地業務資料納入知識庫。任務按文檔來源、構建範圍、運行環境和更新方式四部分配置。

文檔來源三者選其一：

本地上傳：上傳檔案或檔案夾並構建知識。
DingTalk文檔：同步已配置的DingTalk來源，無需上傳檔案。
飛書文檔：同步已配置的飛書來源，無需上傳檔案。

線上文檔來源僅在來源管理中已配置對應平台的來源時可選，配置方法參見步驟二：配置文檔來源。

選擇線上文檔來源（DingTalk、飛書、Lark、企業微信、語雀）時，在構建範圍中填寫任務名稱並選擇文件庫，同步範圍沿用該來源在來源管理中的配置，無需在此重複圈選。同步後構建知識預設開啟，同步完成後自動構建知識；關閉後僅同步文檔，不執行知識構建。

選擇本地上傳時，在構建範圍中上傳檔案，參數說明如下：

參數

必填

說明

上傳檔案

是

這是構建知識的核心輸入。您可以拖拽檔案或檔案夾，或選擇上傳檔案、上傳檔案夾的方式上傳，上傳檔案夾時會保留原有的目錄結構。上傳限制：

數量：單次最多上傳 100 個檔案。
大小：單個檔案不超過 10 MB。
格式：支援文檔、結構化資料、技術文本和圖片四類檔案，詳細列表見下表；不支援壓縮包（.zip、.rar）和舊版 Office 檔案（.doc、.xls），如需批量上傳多個檔案，請使用上傳檔案夾。

上傳後，系統會自動在檔案清單中標記或忽略格式不支援、超限或系統檔案。

上傳本地檔案支援的檔案格式如下：

檔案類別	支援格式
文檔	`.md`、`.txt`、`.pdf`、`.docx`、`.xlsx`、`.pptx`、`.html`、`.htm`
結構化資料	`.csv`、`.tsv`、`.json`、`.jsonl`、`.yaml`、`.yml`、`.xml`
技術文本	`.sql`、`.log`、`.conf`、`.properties`
圖片	`.png`、`.jpg`、`.jpeg`、`.gif`、`.bmp`、`.tif`、`.tiff`、`.webp`

說明

如果上傳的檔案中包含圖片，需要選擇支援多模態能力的大模型進行構建。[需要確認：當前支援多模態能力的模型列表]

步驟四：構建管理

啟動知識構建後，可以在構建管理中查看構建任務，在知識庫詳情頁單擊構建管理頁簽，可以管理工作定義和運行執行個體。任務的每一次運行，都會產生一個運行執行個體。

任務定義

每條任務定義包含任務名稱、任務類型、構建範圍、觸發方式、運行資源群組和任務狀態，支援按任務名稱搜尋，按任務類型、觸發方式和啟用狀態篩選，以及重新整理任務定義。

可執行檔操作：
- 立即運行：手動觸發一次構建。
- 編輯：修改任務名稱、觸發方式等配置。
- 啟用 / 停用：控制周期任務的自動觸發。
- 刪除：移除任務定義（任務運行時無法刪除）。
運行執行個體

運行執行個體展示每次執行的任務名稱、類型、觸發方式、運行狀態、開始時間和操作，可按運行狀態、任務類型和觸發方式篩選。知識庫升級任務同樣會出現在運行執行個體列表中，任務類型顯示為版本升級。可執行檔操作：

重要
執行個體啟動並執行時間根據要構建的知識內容大小而定，耗時較長，請耐心等待。
- 查看：開啟運行執行個體詳情。
- 源檔案：查看本次構建使用的輸入檔案。
- 取消：取消仍允許終止的執行個體。
- 重試：對允許重跑的失敗或終止執行個體重新發起執行。
運行執行個體詳情

當一個運行執行個體的狀態為“失敗”時，按以下步驟操作：
1. 定位問題：在“運行執行個體”列表中單擊失敗任務的查看，在詳情頁的執行圖中找到紅色的失敗步驟。
2. 分析日誌：開啟該失敗步驟的日誌，根據錯誤資訊，參考下表進行處理。
3. 解決與重試：修正問題後，返回“任務定義”頁面，單擊立即運行。

錯誤類別	典型日誌線索	處理動作
檔案格式	提示 `.doc`、`.xls`、壓縮包（如 .zip、.rar）等格式不支援，或單個檔案超出 10 MB 限制	參見文檔知識構建章節的檔案格式列表，轉換為受支援格式或拆分超限檔案後重新上傳。
資源群組	提示 Serverless 資源群組不可用、超限或未與專案空間關聯	檢查資源群組狀態和所屬專案空間，參見使用前提章節確認資源群組配置。
工作空間許可權	提示中繼資料、資料資產或工作空間讀取被拒絕	聯絡工作空間管理員補齊目標工作空間及資料資產的讀取許可權。
網路連通	提示訪問資料來源或雲端服務逾時、串連失敗	檢查資源群組能否訪問所需資料來源和雲端服務的網路路徑。
來源資料訪問	提示源表、源資產不存在或返回空	確認來源資料仍然存在、路徑與憑證有效，必要時收窄採集範圍後重試。

修正問題後，在任務定義中再次單擊立即運行。

步驟五：使用知識庫

任務構建成功後，知識庫即進入可用狀態。支援以下操作：

瀏覽Wiki、查看知識圖譜及推理鏈路。
使用統一知識搜尋。
在Data Agent和AI助理服務中調用。

具體操作參見使用知識庫。

構建產出的語義模型和業務文檔，可在“知識對象”中查看、審核與發布。具體操作參見管理知識對象。

存取控制

知識庫的可用範圍取決於其類型與授權狀態。

企業知識庫：對同一租戶下的所有成員可用。
個人知識庫：預設僅所有者可用。其他使用者或智能應用需由所有者或管理員通過分享操作授予存取權限。
應用授許可權制：Data Agent與AI助理服務不能被設定為知識庫管理員員，僅能作為使用者通過分享獲得授權。

步驟六：配置與許可權

配置完知識庫後，您可以將設定多位管理員，對知識庫進行日常管理，也可以將其分享給使用者、AI助理服務或者Data Agent的執行個體，為Agent的Context提供知識推理能力。

組態管理

進入目標知識庫，在詳情頁頂部單擊組態管理，可以修改基礎資訊、管理員和分享範圍。組態管理僅在目前使用者至少具備一種配置許可權時可用，可見的配置欄目由許可權決定，不保證所有使用者都能看到全部欄目。

基礎資訊

修改知識庫名稱、類型和描述，儲存規則與建立知識庫一致。儲存期間關閉操作可能被限制，以避免丟失結果。
管理員配置

通過管理員配置可以為知識庫添加協同維護的租戶使用者。管理員可協同維護知識庫，但刪除和清空知識庫仍僅限所有者。操作步驟：
1. 輸入姓名或帳號搜尋同租戶使用者。
2. 選擇使用者並確認添加，新管理員會出現在管理員列表中，列表同時顯示所有者。
3. 需要撤銷許可權時，單擊移除並二次確認。移除後，該使用者會立即失去知識庫管理員許可權。所有者不可被移除。
分享配置

分享配置僅在知識庫類型和目前使用者許可權允許時出現，用於將知識庫授權給其他對象使用。支援授權的物件類型：使用者、Data Agent 執行個體、AI 助理服務執行個體。
1. 切換授權物件類型：使用者、Data Agent 或 AI 助理服務。
2. 按名稱或 ID 搜尋目標對象。
3. 選擇對象並確認授權，已授權對象會顯示在已授權列表中。
4. 如需撤銷授權，單擊移除並確認。
分享授權允許目標對象使用該知識庫進行知識搜尋，不等同於授予知識庫管理員許可權。

角色許可權

操作	所有者	管理員	企業知識庫普通成員	僅獲分享授權的對象
查看和檢索知識	支援	支援	支援	僅支援檢索
修改知識庫配置	支援	支援	不支援	不支援
配置和執行構建	支援	支援	不支援	不支援
上傳和刪除業務文檔	支援	支援	不支援	不支援
管理員和分享授權	支援	支援	不支援	不支援
清空知識庫語義資料	支援	不支援	不支援	不支援
刪除知識庫執行個體	支援	不支援	不支援	不支援

內容語言

知識庫內容支援簡體中文和英文。一個知識庫只維護一種內容語言。

首次構建時，系統根據當前 DataWorks 頁面右上方的中英語言設定，確定知識庫的內容語言。[需要確認：語言在首次構建時鎖定且不可修改的規則是否不變]
語言確定後，後續各類構建均沿用該語言。切換頁面語言只改變控制台介面，不會改變已有知識的語言。
當前不支援直接修改已有知識庫的內容語言。如需使用另一種語言，請建立知識庫，並在目標頁面語言下發起首次構建。
物理表名、欄位名、SQL、代碼、ID、原始標籤和引用證據不會被翻譯，因此英文知識庫中仍可能包含來源資料內建的中文。

升級歷史知識庫

歷史知識庫升級後才能使用 Wiki 和知識圖譜。升級由知識庫 Owner 或管理員發起，普通成員可以查看知識庫和使用已開放的功能，但不能執行升級。

開啟知識庫列表，找到標記為可升級的歷史知識庫，單擊該標記。
閱讀升級說明，選擇升級使用的資源群組和資源群組專案。
單擊確認升級。升級任務建立後，可在構建管理的運行執行個體中查看進度和結果，任務類型顯示為版本升級。

說明

升級會基於當前知識庫的全部基準資料產生 Wiki 和知識圖譜，併產生少量 Token 消耗。升級期間不要發起其他知識構建任務，如果當前有構建任務正在運行，請先取消或等待該任務結束，再重新整理頁面後發起升級。升級不會刪除歷史知識來源，升級失敗也不會影響原有知識庫資料和正常使用。AI 助理服務存量使用者的本地知識庫相關說明，參見本地知識庫（AI 助理服務存量使用者）。

本地知識庫（AI 助理服務存量使用者）

知識庫已從 AI 助理服務中抽離為獨立模組。對於 AI 助理服務的存量使用者，此前在 AI 助理服務中建立的知識庫將作為本地知識庫繼續在介面中展示，不影響原有使用。在 AI 助理服務中嵌入知識庫模組時，本地知識庫會顯示在知識庫列表的個人知識庫分區，單擊可跳轉至 AI 助理服務的知識庫管理員頁面。

本地知識庫支援的操作：已有的本地知識庫功能保持可用，支援再次產生、匯出和清空。

與知識庫模組的區別

對比項	本地知識庫（存量）	知識庫模組
入口	AI 助理服務執行個體詳情頁的知識庫頁簽	控制台左側導覽列的知識庫
能否建立	建立的 AI 助理服務不再產生	支援建立
歸屬關係	歸屬於單個 AI 助理服務執行個體	獨立執行個體，可被多個智能應用複用
知識庫類型	不區分類型	支援個人知識庫和企業知識庫
共用方式	僅當前執行個體內使用	支援通過分享授權給使用者、Data Agent 或 AI 助理服務

與建立 AI 助理服務的差異：建立的 AI 助理服務不再產生本地知識庫，即不再支援在 AI 助理服務中建立知識庫。如需建立新的知識庫，請在知識庫模組中統一建立和管理，並按需在 AI 助理服務或 Data Agent 中使用；存量歷史知識庫如需使用 Wiki 和知識圖譜，參見升級歷史知識庫。

常見問題

Q：為什麼來源管理或知識構建不可點擊？

A：目前使用者可能只有隻讀或分享使用許可權。請聯絡知識庫所有者或管理員確認許可權。
Q：為什麼組態管理中看不到全部欄目？

A：系統只展示目前使用者有權維護的欄目。例如，能夠編輯基礎資訊不一定代表能夠管理分享範圍。
Q：為什麼構建頁面沒有可選工作空間或資料來源？

A：該來源尚未加入知識庫。請在來源管理中添加後返回，頁面會重新整理可選範圍。
Q：DingTalk或飛書來源校正失敗怎麼辦？

A：檢查應用憑證、唯讀許可權、文檔成員許可權、文檔範圍和資源群組的網路訪問配置，確認後單擊重新校正。
Q：知識庫無法升級怎麼辦？

A：看不到可升級標記時，可能是知識庫已經完成升級、當前帳號不是 Owner 或管理員，或者知識庫版本資訊暫時不可用，請重新整理列表並確認帳號許可權。標記可見但無法提交升級時，通常是同一知識庫存在運行中的構建任務，請取消或等待該任務結束，然後手動重新整理頁面再升級。升級失敗不會影響原有知識庫資料和正常使用。
Q：為什麼刪除任務失敗？

A：任務可能仍在運行、處於刪除中，或被其他任務依賴。先終止活動執行個體並解除依賴，再重試刪除。
Q：為什麼在 AI 助理服務中無法建立知識庫？

A：知識庫已抽離為獨立模組統一管理，建立的 AI 助理服務不再產生本地知識庫。請在知識庫模組中建立知識庫，建立後可在 AI 助理服務和 Data Agent 中使用。
Q：存量的本地知識庫還能繼續使用嗎？

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

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

使用建議

首次構建前先規劃來源範圍，避免把不相關的工作空間納入掃描。
為知識庫設定明確的負責人，並配置備用管理員。
對語義品質要求高的知識庫開啟資料探查，並留意 SQL 採樣和 Token 消耗。
構建成功後同時檢查運行執行個體、知識圖譜覆蓋率和知識搜尋結果，三者共同驗證可用性。
語義模型的未發布版本不會自動替代當前發布版本，審核後再發布。
停用任務用於暫停後續觸發；刪除任務用於移除定義，兩者不要混用。
完善源表和欄位注釋、資料標準、負責人、血緣和品質規則，提高自動構建品質；對核心指標、敏感欄位和關鍵查詢進行人工確認。
定期清理到期資料和測試資產，減少搜尋雜訊。
遵循最小許可權原則，不再需要訪問知識庫時及時移除授權。