知识库

更新时间:
复制 MD 格式

本文介绍如何在阿里云控制台开通并试用知识库。您将完成 RAM 授权、创建资源、导入数据、检查切片、执行检索验证、体验对话和发布版本。全流程均可在向量检索服务 Milvus 版控制台完成,无需编写代码。

完成本文后,您将获得一个可以导入企业文档、生成向量索引并返回相关切片的知识库,还可以继续通过 API 或 SDK 将其接入客服问答、内容搜索、研发助手等业务。

知识库是什么

知识库用于按场景或领域集中管理文档、表格、图片、音频和视频等知识内容。系统会解析导入的数据,将内容拆分为切片并生成向量,查询时再从中召回与问题相关的切片。

控制台将知识库使用流程组织为“创建、上传文件、检索验证、API 调用”四个阶段。首次体验时,建议先完成一个小规模资源的端到端验证,再逐步扩大数据量并调整处理策略。

知识库适合以下典型场景:

  • 企业制度、产品手册和技术文档的语义搜索。

  • 基于导入内容回答问题的 RAG 应用。

  • 客服、售后、研发或运营场景的智能助手。

  • 结构化表格数据的按行切片、向量检索与条件过滤。

知识库试用流程

一次完整的知识库试用包括以下环节:

  1. 为 RAM 用户授予访问权限,并确认账号已加入免费邀测白名单。

  2. 在目标地域和业务空间中创建资源,配置数据类型、向量模型、CU 规格和网络。

  3. 向知识库导入测试文件,等待数据完成解析、切片和索引构建。

  4. 抽查切片内容,再通过检索验证和对话体验检查实际效果。

  5. 效果确认后发布版本,或通过 API、SDK 把服务接入生产业务。

建议准备一份内容清晰、包含明确问答依据的测试文件,并提前设计 3~5 个可以从原文中找到答案的问题。这样更容易判断知识库召回是否准确。

知识库前提条件与可用地域

  • 已注册阿里云账号。使用 RAM 用户操作时,需先完成下文的授权。

  • 知识库当前处于免费邀测阶段,需由后台为您的阿里云账号添加白名单后方可使用。如需申请试用名额,请联系技术支持。

  • 已准备一个可用的专有网络 VPC 和交换机,创建页面也支持跳转新建。

  • 已准备一个符合所选数据类型要求的本地测试文件。

重要

知识库当前在华东1(杭州)、华北2(北京)、华北3(张家口)、华南1(深圳)提供服务。建议在华东1(杭州)试用,其他地域的对话体验所依赖的对话模型与重排模型可能尚未就绪,详见下文常见问题。

步骤一:为 RAM 用户授权知识库

使用阿里云账号(主账号)操作时可跳过本步骤。使用 RAM 用户操作时,需为该用户授予访问权限。

  1. 登录 RAM 控制台。

  2. 在左侧导航栏选择身份管理 > 用户。

  3. 找到目标 RAM 用户,单击新增授权。

  4. 搜索并选中系统策略 AliyunMilvusFullAccess,然后单击确定。

说明

授予 AliyunMilvusFullAccess 后,RAM 用户即可完成创建知识库、导入数据和执行检索等操作,无需另外创建自定义策略。若相关操作因权限不足失败,接口通常会返回 403 Permission denied by RAM authentication。

步骤二:进入知识库服务并选择业务空间

  1. 登录向量检索服务 Milvus 版控制台。

  2. 在控制台顶部切换到服务可用地域。

  3. 在左侧导航栏单击知识库服务。

  4. 在页面顶部确认当前业务空间。未创建其他空间时,可使用默认业务空间。

说明

知识库列表只展示当前业务空间下的资源。

列表包含名称和 ID、状态、类型、数据类型、数据数量、切片数量、版本数量与创建时间,并提供名称搜索、状态筛选和刷新功能。若列表中已有资源,可单击管理进入详情页。

步骤三:创建知识库

  1. 在列表页单击创建知识库。

  2. 完成下表中的配置。

  3. 检查页面右侧的配置概览,然后单击创建知识库。

配置项

配置说明

名称

2~64 个字符,同一租户内唯一,按页面提示填写不含中文的名称。

