This topic describes how to quickly create a PolarDB Agent Express application using an existing or a new cluster.
Prerequisites
Your cluster must be a centralized PolarDB for PostgreSQL cluster. PolarDB for PostgreSQL (Distributed Edition) clusters are not supported.
(Optional) Create a PolarDB for PostgreSQL cluster
If you do not have a cluster that meets the requirements in Applicable scope, or if it is inconvenient to modify your existing cluster for business reasons, you can create another cluster in the PolarDB console to try out the PolarDB Agent Express application.
Create a PolarDB Agent Express application
Log on to the PolarDB console. In the left-side navigation pane, choose . In the top navigation bar, select the region where you want to create the application.
On the PolarDB Agent Express page, on the PolarDB Agent Express List tab, click Create PolarDB Agent Express.
On the purchase page, configure the application.
Parameter
Description
Billing Method
Subscription: A prepaid billing method where you purchase resources for a specific period. Longer subscription periods offer greater discounts. This method is suitable for stable, long-term business needs.
Pay-As-You-Go: A postpaid billing method where you are billed based on actual usage. This method is suitable for scenarios with flexible business requirements.
Region
Select the region and availability zone where the application will be located.
NoteThe region cannot be changed after you purchase the application.
The application must be in the same region as the PolarDB for PostgreSQL cluster. Select the same region as your cluster.
We recommend creating the application in the same region as the ECS instances it will connect to. Otherwise, it can only communicate over the public network.
Ecosystem
Select PostgreSQL.
AI Application
This parameter is fixed to PolarDB Agent Express.
Component Set
The component set for a PolarDB Agent Express application is fixed to the Agent component. For pricing details, see What is PolarDB Agent Express?.
AI Application Name
Enter a custom name for the application.
NoteThe name cannot start with http:// or https:// and must be 2 to 256 characters in length.
Model Source
Model Studio
Model Studio model list: Refer to Select a model to choose a model. Example:
qwen3.5-plus.Model Studio API key: Enter the API key. Example:
sk-***.Model Studio model protocol: Select the model protocol. Examples:
openai-completionsoranthropic-messages.Model Studio base URL: Enter the base URL for the model. Example:
https://dashscope.aliyuncs.com/compatible-mode/v1.
Model Operator
Select Model: You can choose an Existing Model or a New Model.
Source LLM Model List / LLM Model: Select the required model.
Custom Model
Custom Model Name: Enter an easy-to-identify name for the model.
Custom Model API key: Enter the authentication key required by the model.
Custom Model API: Enter the full endpoint URL for model inference.
Custom Model base URL: Enter the base URL of the model service.
NoteBy using the Custom Model feature, you agree to the following terms:
Compliance Responsibility: You must ensure that your custom model complies with the laws, regulations, and regulatory requirements of the People's Republic of China, including but not limited to those related to data security, algorithm recommendations, and generative AI.
Risk Assumption: You assume full responsibility for any consequences arising from the use of overseas models or models that are not properly filed, including compliance risks, data leakage, and non-compliant output content.
Platform Disclaimer: PolarDB Agent Express provides only model integration capabilities and does not guarantee the output content, security, or compliance of custom models.
Network Type
This parameter is fixed to VPC.
VPC
This parameter is automatically populated with the VPC of the source PolarDB cluster and cannot be changed.
Availability Zone and vSwitch
Configure the vSwitch for the VPC. We recommend that you select a vSwitch in the same availability zone as the primary zone of your PolarDB for PostgreSQL cluster for optimal network performance. If no existing vSwitch meets your requirements, you can create a VPC and a vSwitch.
Storage Type
Supports Cloud Disk and AI Cache.
Data Disk
If you set Storage Type to Cloud Disk, the default storage size is 20 GB and the default type is PL0 storage.
AI Cache Instance ID/Name
If you set Storage Type to AI Cache, you must associate an existing PolarDB Agent LakeBase instance.
Security Group
Configure the security group for the application.
Quantity
Select the number of applications to purchase.
NoteThis parameter is available only when Billing Method is set to Subscription.
Subscription Duration
Select the subscription duration for the application.
NoteThis parameter is available only when Billing Method is set to Subscription.
Auto-renewal
Enable auto-renewal to prevent business interruptions from an expired subscription.
NoteThis parameter is available only when Billing Method is set to Subscription.
After completing the purchase, return to the AI Application page of the cluster to view the new application.
NoteThe application takes 3 to 5 minutes to create.