Help Center/ CodeArts Agent/ User Guide (IDE)/ Models
Updated on 2026-07-29 GMT+08:00
View PDF
Share

Models

Enterprise members can add third-party LLMs to the CodeArts Agent client. If you have purchased CodeArts Agent professional edition, you can also add third-party LLMs on the console. For details, see "Configuring Custom Models".

Constraints

  • Only third-party custom enterprise models using the OpenAI-compliant Chat Completions APIs and Anthropic-compliant Messages APIs can be integrated.
  • All agents can invoke the custom enterprise models created on the console. However, only the built-in agents, AgentTeam, and custom agents can invoke the custom enterprise models created on the client, and intelligent Q&A cannot invoke them.
  • The provider and model ID combination of each model you add must be unique.

Prerequisites

  • Your account has been added as an enterprise member and assigned a seat.
  • If you have purchased CodeArts Agent professional edition, ensure that the enterprise administrator has enabled model customization for members on the console. For details, see "Configuring Custom Models".

Viewing Built-in Models

  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. Click in the upper right corner of CodeArts Agent IDE to open the settings page.
  3. In the navigation pane of the Settings page, choose Model.
  4. View the built-in models in the Built-in area.

    If you have purchased CodeArts Agent professional edition package, custom models created by the enterprise administrator on the console are also displayed in addition to the built-in ones. The service provider is Huawei Cloud CodeArts Agent for built-in models and system for custom models.

Adding Custom Models

CodeArts Agent allows you to add custom models by specifying the model provider or using custom configurations.

  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. Click in the upper right corner of CodeArts Agent IDE to open the settings page.
  3. In the navigation pane of the Settings page, choose Model.
  4. Click Add Model.
  5. Select Model Provider, and set parameters by referring to Table 1.

    Figure 1 Adding a model by specifying the model provider
    Table 1 Adding a model by specifying the model provider

    Parameter

    Description

    Model Provider

    Select the provider to which the model to be added belongs from the drop-down list.

    Model ID

    Select the ID of the model to be added. If the required model ID is not in the list, select Custom.

    Custom Model ID

    This parameter is available only when Model ID is set to Custom.

    Enter the model ID obtained from the model provider.

    API Key

    Enter the API key obtained from the model provider.

    Custom Model URL

    Optional. After you select a provider, the system automatically populates the model URL. To modify the model URL, enable Custom Edit and enter the new model URL. Enter only the base URL of the API. For example, if the model address is https://open.bigmodel.cn/api/paas/v4/chat/completions, enter https://open.bigmodel.cn/api/paas/v4 here.

    Custom Model Name

    Optional. Enter the name customized for the model. The value contains a maximum of 64 characters.

    Context Window Tokens

    Optional. Set the input tokens and output tokens.

    • Input: indicates the maximum number of tokens that can be received by the model in a single request.
    • Output: indicates the maximum number of tokens that can be delivered by the model in a single response.

    Description

    Optional. Enter a maximum of 200 characters to describe the custom model.

  6. Click OK.

    View the added custom model in the Custom area.

  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. Click in the upper right corner of CodeArts Agent IDE to open the settings page.
  3. In the navigation pane of the Settings page, choose Model.
  4. Click Add Model.
  5. Select Custom Configuration, and set parameters by referring to Table 2.

    Figure 2 Adding a model through custom configuration
    Table 2 Adding a model through custom configuration

    Parameter

    Description

    API Format

    Select the API format used by the model from the drop-down list. The options include OpenAI Chat Completions and Anthropic Messages.

    Model URL

    Enter the model URL obtained from the model provider. Enter only the base URL of the API. For example, if the model address is https://open.bigmodel.cn/api/paas/v4/chat/completions, enter https://open.bigmodel.cn/api/paas/v4 here.

    Model ID

    Enter the model ID obtained from the model provider. Its value contains a maximum of 64 characters. For example, glm-5.1.

    API Key

    Enter the API key obtained from the model provider.

    Custom Model Name

    Optional. Enter the name customized for the model. The value contains a maximum of 64 characters.

    Context Window Tokens

    Optional. Set the input tokens and output tokens.

    • Input: indicates the maximum number of tokens that can be received by the model in a single request.
    • Output: indicates the maximum number of tokens that can be delivered by the model in a single response.

    Description

    Optional. Enter a maximum of 200 characters to describe the custom model.

  6. Click OK.

    View the added custom model in the Custom area.

Using Custom Models

In the lower part of the chat box, choose Built-in > Agent, or choose Custom and select a custom model from the model list on the right.

Managing Custom Models

After creating custom models, enterprise members can edit, delete, and disable them as required.

Operation

Procedure

Editing a custom model
  1. In the Custom area, click next to the target custom model.
  2. Edit the model parameters and click OK.

Deleting a custom model
  1. In the Custom area, click next to the target custom model.
  2. Click Delete.

    The target custom model is removed from the Custom area, indicating that it is successfully deleted.

Enabling/Disabling a custom model

In the Custom area, click or next to the target custom model to enable or disable it.

Once disabled, custom models will no longer show up in the model list in the lower part of the chat box.