元数据（Metadata）是描述知识本身的结构化信息，以键值对（Key-Value）的形式关联在知识库中的文档与问答上。配置元数据后，检索系统可在召回阶段利用元数据匹配用户问题中的关键实体（如产品编码、文档名称、作者等），提升目标知识的召回准确率；也可以将元数据随知识内容一并提供给大模型，辅助生成更准确的回答。
元数据与文档/问答标签的关系：
标签是无业务属性的键值对数据，支持打在文档/问答上；通过在检索范围设置中设置检索范围，对用户通过接口传入的参数值进行完全过滤，标签本身不会提供给大模型生成使用。
元数据以标签、文档分类、问答分类作为数据来源，参与用户问题的检索匹配过程，并支持选择是否同时提供给大模型生成使用。
使用场景
建议使用元数据的场景：用户提问中有明确指向的实体，且知识库中同类实体相近、仅靠语义召回易混淆时，将实体信息设为元数据，提高召回概率。例如：字符串型产品编码、文章作者等。
场景一：分类名在标题/正文中未出现，但用户会按分类来问。
示例：知识库导入课程文档《Agent 类产品设计》《行业洞察策略》，业务上用分类区分「产品经理课程」「商业化课程」，但文档标题和正文未写这些分类名。用户问「给我推荐产品经理课程」时，将分类设为元数据，更易召回《Agent 类产品设计》课程
不使用元数据的效果：「产品经理课程」文档分类不作为元数据基本无法召回《Agent 类产品设计》）。
场景二：知识与提问中带有几乎无语义的字符串（如产品编码 P183749 ）。
示例：知识库导入《P139384 产品说明》《P183749 产品说明》。用户问「P183749 是什么材质的」时，将产品编码设为元数据，更易命中对应编码的产品手册，减少相近编码干扰。
不使用元数据的效果：产品编码不作为元数据，相似的产品编码文档都会被检索出来，用户提问的产品编码如排序靠后可能无法被召回。
功能逻辑
类型 | 不作为元数据 | 作为元数据 |
标签 | 标签作为元数据后，系统会将标签内容与文档切片一起做向量化，参与用户提问后检索召回过程。系统会提取用户对话中作为元数据的标签内容，检索带有对应标签的知识，提高此类知识的召回权重。 | |
文档/问答分类 | 文档/问答分类只在知识治理时使用，不参与检索召回过程。如用户提问包含分类内容将无法检索到对应知识。 | 文档/问答分类作为元数据后，会与知识切片一起参与检索，并支持用户自定义是否将分类和知识切片一起给到大模型用于生成使用。如用户提问包含分类内容可检索到对应分类下的知识。 |
元数据与标签检索区别
1. 元数据参与检索：把结构化信息挂在知识上，用于软召回排序，提升相关知识权重；未命中元数据的知识不会被直接排除。支持从用户提问中提取实体或关键字段，再与知识上的元数据做匹配。
2. 标签参与检索：把标签作为检索范围条件，对知识做硬过滤：只保留命中标签的知识，其余不进入召回。仅支持通过 API 入参指定标签进行匹配，不支持根据用户提问自动理解并做标签过滤。
两者共同使用，先按标签硬过滤圈定检索范围，再在范围内用元数据做软召回排序。标签决定能不能进候选，元数据决定候选里谁排序更靠前；两者可叠加使用，互不替代。
使用前提
空间下已创建知识库。
知识库中已创建标签、文档分类或问答分类，作为元数据的数据来源。
元数据设置不增加独立权限位，跟随知识库权限：具备知识库编辑权限即可设置元数据，具备查看权限即可查看。
操作说明
第一步：为文档问答设置标签/分类
1. 登录腾讯云 智能体开发平台。
2. 在知识库中，导入/编辑时为文档问答设置标签或分类。
第二步：进入元数据
元数据设置在知识库维度生效，进入目标知识库，在知识库/知识管理右上角，单击元数据。
第三步：设置元数据
1. 在元数据设置弹窗中，按需切换标签、文档分类、问答分类页签。
2. 勾选需要作为元数据的标签或分类，分类支持选择父级或子级分类，均支持单选、全选与按名称搜索。
3. 支持为每个标签或分类设置使用方式：用于检索 或 用于检索与生成。
使用范围 | 说明 |
用于检索 | 检索阶段，元数据参与用户问题的检索匹配过程。例如"文档 1 "设置了元数据「产品名称」，将“文档 1 ”打上=「产品名称=产品 A」的标签。当用户提问"产品 A 的价格是多少"时，使用元数据检索可提升"文档 1 "的召回准确率。 |
用于检索和生成 | 在参与检索的基础上，召回知识的元数据会与知识内容一并提供给大模型，作为生成回答的参考信息。当知识正文中不包含元数据信息时，可选择该方式。 |
4. 单击确定，保存元数据。
说明：
若父子级分类均被设置为元数据，知识检索时会参考知识上所有被设为元数据的分类参与检索或生成。
第四步：查看生效状态
元数据设置后，系统会将元数据异步更新到知识库下的文档与问答中，可通过元数据设置列表提示查看处理进度。更新过程中不支持修改元数据。
完成以上步骤即可。
使用方式
新导入的知识：先创建标签或分类，并在元数据设置中将其设为元数据；后续导入文档/问答时打上标签或设置分类，知识即拥有元数据，并按设置的使用范围参与检索或生成。
存量知识：在元数据设置中将已有标签或分类设为元数据，等待状态变为处理完成后，即可在问答场景生效。
注意事项
标签或分类被删除后，元数据设置中对应的标签或分类将同步删除。
修改标签或分类名称、新增或调整元数据设置后，均需等待元数据更新完成后方可生效；更新中状态下暂不支持修改设置。
元数据设置仅对当前知识库生效，不同知识库需分别配置。
元数据设置相关操作会记录到操作日志中，便于审计追溯。
