# 模型
您可以在码道CodeArts添加第三方大语言模型。
#### 约束与限制
表1约束与限制 
| 限制类别      | 具体限制                                                          |
|:---|:---|
| API格式     | 仅支持**OpenAI规范的Chat Completions格式** 和**Anthropic规范的Messages格式**。 |
| Token消耗 | 用户调用自定义模型时，不会消耗华为云码道代码智能体套餐内的Token。                              |
| 唯一性限制       | 相同模型提供商和模型ID的模型仅允许添加一次。                                           |
   
#### 前提条件
- 已将账号添加至[企业成员](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0004.html)中，并[启用席位](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0006.html)。
- 如果你购买的是华为云码道代码智能体**企业版（新版套餐）/专业版（旧版套餐）** ，请确保企业管理员已在控制台开启成员自定义模型权限，具体操作请参考[配置企业自定义模型](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0009.html)。
 
#### 查看内置模型列表
1. 参考[码道桌面端](https://support.huaweicloud.com/usermanual-codeartsdesktop/desktop_0005.html)操作，登录码道CodeArts。
2. 在码道CodeArts左下角单击 ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/zh-cn_image_0000002723896458.png)，选择"设置"。
3. 在设置页面的左侧导航栏中，选择"模型"。
4. 在"内置"区域，查看系统内置模型列表。 
   如果你购买的是华为云码道代码智能体企业版（新版套餐）/专业版（旧版套餐），除系统内置模型外，还将展示企业管理员在控制台创建的自定义模型。系统内置模型的"服务商"为"华为云码道代码智能体"，控制台创建的自定义模型的"服务商"为"企业内置"。
   ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/public_sys-resources/note_3.0-zh-cn.png)
   页面展示所有系统内置模型和控制台创建的自定义模型，无论模型在控制台是否为"开启"状态。
   
   
 
#### 添加自定义模型
码道CodeArts支持两种添加自定义模型方式：一是通过模型提供商快速添加，二是通过自定义配置进行添加。
- 通过模型提供商添加模型：码道CodeArts已预置了一些主流大模型供应商，用户选择模型供应商和模型ID后，系统自动回填模型URL，仅需输入API Key，即可快速完成自定义模型的新建。
- 通过自定义配置添加模型：用户需自行填写模型URL、模型ID和API Key，适用于接入本地自建模型，或模型供应商不在预置列表中的模型。
 
- [通过模型提供商添加模型]
  1. 在设置页面的左侧导航栏中，选择"模型"。
  
  2. 单击"添加模型"，弹出"添加模型"对话框。
  
  3. 选择"模型提供商"，参考[表2]配置自定义模型的其他参数。
     
     图1通过模型提供商添加模型   
     ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/zh-cn_image_0000002718868809.png "点击放大")
      表2通过模型提供商添加模型 
     | 参数          | 说明                                                                                                                                                                                                                                                     |
     |:---|:---|
     | 模型提供商            | 在下拉列表中选择待添加模型所属的供应商名称。                                                                                                                                                                                                                                    |
     | 模型ID         | 在下拉列表中选择待添加模型的模型ID。若您需要的模型ID未在列表中，请选择"自定义"。                                                                                                                                                                                                             |
     | 自定义模型ID        | 仅在"模型ID"选择"自定义"时，支持配置此参数。 输入从模型供应商处获取的模型ID，长度不超过64个字符。                                                                                                                                                                    |
     | 自定义模型名称      | 设置模型在码道CodeArts中显示的名称，长度不超过64个字符。                                                                                                                                                                                                                      |
     | API Key        | 输入从模型供应商处获取的API Key。                                                                                                                                                                                                                                  |
     | 自定义模型URL      | 可选，选择提供商后，系统自动输入模型URL。若您想要修改模型URL，需先开启"自定义编辑"，然后输入模型URL，仅填写API的Base URL。例如：模型完整地址为https://open.bigmodel.cn/api/paas/v4/chat/completions，应填写的模型URL为https://open.bigmodel.cn/api/paas/v4。                                                                |
     | 上下文窗口 Token 限制 | 可选，设置输入Tokens和输出Tokens。 - 输入Tokens：表示模型一次请求可以接收的最大Token。  - 输出Tokens：表示模型一次响应可以生成的最大Token。   |
     | 描述           | 可选，自定义模型的描述信息，长度不超过200个字符。                                                                                                                                                                                                                             |
        
     
     
  
  4. 单击"确定"，完成自定义模型的添加。 
     在"自定义"区域，查看新添加的自定义模型，该模型默认为"开启"状态。
     
     
   
