必须先完成知识源元数据配置才能为文档添加标签，否则圈选、检索和分账均失效；需确认知识源状态为“已启用”，再通过CSV导入、API调用或控制台编辑绑定标签，并验证问答过滤与分账明细。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎知识库中为文档添加标签，必须先完成知识源的元数据配置，否则标签无法关联到具体文档内容，后续圈选、检索和分账都会失效。
确认知识源已登记并启用
登录火山引擎控制台 → 进入「知识库」服务 → 左侧导航栏点击「知识源管理」→ 检查目标知识源状态是否为「已启用」。若显示「未启用」或「注册中」，标签配置将无法保存，所有后续操作无效。
单击该知识源右侧的「配置元数据」按钮，进入元数据编辑页。
添加文档级标签字段
在元数据配置页的「自定义字段」区域，点击「+ 添加字段」。
字段类型选择「标签（Tag）」；字段名称填写业务可识别的名称，例如 【content_category】 或 【owner_team】；字段描述建议注明使用规范，如“用于标识文档所属业务线，值域：marketing/finance/product”。
注意：字段名称不支持空格、中文标点及特殊符号，且一经保存不可修改字段类型，仅可重命名。
绑定标签值到具体文档
方法一：批量导入CSV映射表
准备CSV文件，首行为字段名，必须包含 knowledge_id（文档唯一ID）与上一步创建的标签字段名（如 content_category），每行对应一个文档的标签赋值；上传路径：知识源配置页 → 「文档标签映射」→ 「导入CSV」→ 选择文件 → 点击「开始导入」。
方法二：API方式动态打标
调用 UpdateKnowledgeDocumentTags 接口，传入 knowledge_id 数组与 tags 字段（JSON格式键值对），需确保请求 Header 中携带有效的 X-Date 和 Authorization 签名；单次最多更新 100 个文档，超量需分批提交。
方法三：控制台单文档编辑（适用于调试或少量文档）
返回「知识库文档列表」→ 找到目标文档 → 点击右侧「编辑」图标 → 在弹出面板底部「标签」区域，输入已定义的字段名（如 content_category），再输入对应值（如 marketing）→ 点击「保存」。
验证标签是否生效
第一步：在知识库问答测试框中输入带标签过滤的查询语句，例如「请从 content_category=marketing 的文档中提取Q3推广策略」；若返回结果准确限定在营销类文档，则标签已成功挂载。
第二步：进入「费用中心」→「标签分账」→ 选择该知识源资源类型 → 查看标签维度账单明细，确认 【content_category】 列存在非空值且数值可汇总。