数据类型

创建后不可更改。全模态知识库按文档版面解析分段,支持 mp4、mp3、png、pdf、ppt、txt、markdown、docs、xlsx、csv、jsonl、faq;结构化知识库按表格行生成切片,仅支持 xls、xlsx、csv。首次试用建议选择全模态类型。

向量模型

创建后不可更改。首次试用建议使用内置模型,默认 text-embedding-v3,向量维度自动显示 1024。

规格配置

必选。最小规格为 4CU(4 vCPU / 16 GiB),创建后可在详情页的资源配置区域调整。

网络配置

必选。选择业务常用的专有网络与交换机,也可从页面跳转创建。

标签字段定义

可选,位于高级配置中,最多定义 180 个字段,用于导入数据时标注并支持检索过滤。首次试用可跳过。

提交后返回列表,等待状态由创建中变为运行中,通常需要几分钟。只有资源进入运行中状态后,才继续导入测试数据。

重要

免费邀测阶段不收取该服务费用。创建页配置概览中显示的单价与预估日费用为 0,正式商业化后的收费规则以商业化说明为准。

步骤四:查看知识库概览与处理策略

在知识库列表中单击目标资源的管理,进入详情页。详情页顶部展示运行状态与待发布变更,并提供概览、数据管理、切片管理、版本管理、检索验证和对话体验页签。

在概览页签中,您可以检查以下信息:

  • 基础统计:数据数量、切片数量和版本数量。

  • 基本信息:名称、知识库 ID、数据类型、类型、向量化模型、创建时间和描述。

  • 资源配置:CU 规格、CPU、内存和标签,可单击修改 CU 配置调整资源。

  • 处理策略:默认策略使用智能切分,最大长度为 512 个字符;也可单击创建策略添加自定义策略。

处理策略直接影响知识库切片粒度与检索效果。最大长度的单位是字符,不是 token。测试文件较长时,建议先使用默认策略完成基线验证,再根据召回结果调整。

步骤五:向知识库导入数据

  1. 在知识库详情页单击数据管理页签。

  2. 单击导入数据,按页面提示选择本地文件并提交。

  3. 返回数据列表,观察状态并等待解析完成。

  4. 确认列表中的切片数大于 0。

数据管理列表会展示数据名称、状态、切片数、处理策略、标签、导入时间和导入方式。系统需要依次完成文件注册、内容解析、切片和索引构建,因此大文件的处理时间通常更长。

选择文件前,请确认格式与创建时选择的数据类型一致。结构化类型只接受 xls、xlsx、csv;如果要导入 PDF、图片、Markdown 或音视频,请使用全模态类型。

步骤六:检查知识库切片与解析结果

导入完成后,建议先检查知识库解析结果,再进行检索与问答验证。

  1. 在数据管理页签确认数据状态正常且切片数大于 0。

  2. 单击切片管理页签。

  3. 查看切片 ID、切片内容、来源数据和字数,确认正文已被正确提取。

  4. 抽查包含测试问题答案的片段,确认上下文完整、没有明显乱码或错误断句。

  5. 如有需要,单击添加切片手动补充内容。

图片类数据会先通过 OCR 识别为文本再入库。即使识别文本很少或存在错误,数据状态仍可能显示处理完成,因此上传图片后务必抽查切片文本。

如果切片过长,检索结果可能包含大量无关上下文;如果切片过短,答案所需信息可能被拆散。此时可回到概览创建更合适的处理策略,并重新导入数据进行对比。

步骤七:执行知识库检索验证

  1. 在详情页单击检索验证页签。

  2. 在检索参数中确认版本为当前编辑。

  3. 首次验证可保留默认参数,也可按需调整 TopK、语义检索权重、重排模型和筛选范围。

  4. 输入一个可以从测试文件中找到答案的问题,然后单击执行检索。

  5. 查看召回分数、来源数据名称和切片序号,确认结果与问题相关。

当命中的切片包含正确答案依据时,说明知识库的导入、向量化与检索链路已经连通。建议同时测试原文关键词、同义改写和口语化提问,观察该服务在不同表达方式下的召回稳定性。

