如何接入企业知识权限与身份 - 云原生数据库 PolarDB

当企业知识库需要向不同部门、不同角色的员工与 AI Agent 开放时，检索结果必须按调用者身份过滤，无权内容不能进入大模型上下文。企业知识空间支持权限感知能力，通过PolarDB Agentic Server接入企业身份目录，AI Agent 以当前调用者身份执行检索，无权访问的文档不参与召回。本文介绍从创建权限感知知识空间到员工完成权限感知访问的端到端操作路径。

业务场景

企业将分散于飞书、SharePoint、本地文件系统的文档汇聚到知识空间后，面临分级授权诉求：财务、人事、研发等敏感内容仅允许对应人员检索，公共制度与全员知识则需要域内共享。权限感知能力在知识空间、知识库和文档三个层级建立访问控制：知识空间在创建时确定 ACL 模式，知识库按公共或私有划分准入范围，文档级 ACL 在检索召回阶段执行过滤。完成本教程后：

管理员创建权限感知知识空间与知识库，接入携带源端 ACL 的企业文档，并部署 PolarDB Agentic Server 对接企业身份目录。
员工以企业身份签发个人 Token，使用 Qoder、Claude Code 等支持 MCP 的 AI Agent 客户端发起权限感知检索，检索结果附带来源文件与页码等溯源信息，且全程可审计。

方案架构

权限感知链路由两个操作面组成：

PolarDB控制台：负责知识空间与知识库的创建和管理。创建知识空间时开启文档 ACL后，该空间成为权限感知空间（ACL Enforced），所有检索请求均执行文档级权限校验。文档入库时携带源端 ACL 或由系统按知识库类型派生权限。
PolarDB Agentic Server 管理面板：PolarDB Agentic Server（PolarRAG MCP Server）是企业身份与 AI Agent 之间的可信访问网关，负责企业身份来源接入、Agent 绑定与个人 Token 签发，并完成 SSO/OIDC 身份认证、组织关系解析与权限上下文构造。检索请求的调用链路如下：
- 员工通过企业身份认证，获取与个人身份绑定的 Token。
- AI Agent 使用该 Token 调用 MCP 检索工具。
- PolarDB Agentic Server 解析用户身份及其所属用户组、部门，在服务端构造可信权限上下文，调用 PolarDB 检索服务。客户端不能指定权限主体或覆盖身份信息。
- PolarDB 在召回阶段执行知识库准入与文档级 ACL 过滤，仅返回当前身份有权访问的内容。
AI Agent 不持有独立的数据访问权限，始终以当前调用者身份执行检索。知识空间服务与向量存储部署在客户绑定的 VPC 内，原始文档保留于客户 OSS Bucket，索引构建与检索均在客户数据域内完成。

准备工作

本教程由管理员与员工协作完成：步骤一至步骤二由管理员在PolarDB控制台完成，步骤三至步骤五由管理员在PolarDB Agentic Server管理面板完成，步骤六与步骤七由员工完成。开始操作前，请确认以下资源与信息已准备就绪：

网络与计算资源：
- 创建知识空间时需要选择VPC网络、可用区及交换机、安全组
- 步骤三部署 PolarDB Agentic Server 还需要自行购买一台 ECS，该 ECS需与源PolarDB集群的搜索节点位于同一 VPC。
OSS Bucket 与 AK/SK：
- 创建知识空间时需要绑定 OSS Bucket 并填写 Bucket 名称与 AK/SK
- 步骤三开通通过 MCP Tool 上传文档的能力时同样需要填写OSS AK/SK。
企业身份目录与授权信息：支持的身份来源包括飞书目录、SharePoint（Entra ID）与自建用户系统，创建文档同步链路时需要填写对应平台的授权信息，请提前准备。
员工企业身份账号：员工需要使用飞书、SharePoint 或自建账号等企业身份登录管理面板并签发个人 Token。

实施步骤

端到端路径共七个步骤。

