加载中…

知识文档

知识文档让你把价格表、操作手册、服务条款整份上传,系统自动切成原文段落直接入库,不用逐条整理成问答,也不用确认草稿。处理完成后,客户问到问答里没有、但文档里写着的细节时,机器人会从原文里找到答案。

入口在控制台 知识管理 → 知识文档。

知识文档为专业版(Pro)/ 旗舰版(Ultra)能力,基础版(Lite)不可新增文档。子账号须由管理员在 系统管理 → 用户管理 的角色里勾选「知识文档」权限(knowledge-doc),没有该权限的账号左侧不显示「知识文档」菜单。授权方式见成员与权限。

所需权限与套餐

项目 说明
功能权限 「知识文档」(knowledge-doc):上传、上传新版本、改分类、停用 / 启用、删除、重试、放弃新版本、恢复、设为永久都需要它
套餐 专业版、旗舰版可用;基础版只能查看、下载原文件和删除
同时生成问答 仅旗舰版,且账号还要有「解析文档」权限(doc-parse),缺少时上传弹窗不显示这个勾选项
知识条目额度 原文段落不占知识库问答对额度,文档另有自己的份数和字数额度(见下文)

按功能清单授权的角色需要手动勾选

  • 自动带上:授权模式为「全部标准功能」的员工(包括旧版没有单独配置权限、按全部标准功能处理的员工),以及企业管理员;今后用「知识维护」模板新建的角色,也会默认带上「知识文档」。
  • 不会自动带上:这次升级之前就已经建好、按功能清单勾选授权的角色——包括按「知识维护」模板建好的存量角色、企业自建的角色,以及迁移时生成的「历史授权」角色(避免悄悄扩大权限)。请管理员到 系统管理 → 用户管理 → 权限角色,编辑这些角色,在角色编辑里手动勾选「知识文档」后保存,对应员工才能看到并使用本功能。

支持的格式与切段规则

上传时只接受下面五种能直接取出文字的格式,单个文件不超过 50MB:

格式 怎么切段 段落里保留什么
Word(.docx) 按章节切段 每段开头带完整章节路径(各级标题用「 > 」连接,如「2 运费 > 2.1 首重」);表格按行转成「表头:值」文字,归入所在章节
Markdown(.md) 按章节切段 同 Word,按各级标题带章节路径
PDF(需有文字层) 按段落切段 记录来源页码,跨页的段落记起始页
TXT 按段落切段 不带章节、不带页码
Excel(.xlsx) 一行一段,带表头 每个工作表第一个非空行当表头,之后每个非空行一段,如「华东运价 | 目的地:上海;首重:10;续重:2」;空单元格省略,空行和隐藏工作表跳过

通用规则:

  • 每段正文不超过 800 字,太长的在句末断开,断开后的每一段都保留章节路径(或工作表名)。
  • 按段落切段时,以空行分段,相邻的短段会合并到一起。
  • 文档没有任何标题时,Word / Markdown 也按段落切段,不加章节路径。
  • 上传即入库,系统不会逐段让你审核;可以在文档详情里翻页预览,确认切得对不对。

Word 请使用内置标题样式

Word 里请使用内置的「标题 1 / 标题 2 …」样式来排版章节。如果用的是自定义的中文样式名(例如自己建了「章标题」「一级条款」之类的样式),再加上自动编号,系统可能识别不出章节,结果整篇文档只能按段落切分,每段没有章节路径。遇到这种情况,请先在 Word 里把章节标题改成内置的标题样式再上传。

不支持的格式

PPT、旧版 Word(.doc)、旧版 Excel(.xls)、图片、没有文字层的扫描件 PDF,这里都不能上传,上传时会提示改用 解析文档 → AI 识别。文件扩展名与实际内容不符(比如把别的文件改了后缀)会提示「文件内容与扩展名不符」;超过 50MB 会提示拆分后再传。

上传文档:步骤

  1. 进入 知识管理 → 知识文档,点右上角(或空列表中的)「上传文档」。
  2. 选一份文件(一次一份),可选分类:这份文档的全部段落都属于这个分类;限定了检索分类范围的智能体,只会用到对应分类里的文档。不选则归入「未分类」。
  3. 旗舰版可选勾选「同时生成问答」(见下文)。
  4. 点「上传」。列表里会出现一行,状态为「处理中」,处理完成后自动变为「可用」,不用手动刷新。处理完成前不参与回答。

