对知识对象的有效管理是维护一个高质量 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 差异。
归档：归档后模型不再出现在正常管理列表中，且不能继续编辑或发布。
以上操作要求模型处于允许操作的状态，且当前用户具有相应权限。操作不可用时，先确认模型状态，再确认当前用户的操作权限。
语义生成任务
语义生成任务可在构建管理中进行统一管理，支持运行、查看运行历史和生成结果、修改自己有权维护的任务，以及删除任务。删除语义生成任务后不能再次运行该任务，但不会删除已经生成的语义模型。
业务文档
业务文档通过文档知识构建任务纳入知识库，来源包括上传本地文件，以及钉钉、飞书、Lark、企业微信和语雀等在线文档的同步内容。钉钉和飞书文档来源需先在来源管理中配置凭证与同步范围，配置和构建方法参见步骤二：配置来源（可选）。
浏览与管理文档
业务文档按文件夹组织用户上传的业务资料，可搜索、展开文件夹、选择文件并预览。具备权限的用户可以删除文档，删除后刷新列表可确认最终结果。
上传并构建
上传支持的文件格式与上传限制，参见文档知识构建。
单击详情页右上角的知识构建，选择文档知识构建；也可以从业务文档空状态进入。
文档来源选择本地上传，填写任务名称，然后拖拽文件或文件夹，或选择上传文件、上传文件夹。同步钉钉、飞书、Lark、企业微信或语雀等在线文档时，选择对应来源，无需上传文件。
检查文件列表，处理被标记的不支持、超限或系统文件。
在运行环境中选择运行工作空间、运行资源组和大模型，按需调整计算 CU。
在更新方式中选择运行策略：手动或周期，选择周期时设置执行周期和执行时间。
单击创建任务。提交成功后可在构建管理的运行实例中跟踪执行状态。
上传完成不代表文件已可检索，须构建并成功发布后才生效。替换或删除文件后，同样需要重新构建，相关知识才会更新或移除。
提高资料解析效果
使用清晰的标题和章节，确保扫描版 PDF 和图片清晰可辨。
Excel 首行使用清晰且唯一的列名，内容较多时按主题拆分文件。
上传前移除密码、密钥、个人隐私和无权披露的信息。
常见问题
Q：为什么某个语义模型不能编辑或发布？
A：常见原因包括：当前版本已归档、正在执行影响检查、当前用户无维护权限，或该版本没有可编辑的定义文件。
Q：为什么上传的文件没有进入构建？
A：请检查扩展名、文件大小和单次文件数量。系统文件、不支持的格式和超限文件会被忽略或标为需处理，支持的文件格式与上传限制参见文档知识构建。
Q：上传成功后为什么搜索不到文件？
A：上传和构建是两个步骤。请确认已发起构建，并且任务已经成功发布。
Q：删除文件后为什么仍能搜索到相关内容？
A：删除文件后需要再完成一次构建，相关知识才会从当前检索版本中移除。