使用企业知识空间-云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

适用范围

企业知识空间的引擎层为PolarDB一体化架构核心，包含编排引擎、智能搜索（PolarSearch）索引存储（倒排+向量库）和PolarDB PostgreSQL版（元数据管理）。目前支持地域与可用区如下：

地域	可用区
华东1（杭州）	可用区I、可用区J、可用区K
华东2（上海）	可用区E、可用区F、可用区L、可用区N
华北2（北京）	可用区F、可用区L、可用区I、可用区K
华南1（深圳）	可用区C、可用区D、可用区F
华北6（乌兰察布）	可用区B、可用区C
新加坡	可用区A、可用区B

创建知识空间

您可在PolarDB Agent Express控制台创建知识空间。创建知识空间后，会自动关联创建PolarDB集群，您可在知识空间详情页面查看关联的PolarDB集群。

警告

请勿在目标PolarDB集群中修改或删除企业知识空间自动创建的doc_search账号与polar_rag_meta数据库。

登录PolarDB控制台。
在左侧导航栏，选择PolarDB AI > PolarDB 企业知识空间。
单击新建知识空间。

在创建对话框中配置以下参数。

参数	是否必填	说明
知识空间名称	是	输入知识空间的名称，最大128个字符。
知识空间备注	否	输入知识空间的备注信息，最大512个字符。
向量模型	是	选择向量模型。默认使用`text-embedding-v4`。创建后不可变更。
向量维度	是	设置向量维度，需与所选向量模型匹配。默认`1024`。
排序模型	否	选择排序模型，用于对检索结果重排序。默认`qwen3-rerank`，可选`gte-rerank-v2`。
分片策略	是	选择文档分片策略。默认智能分片。
分片大小（tokens）	否	设置单个分片的最大Token数。默认`512`。
OSS Bucket	是	输入OSS Bucket名称，用于存放原始文档数据。
OSS AK	是	输入OSS AccessKey ID。
OSS SK	是	输入OSS AccessKey Secret。
VPC 网络	是	选择VPC网络。
可用区及交换机	是	选择可用区和交换机，请选择符合适用范围的可用区。

单击确定。

开通公网访问能力

创建公网NAT网关：请前往NAT 网关 - 公网 NAT 网关购买页进行创建。在创建过程中，请确保选择与企业知识空间相同的VPC和交换区。
配置SNAT条目：前往公网 NAT 网关页面。单击目标网关操作列的设置SNAT，单击创建SNAT条目。参数请按如下配置：
- SNAT条目粒度：VPC粒度。
- 选择弹性公网IP地址：在下拉列表中选择提供公网访问的EIP。

说明

开通公网访问能力将产生相关的公网NAT网关及公网流量费用。相关费用说明，请参见NAT 网关计费。

管理知识空间

创建知识空间后，您可以在企业知识空间页签中查看和管理已有的知识空间。

编辑知识空间

在知识空间卡片上，单击编辑，可修改知识空间的名称和备注信息。

删除知识空间

警告

删除知识空间会同时删除空间下的全部关联资源（索引、Pipeline、模型和Connector），且不可恢复。请谨慎操作。

在知识空间卡片上，单击删除，在弹出的确认对话框中单击删除。

查看知识空间详情

在知识空间卡片上，单击查看详情，进入空间管理页面。该页面展示知识空间的基本信息（向量模型、维度、排序模型、分片策略、OSS Bucket等）以及空间下的知识库列表。

创建和管理知识库

知识库是知识空间内的逻辑分组单元，用于组织和管理文档。一个知识空间下可创建多个知识库。

创建知识库

在知识空间详情页面，单击新建知识库。

在创建对话框中配置以下参数。

参数	是否必填	说明
知识库名称	是	输入知识库的名称，最大128个字符。
备注	否	输入知识库的备注信息，最大512个字符。
检索模式	是	选择检索模式。可选：均衡模式（默认，BM25 50% + KNN 50%）精确模式（BM25 70% + KNN 30%）语义模式（BM25 30% + KNN 70%） KNN 模式（纯向量检索） RRF 融合（排名融合）

单击创建。

编辑知识库

在知识库卡片上，单击编辑，可修改知识库的名称、检索模式和备注信息。

删除知识库

在知识库卡片上，单击删除，在弹出的确认对话框中单击删除。

上传与管理文档

您可以通过控制台上传文档，也可以将文件上传到知识库对应的OSS路径。上传后系统自动完成文档解析、分块和向量化索引。

通过控制台上传

在知识空间详情页面，单击目标知识库进入知识库详情页面。
在文件概览页签中，单击上传文件。
在上传对话框中选择文件，单击确定。单个文件最大支持5 GB。

通过OSS上传

您也可以将文件直接上传到知识库对应的OSS路径，路径格式为：

oss://<Bucket名称>/<知识空间ID>/<知识库ID>/

例如：oss://my-rag-bucket/space_001/kb_001/report.pdf

文档同步

通过OSS上传的文件会定时自动同步到知识库。如需立即同步，可在知识库详情页面的文件概览页签中，单击触发同步进行手动同步。

文档处理状态

上传的文档在处理过程中会经历以下状态：

状态	说明
排队中	已提交，等待分配处理资源。
切片中	正在对文档进行分片处理。
向量化中	正在生成向量索引。
成功	文档处理完成，可用于检索。
失败	处理失败，请检查文件格式或联系技术支持。

查看文档分片

在对应的文档列上，单击查看分片，您可在弹出的窗口中查看当前文档具体分片详情。

删除文档

警告

删除文档会同步删除您OSS Bucket（<Bucket名称>/<知识空间ID>/<知识库ID>/）中文档，且不可恢复。请谨慎操作。

在对应的文档列上，单击删除，在弹出的确认对话框中单击删除。

检索测试

文档处理完成后，您可以在知识库详情页面测试检索效果。

在知识库详情页面，单击检索测试页签。

配置检索参数。

参数	说明
查询语句	输入需要检索的文本内容。
检索方式	选择向量检索或关键词检索。
返回条数 (Top-K)	设置返回的最相关结果数量。
相似度阈值	设置最低相似度阈值，低于此值的结果将被过滤。
重排序	选择是否启用排序模型对结果重排序。可选开启 - 使用排序模型或关闭。

单击开始检索，在检索结果区域查看匹配的文档片段，包括来源文件、相似度分数和片段内容。