PolarDB Agentic PostgreSQL集群可在PolarDB控制台创建。Agentic PostgreSQL本身是一个逻辑集群，其下可创建多个数据库集群和LakeBase文件系统集群，分别通过PostgreSQL协议和POSIX文件系统接口访问，并提供MCP Server供AI Agent调用。本文介绍在控制台创建集群、创建和管理API Key、修改配额以及开通LakeBase文件系统访问的完整流程。
PolarDB Agentic PostgreSQL目前处于公测阶段。公测期间，不承诺服务等级协议SLA。如您对当前功能有任何疑问，可通过钉钉搜索群号入群咨询。钉钉群号：175205010586
步骤一：创建集群
登录PolarDB控制台。
在左侧导航栏，选择，进入AgenticDB 集群列表页面。
单击创建 AgenticDB 集群，跳转到购买页。
根据业务需求配置以下核心参数，其余参数保持默认或按向导提示填写。
参数
说明
地域
选择集群部署地域。地域一旦选定，后续无法修改。请就近选择业务所在地域以降低访问延迟。
引擎
选择PostgreSQL兼容的版本。
网络和可用区
选择集群创建的专有网络与可用区。
资源数量
选择需要创建的集群数量，默认是1，可以调整。后续也可在集群生产后进行修改。
阅读并勾选服务协议，单击立即购买，按向导完成订单支付。订单支付成功后，系统将在数分钟内完成集群创建，可返回AAgenticDB 集群列表页面查看集群状态。
步骤二：创建和管理API Key
PolarDB Agentic PostgreSQL MCP Server采用API Key认证机制，确保使用者身份可信、操作范围可控。API Key中内嵌了Agentic PostgreSQL集群和租户信息，MCP Server在首次连接时自动完成三层校验（格式校验→Payload解析→远程验证），验证通过后创建Session，后续调用在该Session上下文中执行，AI Agent和使用者全程不接触任何数据库地址、账号或密码。
登录PolarDB控制台。
在左侧导航栏，选择，进入AgenticDB 集群列表页面。
单击目标集群ID/名称，进入集群详情页。
单击创建 API Key，在弹出面板中填写以下信息。
参数
说明
租户名称
输入Tenant名称，用于标识该API Key绑定的租户。每个API Key仅可访问其绑定的集群和租户下的资源，不能跨租户访问。
描述
自定义描述，建议按使用方标注（例如Qoder-team-A、Cursor-dev-01），便于后续审计和轮转。
单击确定，系统生成一条API Key。弹出的API Key 创建成功对话框中会展示租户名称、租户 ID及完整的API Key明文，单击复制完整 Key保存到本地。
警告API Key仅在创建时展示一次，请立即复制并妥善保存到安全位置（例如密码管理器）。关闭对话框后无法再次查看完整Key，如果遗失需要重新创建。
API Key管理页面的列表中，可查看每条Key的Tenant、API Key、描述、状态（可用、创建中、轮转中、已过期、）与创建时间，按需在操作列执行重置或删除。
步骤三：修改配额
每个Agentic PostgreSQL逻辑集群下可创建的数据库集群数量称为连接资源配额（在基本信息页面显示为资源数字段）。默认配额为1，即最多可创建1个数据库集群。业务规模扩大时，可通过以下任一入口调整。
入口一：集群列表页：在AgenticDB 集群列表页面找到目标集群，在操作列单击增减资源。
入口二：集群详情页：在集群详情页的基本信息区域找到资源数字段（显示格式为
已用 / 配额），单击右侧的修改配额。
两种入口均会打开修改连接资源配额对话框。在目标配额输入框中填写新配额（不可小于当前已用数），单击确定提交，配额立即生效。
步骤四：开通LakeBase文件系统访问
Agentic PostgreSQL集成LakeBase文件系统，为AI Agent提供POSIX兼容的对象存储访问能力。开通后，AI Agent可通过标准文件系统接口在Agentic PostgreSQL环境中直接读写非结构化文件，支撑文档处理、模型输入输出、日志归档等场景。
在集群详情页左侧导航栏单击基本信息。
在基本信息区域找到文件系统访问字段，单击开通。
在开通文件系统访问确认对话框中单击确定。系统开始为当前Agentic PostgreSQL集群创建LakeBase文件系统集群，字段依次显示开通中...与已开通。
开通完成后，可在基本信息页面的Lakebase算子页签中查看S3 Gateway连接地址、Meta URL、默认账号等连接信息，并按需通过开通公网访问入口开通公网连接。