原文入库不需要填 sk- 密钥,一个密钥都没创建过的企业也能上传。入库只消耗向量化(把文档内容处理成可检索形式)所需的 Token,不调用对话模型;PDF 转文字这一步也不产生 Token 用量。用量会出现在模型接入的消耗报表中。

同名文件怎么处理

上传的文件名(含扩展名)与已有文档相同时,会弹出选择:

  • 作为新版本替换:按「上传新版本」处理,处理完成后整份替换旧版本,处理期间旧版本照常回答。
  • 另存为新文档:新建一份,文档名自动加序号(如「华东运价(2).xlsx」),两份同时参与回答。
  • 取消:不上传。

原文档还在首次处理中、或处理失败时,「作为新版本替换」会置灰,只能另存为新文档或取消。

同时生成问答(仅旗舰版)

勾选后,原文照常入库,同时按文档解析 → 上传文档的流程另外生成一份问答草稿:

  • 需要本企业的 sk- 密钥:已在「解析文档」保存过默认密钥时会直接提示将使用它;有密钥但没保存时需要当场填写,首次填写并校验通过后会自动保存到账号(与「解析文档」共用同一份默认密钥),之后勾选时直接提示将使用它,不用再填;一个密钥都没有时勾选项不可用,并引导去「API 设置」创建。
  • 问答草稿不会自动写入:请到 知识管理 → 解析文档 找到这条任务,确认后才写入知识库。
  • 问答生成失败不影响原文入库,反过来原文处理失败也不影响问答任务。生成问答会消耗对话模型 Token,按现有「上传文档」规则计费。

额度与字数口径

套餐 文档份数上限 总字数上限 单份字数上限
基础版 不可新增 不可新增 —
专业版 50 份 200 万字 100 万字
旗舰版 1000 份 5000 万字 100 万字
  • 字数 = 各段落正文去掉空白后的字符数,不含章节路径与「工作表名 |」前缀。
  • 份数在上传时判断,满额时页面顶部出现提示条并禁用上传;字数在取出文字之后判断,单份超过 100 万字、或计入后企业总字数超出上限时,这份文档会转为「失败」并写明原因。
  • 页面顶部的额度卡显示「文档份数」与「总字数」的已用 / 上限。
  • 失败的文档、已过期的文档仍占额度,删除后释放;替换新版本时按新版本字数计算,旧版本的字数在替换成功后释放。
  • 从旗舰版降到专业版后,超出额度的已有文档照常可用,只是不能新增、也不能上传新版本,直到用量回到上限内。

文档列表与状态

列表默认按更新时间倒序,每页 20 条,可按文档名搜索(包含匹配,不区分大小写),按状态、有效期、分类筛选。点任意一行打开详情抽屉,可以:

  • 看状态、有效期、分类(可直接改)、内容更新时间;
  • 翻页预览切出的段落(按原文顺序,显示章节路径、页码或工作表名),段落只读;
  • 下载当前版本的原文件;
  • PDF 整体有文字、但个别页面没有文字时,文档照常入库,抽屉顶部会提示「第 N 页未识别到文字」。

三个相互独立的状态

维度 取值 说明
处理状态 处理中 / 可用 / 失败 首次上传只会经历「处理中 → 可用」或「处理中 → 失败」;处理中超过 30 分钟自动转为失败,原因「处理超时」
启用状态 启用 / 已停用 / 套餐不支持 已停用是你手动关掉的;套餐不支持是降到基础版后的状态
有效期 正常 / 即将到期 / 已过期 / 永久 见下文「有效期」

只有「可用 + 启用 + 未过期(正常、即将到期或永久)」的文档才参与回答,其余组合一律不参与。三个维度互不影响:停用不影响有效期计时;已过期的文档点「启用」只改变启用状态,仍需点「恢复」才参与回答(页面会提示「已启用;文档已过期,仍需恢复才参与回答」)。

处理中的文档可以停用(处理完成后保持停用)或删除,但不能改分类、不能上传新版本。

