创建知识库前须确认三件事：①团队名称正确，②知识库名称在本团队内唯一，③类型选“文本”；上传宜用本地直传（≤20mb）或在线采集；分段需设标识符与800～1200字符长度，并验证预览与引用效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想把几十页的产品手册、上百条的客服话术或整本行业白皮书喂给扣子智能体，让它精准回答用户问题，而不是泛泛而谈——这需要正确处理长文本结构，并确保知识库能被准确切片、召回。
创建知识库前必须确认的三件事
登录扣子平台后，先进入目标团队工作区，再点顶部「知识库」入口。别急着点「创建知识库」，先核对：①当前团队名称是否正确，不同团队的知识库完全隔离；②知识库名称在本团队内【必须唯一】，重名会导致创建失败且无明确报错；③类型选「文本」——表格或图片知识库无法用于长文档语义检索，后续也无法关联进标准问答工作流。
上传长文本的两种可靠方式
方法一：本地文档直传（推荐用于PDF/DOCX）
在知识库详情页单击「新增单元」→ 保持「文本格式」默认选项 → 点击「上传文件」→ 将文件拖入上传区或手动选择。注意：【单个文件不能超过20MB】，超大PDF建议先用Adobe Acrobat拆分为「产品介绍」「参数表」「售后条款」等逻辑块再分别上传。
方法二：在线数据自动采集（适合持续更新的网页型长文）
选「在线数据」→ 点「自动采集」→ 输入目标URL（如公司官网帮助中心首页）→ 开启「定期同步」并设为每日一次→ 确认。系统会抓取该页面及所有子链接下的正文内容，但不会抓取导航栏、页脚、广告位等非主体文本，适合维护动态知识源。
分段设置决定长文本能否被精准召回
上传完成后，系统进入分段预览界面。此时必须操作，不能直接点「完成」：
第一步：优先尝试「自动分段与清洗」→ 观察预览中段落是否按自然章节切开（比如每个H2标题下自成一段）。若出现跨页断句、表格被撕裂、代码块被截断，立即切换至「自定义」模式。
第二步：在自定义模式中，设置分段标识符为「###」或「第[零-九]+章」（正则表达式），避免用换行符——长文档里空行太多，会导致碎片化过载。
第三步：将「分段最大长度」设为800～1200字符。小于500会把连贯论述切成问答式短句，影响大模型理解上下文；大于1500则可能塞进无关细节，稀释关键信息权重。
验证知识库是否真正可用
回到知识库详情页，找到任意一个已切分的片段，点击右侧「预览」图标。如果看到的是完整段落（含标点、缩进、列表符号），说明清洗未破坏原文结构；如果满屏「[URL REMOVED]」「EMAIL HIDDEN」或大量乱码，说明预处理规则过于激进，需重新上传并关闭「删除所有URL和邮箱」选项。
在智能体编排页的知识模块中添加该知识库后，立即在调试窗口输入测试问题，例如「保修期是多久」。若返回结果包含「详见《售后服务条款》第3.2条」这类带出处的引用，证明分段与索引成功；若只答「请参考相关文档」，说明切片失效，需检查分段标识符是否匹配原文标题格式。