- [通过自定义配置添加模型]
  1. 在设置页面的左侧导航栏中，选择"模型"。
  
  2. 单击"添加模型"，弹出"添加模型"对话框。
  
  3. 选择"自定义配置"，参考[表3]配置自定义模型的其他参数。
     
     图2通过自定义配置添加模型   
     ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/zh-cn_image_0000002689149554.png "点击放大")
      表3通过自定义配置添加模型 
     | 参数            | 说明                                                                                                                                                                                                                                                      |
     |:---|:---|
     | API 格式       | 在下拉列表中选择模型所使用的API格式，包括OpenAI Chat Completions格式和Anthropic Messages格式。                                                                                                                                                                                  |
     | 模型 URL        | 输入从模型供应商处获取的模型URL，仅填写API的Base URL。例如：模型完整地址为https://open.bigmodel.cn/api/paas/v4/chat/completions，应填写的模型URL为https://open.bigmodel.cn/api/paas/v4。                                                                                                    |
     | 模型 ID        | 输入从模型供应商处获取的模型ID，长度不超过64个字符。例如：glm-5.2。                                                                                                                                                                                                                |
     | 自定义模型名称     | 设置模型在码道CodeArts中显示的名称，长度不超过64个字符。                                                                                                                                                                                                                        |
     | API Key       | 输入从模型供应商处获取的API Key。                                                                                                                                                                                                                                    |
     | 上下文窗口Token限制 | 可选，设置输入Tokens和输出Tokens。 - 输入Tokens：表示模型一次请求可以接收的最大Token。  - 输出Tokens：表示模型一次响应可以生成的最大Token。   |
     | 描述             | 可选，自定义模型的描述信息，长度不超过200个字符。                                                                                                                                                                                                                             |
        
     
     
  
  4. 单击"确定"，完成自定义模型的添加。 
     在"自定义"区域，查看新添加的自定义模型，该模型默认为"开启"状态。
     
     
   
#### 使用自定义模型
在聊天界面的模型列表中选择自定义模型，即可使用该自定义模型。
#### 管理自定义模型
自定义模型创建成功后，企业成员还可以对其进行编辑、删除和关闭等操作。
| 操作        | 具体步骤                                                                                                                                                                                                                                                                                                     |
|:---|:---|
| 编辑自定义模型     | 1. 在"自定义模型"下方，单击目标自定义模型后的"编辑"，弹出"编辑模型"对话框。  2. 根据实际需求编辑模型参数，单击"确定"，完成自定义模型的编辑。                                                                                             |
| 删除自定义模型     | 1. 在"自定义模型"下方，单击目标自定义模型后的"删除"，弹出"删除模型"对话框。  2. 单击"删除"，完成自定义模型的删除。 目标自定义模型已从"自定义模型"下方移除，表示自定义模型删除成功。             |
| 开启/关闭自定义模型 | 在"自定义模型"下方，单击目标自定义模型后的 ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/zh-cn_image_0000002689151124.png) 或 ![](https://support.huaweicloud.com/usermanual-codeartsdesktop/zh-cn_image_0000002718990703.png)，即可开启/关闭自定义模型。 关闭自定义模型后，在聊天界面输入框中的模型列表中将不展示此模型。 |
   