步骤	操作人	操作面	产出
步骤一：新建权限感知知识空间与知识库	管理员	PolarDB控制台	知识空间、知识库、PolarDB 搜索节点地址
步骤二：接入文档数据	管理员	PolarDB 控制台	文档与权限入库，索引就绪
步骤三：部署 PolarDB Agentic Server 并注册搜索节点	管理员	ECS + 管理面板	可供 Agent 连接的 MCP 端点
步骤四：接入企业身份来源	管理员	管理面板	可供 Agent 绑定的用户与部门
步骤五：创建 Agent 并绑定身份与知识空间	管理员	管理面板	已绑定身份、实例与权限的 Agent
步骤六：员工登录并签发个人 Token	员工	管理面板	个人 Token 与 MCP 客户端配置
步骤七：权限感知访问与验证	员工	AI Agent 客户端	按权限过滤、可溯源、可审计的检索结果

步骤一：新建权限感知知识空间与知识库

本步骤创建承载权限感知能力的知识空间与知识库，并获取后续注册搜索节点所需的PolarDB集群搜索节点地址。

登录PolarDB 控制台，在左侧导航栏选择PolarDB AI > PolarDB 企业知识空间。
单击新建知识空间，配置知识空间名称、数据库类型、大语言模型、排序模型、向量模型、向量维度、分片策略，OSS Bucket、OSS AK、OSS SK，并选择VPC 网络、可用区及交换机等信息。
开启文档 ACL，然后单击创建。

重要
知识空间的ACL模式在创建时确定，创建后不可变更，请在创建前充分评估业务后续的权限管理需求。若确认无需文档级权限控制，可保持文档 ACL关闭，创建开放空间（ACL Disabled），以兼容未携带权限元数据的存量数据。
创建完成后进入知识空间详情页，在基本信息区域确认ACL 模式为权限感知空间（ACL Enforced）。

在知识库区域单击新建知识库，填写知识库名称、选择检索模式，并设置知识库类型：

知识库类型	访问范围
公共	面向域内已授权用户开放，上传者获得管理权限，其他域内用户获得只读权限。
私有	仅知识库所有者可访问，用于个人资料、工作笔记和草稿等私有内容。私有知识库仅支持在权限感知空间下创建。

在基本信息区域单击PolarDB 实例链接，进入PolarDB集群基本信息页，记录搜索节点地址。步骤三注册搜索节点时需要该地址。

步骤二：接入文档数据

本步骤将企业文档接入知识库。文档入库并完成索引构建后即可检索。

接入方式

不同接入链路的 ACL 来源不同：

接入链路	ACL 来源
控制台上传、OSS 同步	系统按知识库类型自动派生权限：公共知识库面向域内已授权用户开放，私有知识库仅授权所有者，无需手工配置 ACL。
同步链路（飞书、SharePoint）	连接器读取源端 ACL，将用户、用户组和部门映射为规范化权限主体，随文档同步至检索索引；源端权限变更由同步任务增量传播。
MCP Tool 上传	由服务端根据已认证身份和知识库策略生成权限上下文，客户端不能指定权限主体。

操作步骤

控制台：在知识库详情页的文件概览 > 上传文件手动上传文档或通过OSS自动同步。
接入飞书、SharePoint等企业内容源：在知识库详情页的同步链路页签内，单击添加同步链路，选择IM 平台并填写授权信息后创建同步链路。同步链路表单不包含 ACL 配置项，源端 ACL 随文档自动同步，无需额外配置。

说明
各同步链路详细接入方式，请参见数据同步。
MCP Tool上传：PolarDB Agentic Server为开源项目，需自行购买与PolarDB搜索节点位于同一 VPC 的 ECS 完成部署，数据链路不出安全域。
1. 部署MCP Sever：请参考开源仓库PolarDB Agentic Server 完成部署。
  
  说明
  仓库提供 Agent 辅助部署 Skill (deploy-polardb-agentic-server)，可在 Qoder、Claude Code、Codex 等 AI Agent 内直接调用，完成 Docker Compose 部署，详见一键部署 Skill 文档。
