必须用层级元数据实现精准过滤，即创建doc_category和doc_version两个字符串字段，上传时通过标注行、api或飞书注释注入值，再在知识库节点启用过滤并设置表达式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在扣子中让知识库只检索指定范围的文档（比如“仅查2025版售后政策”或“只看iOS端操作指南”），必须依赖层级元数据实现精准过滤，而非靠关键词硬匹配或手动删减知识库——后者既不可控又易出错。
创建带层级结构的元数据字段
进入扣子Bot后台 →「知识库」→ 点击目标知识库右侧「编辑」→ 下拉至「元数据管理」区域 → 点击「新建元数据」。
填入字段名：【doc_category】，类型选「字符串」；再新建一个字段：【doc_version】，类型也选「字符串」。
这两个字段构成基础层级：category是第一级分类锚点（如“售后”“技术”“法务”），version是第二级细化标签（如“v2025”“iOS-3.1”）。不能合并成一个字段，否则无法做分层过滤。
上传文档时注入层级元数据
方法一：本地上传PDF/Word时，在文档标题页或首段手动添加标注行：
「#meta: doc_category=售后, doc_version=v2025」
扣子解析器会自动提取该行并写入对应字段。注意标点必须用英文逗号分隔，等号前后不能有空格，否则识别失败。
方法二：使用API批量导入时，在JSON payload中显式声明：
扣子 (Windows) 是字节跳动推出的一站式 AI Agent 平台客户端，支持多 Agent 协作、可视化工作流和知识库管理。最新版本新增 Claude Code 与 Codex CLI 接入、多端同步和项目级管理功能，同时优化了插件生态和 AI 响应速度，让用户在 Windows 上即可高效创建、运行和协作智能体，满足个人、团队及企业场景需求。
{"content":"用户购买后7天内可无理由退货。","doc_category":"售后","doc_version":"v2025"}
方法三：从飞书文档同步时，在文档正文任意位置插入注释块：/* meta: doc_category=技术; doc_version=iOS-3.1 */。飞书同步任务会将其转为结构化元数据。
配置知识库节点启用元数据过滤
第一步：在智能体编排页面 → 找到已绑定该知识库的「知识库节点」→ 点击右上角「配置」。
第二步：勾选「启用元数据过滤」开关 → 在过滤表达式框中输入：
doc_category == "售后" && doc_version == "v2025"
第三步：保存后测试提问“iPhone 15充电异常怎么处理”，系统将只召回v2025版售后文档中的相关内容，完全跳过v2024版、技术文档、法务条款等干扰项。
若需动态切换范围（例如按用户选择的版本号实时过滤），可在上游节点用变量替换字符串值，如：【doc_version == "{user_selected_version}"】。
