使用企业知识空间-云原生数据库 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控制台创建知识空间。创建知识空间后，会自动关联创建相应的PolarDB集群，您可在知识空间详情页面查看关联的PolarDB集群。

警告

每个知识空间对应一个专属的新建PolarDB集群，无法选择或关联已有的PolarDB集群。
请勿在目标PolarDB集群中修改或删除企业知识空间自动创建的doc_search账号与polar_rag_meta数据库。

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

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

参数	是否必填	说明
知识空间名称	是	输入知识空间的名称，最大128个字符。
知识空间备注	否	输入知识空间的备注信息，最大512个字符。
数据库类型	是	选择数据库类型。默认为MySQL，请修改为PostgreSQL。创建后不可修改。
大语言模型	是	选择大语言模型。可选值由平台动态提供，随地域不同而有所差异。
向量模型	是	选择向量模型。默认使用`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网络。
可用区及交换机	是	选择可用区和交换机，请选择符合适用范围的可用区。
文档 ACL	否	开启后创建权限感知空间，所有检索请求均执行文档级 ACL 过滤。关闭后创建开放空间，不执行文档级 ACL 过滤。该配置仅在创建知识空间时可设置，创建后不可变更。请在创建前根据业务的权限管理需求确认是否开启。默认关闭。

单击确定。

开通公网访问能力

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

说明

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

管理知识空间

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

编辑知识空间

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

删除知识空间

警告

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

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

查看知识空间详情

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

说明

ACL 模式用于确认该知识空间是否启用文档级权限校验，取值由创建知识空间时的文档 ACL 决定，创建后不可修改。
PolarDB 实例为链接，单击后可进入对应PolarDB集群的基本信息页面，用于获取后续接入 MCP Server 时需要的搜索节点地址。

创建和管理知识库

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

创建知识库

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

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

参数	是否必填	说明
知识库名称	是	输入知识库的名称，最大128个字符。
备注	否	输入知识库的备注信息，最大512个字符。
检索模式	是	选择检索模式。可选：均衡模式（默认，BM25 50% + KNN 50%）精确模式（BM25 70% + KNN 30%）语义模式（BM25 30% + KNN 70%） KNN 模式（纯向量检索） RRF 融合（排名融合）
知识库类型	是	选择知识库的访问范围。可选：公共（默认）：面向知识空间内已授权用户开放。上传者获得管理权限，其他已授权用户获得只读权限。私有：仅知识库所有者可访问，适用于个人资料、工作笔记和草稿等私有内容。个人知识库仅支持在开启了文档 ACL 的权限感知空间中创建。需要在MCP Server的中实例页面执行分配所有者并激活后才可使用。

单击创建。

编辑知识库

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

删除知识库

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

上传与管理文档

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

说明

若知识空间已开启文档 ACL，不同接入方式的权限来源如下：

通过控制台上传或 OSS 同步的文档，系统依据知识库类型自动派生访问范围，公共知识库面向空间内已授权用户开放，个人知识库仅授权所有者，无需手动配置文档 ACL
通过添加同步链路接入的企业内容源（如飞书、SharePoint）会携带源端 ACL，用户、用户组和部门被映射为规范化权限主体并随文档同步至检索索引
通过 MCP Tool 上传的文档，由服务端依据已认证身份和知识库策略生成可信权限上下文，客户端不能指定权限主体或覆盖身份信息。开放空间不执行文档级 ACL 过滤，但仍受知识库准入和空间绑定关系约束。

通过控制台上传

在知识空间详情页面，单击目标知识库进入知识库详情页面。
在文件概览页签中，单击上传文件。
在上传对话框中选择文件，单击确定。单个文件最大支持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)	设置返回的最相关结果数量。
相似度阈值	设置最低相似度阈值，低于此值的结果将被过滤。
重排序	选择是否启用排序模型对结果重排序。可选开启 - 使用排序模型或关闭。

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