知识库
本文介绍如何在阿里云控制台开通并试用知识库。您将完成 RAM 授权、创建资源、导入数据、检查切片、执行检索验证、体验对话和发布版本。全流程均可在向量检索服务 Milvus 版控制台完成,无需编写代码。
完成本文后,您将获得一个可以导入企业文档、生成向量索引并返回相关切片的知识库,还可以继续通过 API 或 SDK 将其接入客服问答、内容搜索、研发助手等业务。
知识库是什么
知识库用于按场景或领域集中管理文档、表格、图片、音频和视频等知识内容。系统会解析导入的数据,将内容拆分为切片并生成向量,查询时再从中召回与问题相关的切片。
控制台将知识库使用流程组织为“创建、上传文件、检索验证、API 调用”四个阶段。首次体验时,建议先完成一个小规模资源的端到端验证,再逐步扩大数据量并调整处理策略。
知识库适合以下典型场景:
-
企业制度、产品手册和技术文档的语义搜索。
-
基于导入内容回答问题的 RAG 应用。
-
客服、售后、研发或运营场景的智能助手。
-
结构化表格数据的按行切片、向量检索与条件过滤。
知识库试用流程
一次完整的知识库试用包括以下环节:
-
为 RAM 用户授予访问权限,并确认账号已加入免费邀测白名单。
-
在目标地域和业务空间中创建资源,配置数据类型、向量模型、CU 规格和网络。
-
向知识库导入测试文件,等待数据完成解析、切片和索引构建。
-
抽查切片内容,再通过检索验证和对话体验检查实际效果。
-
效果确认后发布版本,或通过 API、SDK 把服务接入生产业务。
建议准备一份内容清晰、包含明确问答依据的测试文件,并提前设计 3~5 个可以从原文中找到答案的问题。这样更容易判断知识库召回是否准确。
知识库前提条件与可用地域
-
已注册阿里云账号。使用 RAM 用户操作时,需先完成下文的授权。
-
知识库当前处于免费邀测阶段,需由后台为您的阿里云账号添加白名单后方可使用。如需申请试用名额,请联系技术支持。
-
已准备一个可用的专有网络 VPC 和交换机,创建页面也支持跳转新建。
-
已准备一个符合所选数据类型要求的本地测试文件。
知识库当前在华东1(杭州)、华北2(北京)、华北3(张家口)、华南1(深圳)提供服务。建议在华东1(杭州)试用,其他地域的对话体验所依赖的对话模型与重排模型可能尚未就绪,详见下文常见问题。
步骤一:为 RAM 用户授权知识库
使用阿里云账号(主账号)操作时可跳过本步骤。使用 RAM 用户操作时,需为该用户授予访问权限。
-
登录 RAM 控制台。
-
在左侧导航栏选择身份管理 > 用户。
-
找到目标 RAM 用户,单击新增授权。
-
搜索并选中系统策略
AliyunMilvusFullAccess,然后单击确定。
授予 AliyunMilvusFullAccess 后,RAM 用户即可完成创建知识库、导入数据和执行检索等操作,无需另外创建自定义策略。若相关操作因权限不足失败,接口通常会返回 403 Permission denied by RAM authentication。
步骤二:进入知识库服务并选择业务空间
-
在控制台顶部切换到服务可用地域。
-
在左侧导航栏单击知识库服务。
-
在页面顶部确认当前业务空间。未创建其他空间时,可使用默认业务空间。
知识库列表只展示当前业务空间下的资源。
列表包含名称和 ID、状态、类型、数据类型、数据数量、切片数量、版本数量与创建时间,并提供名称搜索、状态筛选和刷新功能。若列表中已有资源,可单击管理进入详情页。
步骤三:创建知识库
-
在列表页单击创建知识库。
-
完成下表中的配置。
-
检查页面右侧的配置概览,然后单击创建知识库。
|
配置项 |
配置说明 |
|
名称 |
2~64 个字符,同一租户内唯一,按页面提示填写不含中文的名称。 |
|
数据类型 |
创建后不可更改。全模态知识库按文档版面解析分段,支持 |
|
向量模型 |
创建后不可更改。首次试用建议使用内置模型,默认 |
|
规格配置 |
必选。最小规格为 4CU(4 vCPU / 16 GiB),创建后可在详情页的资源配置区域调整。 |
|
网络配置 |
必选。选择业务常用的专有网络与交换机,也可从页面跳转创建。 |
|
标签字段定义 |
可选,位于高级配置中,最多定义 180 个字段,用于导入数据时标注并支持检索过滤。首次试用可跳过。 |
提交后返回列表,等待状态由创建中变为运行中,通常需要几分钟。只有资源进入运行中状态后,才继续导入测试数据。
免费邀测阶段不收取该服务费用。创建页配置概览中显示的单价与预估日费用为 0,正式商业化后的收费规则以商业化说明为准。
步骤四:查看知识库概览与处理策略
在知识库列表中单击目标资源的管理,进入详情页。详情页顶部展示运行状态与待发布变更,并提供概览、数据管理、切片管理、版本管理、检索验证和对话体验页签。
在概览页签中,您可以检查以下信息:
-
基础统计:数据数量、切片数量和版本数量。
-
基本信息:名称、知识库 ID、数据类型、类型、向量化模型、创建时间和描述。
-
资源配置:CU 规格、CPU、内存和标签,可单击修改 CU 配置调整资源。
-
处理策略:默认策略使用智能切分,最大长度为 512 个字符;也可单击创建策略添加自定义策略。
处理策略直接影响知识库切片粒度与检索效果。最大长度的单位是字符,不是 token。测试文件较长时,建议先使用默认策略完成基线验证,再根据召回结果调整。
步骤五:向知识库导入数据
-
在知识库详情页单击数据管理页签。
-
单击导入数据,按页面提示选择本地文件并提交。
-
返回数据列表,观察状态并等待解析完成。
-
确认列表中的切片数大于 0。
数据管理列表会展示数据名称、状态、切片数、处理策略、标签、导入时间和导入方式。系统需要依次完成文件注册、内容解析、切片和索引构建,因此大文件的处理时间通常更长。
选择文件前,请确认格式与创建时选择的数据类型一致。结构化类型只接受 xls、xlsx、csv;如果要导入 PDF、图片、Markdown 或音视频,请使用全模态类型。
步骤六:检查知识库切片与解析结果
导入完成后,建议先检查知识库解析结果,再进行检索与问答验证。
-
在数据管理页签确认数据状态正常且切片数大于 0。
-
单击切片管理页签。
-
查看切片 ID、切片内容、来源数据和字数,确认正文已被正确提取。
-
抽查包含测试问题答案的片段,确认上下文完整、没有明显乱码或错误断句。
-
如有需要,单击添加切片手动补充内容。
图片类数据会先通过 OCR 识别为文本再入库。即使识别文本很少或存在错误,数据状态仍可能显示处理完成,因此上传图片后务必抽查切片文本。
如果切片过长,检索结果可能包含大量无关上下文;如果切片过短,答案所需信息可能被拆散。此时可回到概览创建更合适的处理策略,并重新导入数据进行对比。
步骤七:执行知识库检索验证
-
在详情页单击检索验证页签。
-
在检索参数中确认版本为当前编辑。
-
首次验证可保留默认参数,也可按需调整 TopK、语义检索权重、重排模型和筛选范围。
-
输入一个可以从测试文件中找到答案的问题,然后单击执行检索。
-
查看召回分数、来源数据名称和切片序号,确认结果与问题相关。
当命中的切片包含正确答案依据时,说明知识库的导入、向量化与检索链路已经连通。建议同时测试原文关键词、同义改写和口语化提问,观察该服务在不同表达方式下的召回稳定性。
版本选择当前编辑时,检索的是尚未发布的草稿内容,因此无需先发布版本即可验证效果。确认效果符合预期后,再发布版本对外提供稳定服务。
步骤八:体验知识库对话问答
对话体验会在检索基础上调用大模型生成回答,可用于验证知识库问答效果,无需自行接入大模型。
-
在知识库详情页单击对话体验,然后单击新建对话。
-
首次试用可保留默认参数:对话模型使用租户默认模型,知识库版本为
DRAFT,多轮问题改写默认开启。 -
在输入框中输入问题后按 Enter 发送;按 Shift + Enter 可换行。
-
查看回答,并通过回答角标展开参考来源,核对引用切片是否来自正确文档。
-
展开改写后的检索问题,查看多轮对话中实际用于知识库检索的问题。
如需进一步调优,可修改以下知识库对话参数:
-
对话引导:自定义系统提示词,最多 16384 个字符。
-
检索参数:Result count、Candidate count、Min score、Semantic weight。
-
生成参数:Temperature、Top P、Max tokens。
左侧参数的修改会在发送下一条消息时保存到当前会话。若检索验证正常但知识库对话失败,通常需要检查当前地域的对话模型和重排模型是否可用。
步骤九:发布知识库版本并接入业务
知识库内容在导入、添加、修改或删除后会形成待发布变更。完成验证后,可执行以下操作:
-
在详情页顶部单击查看变更,确认新增、修改和删除的内容。
-
单击发布版本,将当前草稿发布为可稳定检索的知识库版本。
-
在版本管理页签查看发布记录,并按需使用版本对比检查差异。
-
通过 API 或 SDK 将知识库集成到业务应用,实现端到端知识问答。
草稿适合持续编辑与测试,已发布版本适合业务调用和效果复现。正式接入前,建议记录知识库 ID、版本、检索参数和测试问题,便于后续排查结果差异。
知识库试用验收清单
完成操作后,可使用以下清单验收知识库:
-
知识库状态为运行中,数据数量和切片数量符合预期。
-
数据状态正常,关键内容能在切片管理中查看。
-
使用原文关键词提问时,检索结果命中正确切片。
-
使用同义改写提问时,知识库仍能返回相关内容。
-
对话回答能够展示参考来源,且引用与回答内容一致。
-
待发布变更已经确认,目标版本已经成功发布。
知识库常见问题
-
左侧导航栏没有知识库服务,或单击后返回概览页,怎么办?
该入口在各地域均可见,但知识库仅在华东1(杭州)、华北2(北京)、华北3(张家口)、华南1(深圳)可用。在其他地域单击后会返回控制台概览页。请先切换到可用地域;若仍无法使用,请确认账号是否已加入邀测白名单。
-
创建资源后为什么一直处于创建中?
创建过程需要准备计算、存储和网络资源,请先等待几分钟并单击刷新。如果长时间没有进入运行中状态,请检查所选 VPC、交换机和资源配额,并联系技术支持。
-
知识库数据一直处于处理中,或切片数为 0,怎么办?
请确认文件格式与数据类型匹配。结构化知识库仅支持
xls、xlsx、csv,导入图片等其他格式会失败。若使用私有或外部模型,还需确认模型服务可正常调用。 -
知识库检索结果不准确,如何优化?
先在切片管理中确认答案依据是否已被正确解析,再对比不同处理策略和切片长度。随后逐步调整 TopK、语义检索权重、重排模型和筛选范围,每次只改变一个知识库参数,便于判断效果变化来自哪里。
-
知识库对话体验报错 404 或提示模型不存在,但检索验证正常,是什么原因?
这表示知识库检索链路正常,但生成环节依赖的对话模型在当前地域不可用。若重排模型显示为不使用重排且没有可选项,通常说明该地域的模型尚未就绪。建议切换到华东1(杭州)试用,或联系技术支持确认模型可用性。
-
试用阶段会产生费用吗?
免费邀测阶段不收取知识库服务费用。若使用私有或外部模型,模型服务本身的调用费用由模型服务提供方计收。