2. 注册实例并接入：配置部署完成后，在PolarDB Agentic Server管理面板中进入实例页面，单击注册实例。填写名称、引擎选择PolarRAG以及步骤一获取的PolarDB搜索节点地址、搜索节点账号密码等。详细接入细节，请参见PolarRAG 接入指南。
  
  说明
  私有知识库需要在实例页面执行分配所有者并激活后才可使用。
3. 配置上传能力：在刚创建的实例中，进入Spaces配置，填写OSS AK/SK，开通MCP Tool上传文档的能力。开通后，员工可通过 AI Agent 直接上传文档到知识库。
完成后，PolarDB Agentic Server 实例就绪，MCP 端点可供 Agent 连接。

步骤四：（MCP Tool接入）接入企业身份来源

在PolarDB Agentic Server管理面板中进入用户页面，配置企业身份源（飞书目录 / SharePoint Entra ID / 自建用户系统），目录每 5 分钟自动同步。身份来源同步完成后，后续创建 Agent 时可一键绑定。飞书 / SharePoint 目录变更 5 分钟内自动同步，无需手动维护用户列表。详细配置方法。请参见企业身份来源配置。

步骤五：（MCP Tool接入）创建 Agent 并绑定身份与知识空间

在PolarDB Agentic Server管理面板中进入Agent页面，单击创建Agent。
进入Agent详情的PolarRAG选项卡，单击配置企业访问，选择企业身份来源、用户或用户组以及目标知识空间，一次性完成 Agent 与企业身份、Agent 与知识空间的绑定。
单击配置 PUBLIC 范围，按需设置不同用户可访问的公共知识库。

完成后，Agent 已绑定身份、实例与权限。详细管理方法，请参见Agent 与 Token 管理。

步骤六：（MCP Tool接入）员工登录并签发个人 Token

本步骤由员工以个人身份完成，为 AI Agent 客户端获取访问凭证。

员工以企业身份（飞书、SharePoint 或自建账号）登录 PolarDB Agentic Server 管理面板。
进入我的实例页面，在目标 Agent 上单击签发 Token，获取个人专属 Token。
复制生成的 MCP JSON 配置，添加到支持 MCP 的 AI Agent 客户端（Qoder、Qwen Code、Claude Code、Codex）的 MCP 配置中。
（可选）单击知识库按钮，查看当前身份有权访问或管理的知识库与文档明细。

Token 与个人身份绑定，检索结果自动按该身份的权限范围过滤，越权内容不召回。

步骤七：（MCP Tool接入）权限感知访问与验证

借助 AI Agent 以自然语言操作企业知识库：上传文档、查询文档状态、提问检索。检索按调用者身份过滤，答案附带来源文件名、分块、页码与相关度得分等溯源信息。系统会记录每次检索操作的调用者身份、请求时间与返回文档，满足审计要求。
验证权限隔离是否生效：使用两个权限范围不同的身份，对同一知识库提出同一个问题，比较返回内容。两个身份各自只能看到有权访问的文档，即表示权限隔离生效。

权限变更由后台异步同步至检索链路。传播期间，系统遵循拒绝优先策略，暂时排除尚未完成权限更新的文档，避免返回潜在越权内容。检索服务无需停机。

了解更多

什么是企业知识空间：了解权限感知能力的访问控制模型、权限存储与检索机制。
使用企业知识空间：知识空间与知识库的日常管理操作。
将飞书文档同步到知识库：飞书应用创建、API 权限开通与同步链路配置的完整步骤。
将SharePoint文档同步到知识库：Microsoft Entra 应用注册、Microsoft Graph 权限授权与同步链路配置的完整步骤。
PolarDB Agentic Server：PolarDB Agentic Server 开源仓库，包含部署、身份来源与 Agent 管理文档。