必须启用标签功能并绑定业务标签才能精准检索，否则默认查全部文档；上传时需在高级设置中输入标签名，API打标须先创建标签；检索时filter字段须为标签数组，默认and逻辑，大小写敏感。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎私域知识库中精准定位带特定业务属性的文档，必须利用标签作为元数据维度进行筛选，否则将默认检索全部已授权文档，无法实现权限隔离或场景化聚焦。
确认知识库已启用标签功能
登录火山引擎控制台 → 进入【Knowledge Search】服务 → 在左侧导航栏点击【知识库管理】→ 找到目标知识库，查看「标签管理」开关是否为开启状态。该开关默认关闭，【未开启时所有标签绑定操作均无效】。
若开关为灰色不可点，说明当前知识库类型不支持标签（如部分旧版基础知识库），需新建一个「支持元数据过滤」类型的知识库并迁移文档。
为文档批量绑定业务标签
方法一：通过控制台上传时直接指定标签
在【知识库管理】→【上传文档】页面，选择文件后，在「高级设置」区域展开「文档标签」输入框，输入已存在的标签名（如“财务制度”“HR政策”“2026版”），多个标签用英文逗号分隔。这一步必须在点击「确认上传」前完成，上传后无法回填标签。
方法二：使用API批量打标（适用于已有数百文档的场景）
调用 /v1/knowledge/documents/batch_update 接口，请求体中携带 document_ids 和 tags 字段。注意：接口仅接受已存在于系统中的标签ID，不可传入新标签名；新标签需先调用 /v1/tags/create 创建。
执行带标签条件的检索请求
第一步：构造查询参数
在调用知识检索API（/v1/knowledge/search）时，必须在请求体中显式声明 filter 字段，格式为：{"tags": ["合同模板", "法务审核"]}。不能只传标签名字符串，必须是数组；空数组 [] 会匹配无任何标签的文档。
第二步：理解 and/or 行为逻辑
当传入多个标签时，默认为 【and 关系】，即文档必须同时具备所有指定标签才被返回。若需 or 逻辑（如“合同模板”或“采购流程”任一匹配），需改用元数据字段表达式：{"expression": "tags CONTAINS '合同模板' OR tags CONTAINS '采购流程'"}。
第三步：验证响应结果
检查返回 JSON 中的 hits[].source.tags 字段，确认命中文档确实携带所设标签。若无结果，优先检查标签名是否大小写完全一致——火山引擎标签匹配严格区分大小写。