上传新版本、停用、删除

上传新版本

价格表更新了,不要删掉重传,在行菜单或详情抽屉点「上传新版本」:

  1. 选一份与原文档同一格式的文件(扩展名不同会被拒绝),分类沿用原文档。
  2. 提交后,这一行标注「新版本处理中」,期间机器人仍按旧版本回答,不会出现空档。
  3. 处理成功后,旧版本的段落全部不再参与回答,版本号加 1。
  4. 处理失败时,旧版本和版本号都不变,行上标注「新版本失败」及原因,可选「重试新版本」(用已保存的新版本文件)或「放弃新版本」(确认后删除新版本文件,旧版本不受影响)。

以下情况不能上传新版本:文档首次处理中(请等处理完成)、处理失败(请先重试或删除)、已有新版本在处理中(请等处理完成);文档份数超过当前套餐上限时(降级后),也要先删除部分文档。系统不保留历史版本,也不能回退。

停用与启用

暂时不想让机器人引用某份文档时点「停用」:它在所有渠道、工作流、开放 API 与 MCP 的检索里都不再出现;段落和文件都保留,随时「启用」即可恢复(不用重新处理)。

删除(不可恢复)

点「删除」会弹出确认框,写明「删除后不可恢复」。确认后文档记录、全部段落、原文件(含尚未生效的新版本)都会被清除,检索不到,也无法找回,份数与字数额度随之释放。处理中的文档删除时会提示处理将被取消。

有效期

文档和人工维护的知识条目一样纳入有效期管理:

  • 默认有效 365 天,期间每被用来回答一次,就从当天起重新顺延;整份文档一起续期,任一段被用到整份都续期。
  • 一整个有效期都没被用到,文档到期后自动停用,但不会删除,内容保留,随时可以「恢复」。
  • 重要文档(合规、季节性、应急类)可点「设为永久」,不再过期;已过期的设为永久,会立即恢复参与回答;也可「取消永久」。
  • 距到期较近时标「即将到期」,只在页面上提示,不发送消息通知。上传新版本生效后,到期日同样从当天重新计算。
  • 有效天数与开关在 知识管理 → 知识库 → 有效期设置 里统一设置,详见知识库管理。关闭有效期管理后,文档不会再过期。

处理失败的原因与办法

处理失败时,整份文档一起失败,不会留下半截内容,已写入的段落全部撤回、检索不到。列表行与详情抽屉里会显示失败原因,点「重试」会用已保存的原文件从头处理,不用重新上传;不想要了可以直接删除。失败的文档仍占一份份数额度,删除后释放。

Token 额度已用尽,补充额度后可重试

套餐或充值的 Token 额度不够。补充额度后点「重试」。

向量服务暂不可用,请稍后重试

这里的「向量服务」指把文档内容处理成可检索形式的服务,暂时不可用。等一会儿再点「重试」,持续出现请联系平台方。

解析服务不可用,请稍后重试

PDF 转文字的服务暂时不可用(只影响 PDF)。稍后点「重试」,或先改传 Word / TXT 版本。

文件损坏或已加密,无法读取

文件打不开、被密码保护或已损坏。请用原软件打开确认、去掉密码或重新导出后,重新上传。

未识别到文字,扫描件请改用「解析文档 → AI 识别」

文档里几乎没有可识别的文字(最常见的是整页扫描的 PDF 或几乎只有配图的文档)。请改用 解析文档 → AI 识别,或先用 OCR 工具转成可选中文字的文件再上传。

超过单份文档字数上限,请拆分后重新上传

单份文档超过 100 万字。请拆成几份再上传。

超出字数额度,请删除不用的文档后重试

计入这份文档后,企业总字数会超出套餐上限,失败说明里会带上「已用 / 上限」。请删除不用的文档,或升级套餐后重试。

处理超时,请重试

处理超过 30 分钟没有完成(包括服务重启导致中断)。直接点「重试」即可。

与「解析文档」的区别

