對知識對象的有效管理是維護一個高品質 DataWorks 知識庫的核心。這些作為知識內容載體的對象，主要分為兩大類：為 AI 提供結構化資料定義以產生準確查詢的 語義模型，以及為自然語言問答提供豐富業務內容相關的 業務文檔。這裡將全面闡述這些對象的完整生命週期，涵蓋它們的建立、維護、審核與發布，以及常見問題的排查策略，旨在確保知識庫的準確性與時效性，從而最大化其在資料分析和業務查詢中的價值。
功能介紹
知識對象 是 DataWorks 知識庫中對知識進行分類管理的核心機制，該機制的一個關鍵特性是支援對單一類型的知識對象進行獨立構建，從而實現對不同知識來源的靈活、高效更新。
語義模型：承載實體、度量、維度和關係等語義定義的對象，協助 AI 在取數和分析情境下理解資料表含義與欄位用法（包括公用指標與行業術語），輔助產生準確的查詢語句。構建產生的模型在此審核、編輯和發布，也可以手動上傳定義檔案或從 Quick BI 匯入。
業務文檔：上傳到知識庫的業務資料檔案。在此上傳、瀏覽、預覽和刪除文檔，上傳後發起構建產生知識。
知識構建產出的語義模型以未發布版本進入知識對象，經審核發布後才會替代目前的版本；業務文檔上傳後需構建並成功發布才可檢索。構建任務的發起與運行情況參見建立知識庫。
知識對象發布後，大模型會基於其中的內容進一步編輯，產生 Wiki 頁面和知識圖譜，瀏覽與檢索方法參見使用知識庫。
使用前提
已建立知識庫並進入詳情頁，操作方法參見建立知識庫。
編輯、發布和歸檔語義模型，刪除文檔等維護操作需要相應的維護許可權，許可權體系參見步驟六：配置與許可權。
語義模型
語義模型是一個包含了中繼資料、關係和商務規則的集合，其核心目標是為資料賦予清晰、無歧義的業務含義。它通常包含以下幾個關鍵元素：
實體 (Entities)：代表核心的業務對象，如“客戶”、“產品”、“訂單”。
度量 (Measures)：代表可量化的數值，通常是業務中關注的核心指標，如“銷售額”、“利潤”、“活躍使用者數”。這些度量通常包含了計算口徑的定義。
維度 (Dimensions)：提供分析度量的上下文和視角，如“時間”、“地理地區”、“產品類別”。維度常常具有層級結構（例如：年 -> 季度 -> 月）。
關係 (Relationships)：定義了不同實體之間的關聯方式，例如一個“客戶”可以有多個“訂單”。這指導了系統如何正確地關聯（JOIN）不同的資料表。
建立語義模型
在知識對象頁簽單擊建立，在語義模型下提供三種建立方式：
AI 智能產生：根據營運目標、資料範圍和血緣關聯建立語義產生任務，產生待審核的語義模型版本。可以在知識對象頁簽的建立中進入，也可以在知識構建中選擇資料來源語義構建進入。填寫營運目標和任務資訊，選擇已配置的資料範圍及必要的種子表、指標定義等內容，選擇運行環境並提交產生任務；在語義產生任務或構建管理中跟蹤運行結果，檢查產生的未發布版本並確認後發布。
從 Quick BI 匯入：從 Quick BI 選擇資料集，完成 Quick BI 資料與 DataWorks 資料來源的映射後批量產生語義模型，無法匹配的資料來源需要先補充映射或來源配置。
上傳 YAML 檔案：上傳一個或多個 YAML 定義檔案建立語義模型，格式不符的檔案會提示錯誤，修複後重新上傳即可。
某種建立方式無法選擇時，先確認當前知識庫是否開放該方式，再確認自己的許可權。
語義模型詳情與維護
語義模型詳情包含三個內容頁簽：
詳情：查看模型摘要、結構和統計資訊。
圖譜：查看模型中的對象關係。
定義：查看目前的版本的唯讀 YAML 定義，存在多個檔案時可以切換。
具備維護許可權的使用者可執行以下操作：
編輯：使用表單或 YAML 方式修改模型，無效 YAML 必須先在 YAML 視圖中修複。每一次編輯都會產生一個新的版本，您可以在知識構建成功後，查閱內容無誤後，對版本進行發布。發布後編輯內容才會生效。
發布：將當前未發布版本設為可用版本。未發布版本不會自動替代當前發布版本，審核後再發布。
版本歷史：查看歷史版本，選擇兩個版本比較差異，下載 YAML 差異。
歸檔：歸檔後模型不再出現在正常管理列表中，且不能繼續編輯或發布。
以上操作要求模型處於允許操作的狀態，且目前使用者具有相應許可權。操作不可用時，先確認模型狀態，再確認目前使用者的操作許可權。
語義產生任務
語義產生任務可在構建管理中進行統一管理，支援運行、查看運行歷史和產生結果、修改自己有權維護的任務，以及刪除任務。刪除語義產生任務後不能再次運行該任務，但不會刪除已經產生的語義模型。
業務文檔
業務文檔通過文檔知識構建任務納入知識庫，來源包括上傳本地檔案，以及DingTalk、飛書、Lark、企業微信和語雀等線上文檔的同步內容。DingTalk和飛書文檔來源需先在來源管理中配置憑證與同步範圍，配置和構建方法參見步驟二：配置來源（可選）。
瀏覽與管理文檔
業務文檔按檔案夾組織使用者上傳的業務資料，可搜尋、展開檔案夾、選擇檔案並預覽。具備許可權的使用者可以刪除文檔，刪除後重新整理列表可確認最終結果。
上傳並構建
上傳支援的檔案格式與上傳限制，參見文檔知識構建。
單擊詳情頁右上方的知識構建，選擇文檔知識構建；也可以從業務文檔空狀態進入。
文檔來源選擇本地上傳，填寫任務名稱，然後拖拽檔案或檔案夾，或選擇上傳檔案、上傳檔案夾。同步DingTalk、飛書、Lark、企業微信或語雀等線上文檔時，選擇對應來源，無需上傳檔案。
檢查檔案清單，處理被標記的不支援、超限或系統檔案。
在運行環境中選擇運行工作空間、運行資源群組和大模型，按需調整計算 CU。
在更新方式中選擇運行策略：手動或周期，選擇周期時設定執行循環和執行時間。
單擊建立任務。提交成功後可在構建管理的運行執行個體中跟蹤執行狀態。
上傳完成不代表檔案已可檢索，須構建並成功發布後才生效。替換或刪除檔案後，同樣需要重新構建，相關知識才會更新或移除。
提高資料解析效果
使用清晰的標題和章節，確保掃描版 PDF 和圖片清晰可辨。
Excel 首行使用清晰且唯一的列名，內容較多時按主題拆分檔案。
上傳前移除密碼、密鑰、個人隱私和無權披露的資訊。
常見問題
Q：為什麼某個語義模型不能編輯或發布？
A：常見原因包括：目前的版本已歸檔、正在執行影響檢查、目前使用者無維護許可權，或該版本沒有可編輯的定義檔案。
Q：為什麼上傳的檔案沒有進入構建？
A：請檢查副檔名、檔案大小和單次檔案數量。系統檔案、不支援的格式和超限檔案會被忽略或標為需處理，支援的檔案格式與上傳限制參見文檔知識構建。
Q：上傳成功後為什麼搜尋不到檔案？
A：上傳和構建是兩個步驟。請確認已發起構建，並且任務已經成功發布。
Q：刪除檔案後為什麼仍能搜尋到相關內容？
A：刪除檔案後需要再完成一次構建，相關知識才會從當前檢索版本中移除。