Skip to main content

Manage AI Models

NineData administrators can configure custom AI models for AI-assisted workflows such as Text2SQL, object code generation, ChatDBA, and knowledge base vectorization. Use model management when your organization needs to connect NineData to a supported external model provider.

Overview​

NineData uses built-in models for AI capabilities by default. After you add and enable a custom model, NineData uses that model for supported AI features instead of the built-in model.

Before you begin​

  • You are logged in to NineData with a system administrator account.
  • You have created an API key from the target model provider.

Procedure​

Add a custom model​

If no custom model is enabled, NineData uses its built-in model. Add and enable a custom model to use an external model provider for supported AI features.

  1. Sign in to the NineData Console.

  2. Go to System > AI Model.

  3. Click Add Model.

  4. Configure the parameters.

    ParameterDescription
    Model NameEnter a unique name for the custom model so administrators can identify it in the model list.
    Example: DeepSeek-R1
    Model TypeSelect the model provider. NineData currently supports DeepSeek and Qwen.
    URLEnter the model API endpoint from the provider's documentation.
    Example: https://api.deepseek.com/v1/chat/completions.
    API KeyEnter the provider API key used to authenticate model API calls.
    ModelSpecify the underlying AI model. This affects model capabilities and feature compatibility.

  5. Click Save and enable the model configuration.

Disable a custom model​

Disable a custom model when you want NineData to stop using it and fall back to the built-in model.

  1. Sign in to the NineData Console.

  2. Go to System > AI Model.

  3. In the AI Model list, find the target model, click Disable in the Actions column, and then click OK in the confirmation window.

Enable a custom model​

Re-enable a disabled custom model, or choose which model to use when multiple custom models exist.

  1. Sign in to the NineData Console.

  2. Go to System > AI Model.

  3. In the AI Model list, find the target model, click Enable in the Actions column, and then click OK in the confirmation window.

    tip
    • NineData supports only one enabled custom model at a time.
    • After disabling all custom models, NineData's built-in model will be used by default.

Edit a custom model​

Edit a custom model when its endpoint, API key, model name, or other configuration changes.

  1. Sign in to the NineData Console.

  2. Go to System > AI Model.
  3. In the AI Model list, find the target model and click more > Edit in the Actions column.
  4. Update the configuration on the Edit Model page and click Save and enable the model configuration.

Delete a custom model​

Delete a custom model when it is no longer needed.

  1. Sign in to the NineData Console.

  2. Go to System > AI Model.
  3. In the AI Model list, find the target model and click more > Delete in the Actions column. Click OK in the confirmation window.

Result​

NineData uses the enabled custom model for supported AI features. If all custom models are disabled or deleted, NineData uses the built-in model.