Manage AI Platforms

SynxDB Cloud supports adding built-in AI application platforms, SynxDB AI Bot - Data (or AI Bot - Data) and SynxDB AI Bot - Doc (or AI Bot - Doc), through the DBaaS Admin Console.

For more information about AI Bot - Doc, see SynxDB AI Bot - Doc and SynxDB AI Bot - Data.

Prerequisites

Before creating AI Bot - Data or AI Bot - Doc instances, ensure that the following resources are created and configured within the same Account:

Note

To use AI Bot - Data and AI Bot - Doc, you must enable the features (enable-data-mind and enable-doc-mind) and configure the AI platform settings in example/dbaas-values.yaml before deploying SynxDB Cloud. For details, see Deploy SynxDB Cloud.

  • Organization

  • Account

  • Warehouse

  • TP Server

  • ML Cluster

For detailed instructions on managing Organizations, Accounts, Warehouses, and TP Servers, see Manage Architectural Resource Units.

Note

When creating an Account for use with SynxDB AI Bot - Doc, ensure that you select UnionStore as the backend service. AI Bot - Doc is not compatible with accounts based on FoundationDB.

For instructions on managing ML Clusters, see Manage ML Clusters.

Manage AI Bot - Data

You can manage AI Bot - Data instances through the DBaaS Admin Console, including viewing existing instances, creating new ones, and deleting those that are no longer needed.

View existing AI Bot - Data instances

  1. Log in to the DBaaS Admin Console.

  2. In the left navigation menu, click Organizations.

  3. In the organization tree, expand the desired organization and click the target account to access the Account Detail page.

  4. Click the AI Bot - Data tab at the bottom of the page.

The list displays all AI Bot - Data instances under the account, showing information such as Status, Frontend Profile, Backend Profile, Environment Spec, and Frontend URL.

You can delete an instance by clicking Delete in the Operation column if it is no longer required.

Create a AI Bot - Data

  1. On the AI Bot - Data tab, click + Create AI Bot - Data.

  2. In the Create AI Bot - Data dialog box, configure the following parameters:

    • Frontend Profile: Select the resource specification for the frontend service.

    • Backend Profile: Select the resource specification for the backend service.

    • Warehouse: Select the warehouse to be used by AI Bot - Data.

    • TP Server: Select the TP Server to be used by AI Bot - Data.

    • Environment Spec: Choose an environment specification (optional).

    • Config Content: Enter the service configuration in TOML format. The configuration defines the LLM providers available to AI Bot - Data. To load a starter template, click View Example next to the field label, then click Apply to Content to load the sample into the editor. The following shows the configuration structure:

      [llms]
      [llms.qwen3_8b]
      show_name = "Qwen3-8B"
      base_url = "http://<llm_host>:<llm_port>/v1"
      api_key = "<api_key>"
      model = "qwen/qwen3-8b"
      
  3. Click OK to start the creation process.

Once created, you can access the AI Bot - Data interface by clicking the link in the Frontend URL column. This will redirect you to the AI Bot - Data login page.

  • Default Username: admin

  • Default Password: admin123

Manage AI Bot - Doc

You can manage AI Bot - Doc instances through the DBaaS Admin Console, including viewing existing instances, creating new ones, and deleting those that are no longer needed.

View existing AI Bot - Doc instances

  1. Log in to the DBaaS Admin Console.

  2. In the left navigation menu, click Organizations.

  3. In the organization tree, expand the desired organization and click the target account to access the Account Detail page.

  4. Click the AI Bot - Doc tab at the bottom of the page.

The list displays all AI Bot - Doc instances under the account, showing information such as Status, Frontend Profile, Backend Profile, Environment Spec, and Frontend URL.

You can delete an instance by clicking Delete in the Operation column if it is no longer required.

Create a AI Bot - Doc

  1. On the AI Bot - Doc tab, click + Create AI Bot - Doc.

  2. In the Create AI Bot - Doc dialog box, configure the following parameters:

    • Frontend Profile: Select the resource specification for the frontend service.

    • Backend Profile: Select the resource specification for the backend service.

    • Warehouse: Select the warehouse to be used by AI Bot - Doc.

    • TP Server: Select the TP Server to be used by AI Bot - Doc.

    • ML Cluster: Select one or more ML Clusters to be used by AI Bot - Doc.

    • Environment Spec: Choose an environment specification (optional).

    • Config Content: Enter the service configuration in TOML format. The configuration defines the service endpoints and model providers used by AI Bot - Doc. To load a starter template, click View Example next to the field label, then click Apply to Content to load the sample into the editor. The following shows the configuration structure:

      [service]
      pdf_parser_endpoint = ""
      elastic_search_url = "http://<es_host>:<es_port>/"
      
      [model_services]
      [model_services.multimodal_embedding]
      model_name = "bge-vl-large"
      url = "http://<embedding_host>:<embedding_port>/vl_embedding/v1/embeddings"
      api_key = "<embedding_api_key>"
      provider = "openai"
      
      [model_services.text_embedding]
      model_name = "jina-embeddings-v2-base-zh"
      url = "http://<embedding_host>:<embedding_port>/embedding/v1/embeddings"
      api_key = "<embedding_api_key>"
      provider = "openai"
      batch_size = 2
      
      [model_services.llms.qwen_3_8b]
      model_name = "qwen/qwen3-8b"
      url = "http://<llm_host>:<llm_port>/v1/chat/completions"
      api_key = "<api_key>"
      provider = "openai"
      enable_thinking = "false"
      max_tokens = 8192
      
  3. Click OK to start the creation process.

Once created, you can access the AI Bot - Doc interface by clicking the link in the Frontend URL column. This will redirect you to the AI Bot - Doc login page.

  • Default Username: admin

  • Default Password: admin123