版本选择当前编辑时,检索的是尚未发布的草稿内容,因此无需先发布版本即可验证效果。确认效果符合预期后,再发布版本对外提供稳定服务。

步骤八:体验知识库对话问答

对话体验会在检索基础上调用大模型生成回答,可用于验证知识库问答效果,无需自行接入大模型。

  1. 在知识库详情页单击对话体验,然后单击新建对话。

  2. 首次试用可保留默认参数:对话模型使用租户默认模型,知识库版本为 DRAFT,多轮问题改写默认开启。

  3. 在输入框中输入问题后按 Enter 发送;按 Shift + Enter 可换行。

  4. 查看回答,并通过回答角标展开参考来源,核对引用切片是否来自正确文档。

  5. 展开改写后的检索问题,查看多轮对话中实际用于知识库检索的问题。

如需进一步调优,可修改以下知识库对话参数:

  • 对话引导:自定义系统提示词,最多 16384 个字符。

  • 检索参数:Result count、Candidate count、Min score、Semantic weight。

  • 生成参数:Temperature、Top P、Max tokens。

左侧参数的修改会在发送下一条消息时保存到当前会话。若检索验证正常但知识库对话失败,通常需要检查当前地域的对话模型和重排模型是否可用。

步骤九:发布知识库版本并接入业务

知识库内容在导入、添加、修改或删除后会形成待发布变更。完成验证后,可执行以下操作:

  1. 在详情页顶部单击查看变更,确认新增、修改和删除的内容。

  2. 单击发布版本,将当前草稿发布为可稳定检索的知识库版本。

  3. 在版本管理页签查看发布记录,并按需使用版本对比检查差异。

  4. 通过 API 或 SDK 将知识库集成到业务应用,实现端到端知识问答。

草稿适合持续编辑与测试,已发布版本适合业务调用和效果复现。正式接入前,建议记录知识库 ID、版本、检索参数和测试问题,便于后续排查结果差异。

知识库试用验收清单

完成操作后,可使用以下清单验收知识库:

  • 知识库状态为运行中,数据数量和切片数量符合预期。

  • 数据状态正常,关键内容能在切片管理中查看。

  • 使用原文关键词提问时,检索结果命中正确切片。

  • 使用同义改写提问时,知识库仍能返回相关内容。

  • 对话回答能够展示参考来源,且引用与回答内容一致。

  • 待发布变更已经确认,目标版本已经成功发布。

知识库常见问题

  1. 左侧导航栏没有知识库服务,或单击后返回概览页,怎么办?

    该入口在各地域均可见,但知识库仅在华东1(杭州)、华北2(北京)、华北3(张家口)、华南1(深圳)可用。在其他地域单击后会返回控制台概览页。请先切换到可用地域;若仍无法使用,请确认账号是否已加入邀测白名单。

  2. 创建资源后为什么一直处于创建中?

    创建过程需要准备计算、存储和网络资源,请先等待几分钟并单击刷新。如果长时间没有进入运行中状态,请检查所选 VPC、交换机和资源配额,并联系技术支持。

  3. 知识库数据一直处于处理中,或切片数为 0,怎么办?

    请确认文件格式与数据类型匹配。结构化知识库仅支持 xls、xlsx、csv,导入图片等其他格式会失败。若使用私有或外部模型,还需确认模型服务可正常调用。

  4. 知识库检索结果不准确,如何优化?

    先在切片管理中确认答案依据是否已被正确解析,再对比不同处理策略和切片长度。随后逐步调整 TopK、语义检索权重、重排模型和筛选范围,每次只改变一个知识库参数,便于判断效果变化来自哪里。

  5. 知识库对话体验报错 404 或提示模型不存在,但检索验证正常,是什么原因?

    这表示知识库检索链路正常,但生成环节依赖的对话模型在当前地域不可用。若重排模型显示为不使用重排且没有可选项,通常说明该地域的模型尚未就绪。建议切换到华东1(杭州)试用,或联系技术支持确认模型可用性。

  6. 试用阶段会产生费用吗?

    免费邀测阶段不收取知识库服务费用。若使用私有或外部模型,模型服务本身的调用费用由模型服务提供方计收。