Create a PolarDB Agent Express application

更新时间:
复制 MD 格式

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

  1. Log on to the PolarDB console. In the left-side navigation pane, choose PolarDB AI > PolarDB Agent Express. In the top navigation bar, select the region where you want to create the application.

  2. On the PolarDB Agent Express page, on the PolarDB Agent Express List tab, click Create PolarDB Agent Express.

  3. 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.

    Note
    • The 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.

    Note

    The 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-completions or anthropic-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.

      Note

      By 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.

    Note

    This parameter is available only when Billing Method is set to Subscription.

    Subscription Duration

    Select the subscription duration for the application.

    Note

    This parameter is available only when Billing Method is set to Subscription.

    Auto-renewal

    Enable auto-renewal to prevent business interruptions from an expired subscription.

    Note

    This parameter is available only when Billing Method is set to Subscription.

  4. After completing the purchase, return to the AI Application page of the cluster to view the new application.

    Note

    The application takes 3 to 5 minutes to create.