对比项 知识文档(本篇) 解析文档 → 上传文档 解析文档 → AI 识别
结果是什么 原文段落,保留文档原貌 大模型生成的问答对 大模型生成的问答对
要不要确认 不用,上传即入库 要,先出草稿,确认后写入 要,先出草稿,确认后写入
支持格式 DOCX、PDF(文字层)、TXT、MD、XLSX PDF、DOCX、MD、TXT 扫描件、图片、PPT、旧版 Word、Excel 等
套餐 专业版 / 旗舰版 旗舰版 旗舰版
费用 只消耗向量化 Token,不调对话模型 调用对话模型生成问答 调用视觉与对话模型
占知识条目额度 不占,另有份数 / 字数额度 确认写入后占 确认写入后占

怎么选,详见文档解析:想保留整份原文、改版方便、不想逐条审核,用「知识文档」;想要精炼、可逐条审核的问答对,用「解析文档」;扫描件、PPT、图片只能用「AI 识别」。

原文怎么参与回答

  • 问答优先:问答有把握回答时,只用问答,不加原文;问答没有把握或没有命中时,才补充最相关的几段原文给大模型参考。当回答用到文档原文时,系统会要求智能体只依据所给内容作答,没有相关内容时说明不确定,不编造数字、价格和时效。
  • 新的优先:交给大模型的每条参考内容都带更新日期,多条内容相互矛盾时以更新日期较新的为准。
  • 网页组件、开放 API、公众号、企业微信、QQ、工作流知识检索节点,参考内容的组装与更新日期规则一致;回答末尾的出处只在生成回答的渠道追加,工作流知识检索节点与开放 API 不追加(见下文)。

回答附出处(智能体开关)

默认不在回答里写文档名。在 智能体管理 → 编辑智能体 → 知识与回答 打开「回答附出处」后:

  • 用到知识文档原文的回答,末尾会追加「参考:《文档名》位置」,例如「参考:《华东运价》华东运价;《服务条款》3 赔付 > 3.1 时限」。位置按格式显示:Word / Markdown 为章节路径,PDF 为「第 N 页」,Excel 为工作表名,TXT 不显示位置。
  • 只用了问答的回答,不附出处。
  • 出处文字会自动整理:文档名与位置里的换行折成空格,@ 与方括号换成全角符号,文档名最多保留 80 字、位置最多 120 字,超出部分以「…」截断,避免文件名或标题里的特殊字符在回复里产生提及或链接。
  • 回答中途因模型接口断开而没写完时,不再追加出处,对话记录里也不带出处。
  • 文档名可能对客户可见。 内部文件名(如带项目代号、报价口径的名字)请谨慎开启,建议给文档起对客户友好的文件名。
  • 工作流知识检索节点与开放 API 不会追加「参考」文字;开放 API 的同步响应里,sources 字段带有文档名与位置,由调用方自行处理(仅同步响应;流式响应不返回来源列表)。

详见智能体与提示词。

在命中分析里看原文,并转成问答

旗舰版命中分析里,可以用「用到原文」筛选对话,打开「命中详情」,按顺序看到交给模型的每条参考内容是「问答」还是「原文」,以及相关度和更新日期。常被问到的原文,可以点「转成问答」,在预填好的弹窗里修改后保存为普通知识(需要有知识库权限)。原文段落本身不受影响。

常见问题

文档失败原因显示「系统繁忙,请点击『重试』」? 同一企业同时上传、处理多份文档时,偶尔会因数据库锁冲突而处理失败,不是文件本身的问题,点「重试」即可。

同时上传同名文档会怎样? 两个同名上传几乎同时到达时,先到的先入库;后到的若已选「作为新版本替换」或「另存为新文档」,会按所选方式继续(另存会自动加序号);未选择方式的,提示已有同名文档,请重新选择。

上传后一直处理中? 通常几分钟内完成;超过 30 分钟会自动转为失败(原因「处理超时」),点「重试」即可。

降到基础版后文档会丢吗? 不会。降级后文档标「套餐不支持」,不再参与回答,也不能手动启用;页面仍可进入,只能查看、下载原文件和删除,其余操作置灰并显示套餐提示,也不能放弃新版本。升级回专业版或旗舰版后,各文档自动恢复为降级前的状态(启用或停用),无需重新上传。降级期间有效期照常计时。

可以经开放 API / MCP 上传或管理文档吗? 目前不可以,文档上传与管理只在控制台进行。

相关阅读