模型
华为云码道代码智能体支持在控制台和客户端添加自定义模型，两者有所差异，具体请参考表1。
| 操作入口 | 适用套餐版本 | 操作权限 | 模型使用范围 |
|---|---|---|---|
| 控制台 | 企业版（新版套餐）/专业版（旧版套餐） | 企业管理员 |
|
| 客户端 | 所有版本 |
| 个人级：仅创建者本人可用。 |
本章节介绍企业成员在客户端添加自定义模型的操作，如需在控制台添加自定义模型，请参考配置企业自定义模型。
约束与限制
| 限制类别 | 具体限制 |
|---|---|
| API格式 | 仅支持OpenAI规范的Chat Completions格式和Anthropic规范的Messages格式。 |
| 调用工具 | 仅可由系统内置智能体、AgentTeam和自定义智能体调用，智能问答无法调用。 |
| 积分消耗/Token消耗 | 用户调用自定义模型时，不会消耗华为云码道代码智能体套餐内的积分或Token。但是代码补全功能为降低推理延迟，采用专属内置模型提供服务，不支持自定义模型。 |
| 唯一性限制 | 相同模型提供商和模型ID的模型仅允许添加一次。 |
前提条件
查看内置模型列表
- 参考快速启动操作，登录码道IDE。
- 单击页面右上角的设置图标
，进入IDE模式全局设置页面。 - 在设置页面的左侧导航栏中，选择“模型”，进入“模型”页面。
- 在“内置”区域，查看系统内置模型列表。
如果你购买的是华为云码道代码智能体企业版（新版套餐）/专业版（旧版套餐），除系统内置模型外，还将展示企业管理员在控制台创建的自定义模型。系统内置模型的“服务商”为“华为云码道代码智能体”，控制台创建的自定义模型的“服务商”为“企业内置”。
页面展示所有系统内置模型和控制台创建的自定义模型，无论模型在控制台是否为“开启”状态。
添加自定义模型
华为云码道代码智能体支持两种添加自定义模型方式：一是通过模型提供商快速添加，二是通过自定义配置进行添加。
- 通过模型提供商添加模型：华为云码道代码智能体已预置了一些主流大模型供应商，用户选择模型供应商和模型ID后，系统自动回填模型URL，仅需输入API Key，即可快速完成自定义模型的新建。
- 通过自定义配置添加模型：用户需自行填写模型URL、模型ID和API Key，适用于接入本地自建模型，或模型供应商不在预置列表中的模型。
- 参考快速启动操作，登录码道IDE。
- 单击页面右上角的设置图标 ，进入IDE模式全局设置页面。
- 在设置页面的左侧导航栏中，选择“模型”，进入“模型”页面。
- 单击“添加模型”，弹出“添加模型”对话框。
- 选择“模型提供商”，参考表3配置自定义模型的其他参数。 图1 通过模型提供商添加模型
表3 通过模型提供商添加模型 参数
说明
模型提供商
在下拉列表中选择待添加模型所属的供应商名称。
模型ID
在下拉列表中选择待添加模型的模型ID，创建后不可修改。若您需要的模型ID未在列表中，请选择“自定义”。
自定义模型ID
仅在“模型ID”选择“自定义”时，支持配置此参数。
输入从模型供应商处获取的模型ID，长度不超过64个字符，创建后不可修改。
模型展示名称
设置模型在华为云码道代码智能体中显示的名称，长度不超过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。
上下文窗口Tokens
可选，设置输入Tokens和输出Tokens。
- 输入Tokens：表示模型一次请求可以接收的最大Token。
- 输出Tokens：表示模型一次响应可以生成的最大Token。
描述
可选，自定义模型的描述信息，长度不超过200个字符。
- 单击“添加模型”，系统自动进行模型连通性测试。连通性测试将发起一次真实请求，会消耗少量模型Token。
- 若测试不通过，页面将展示可能失败的原因。你可以根据提示信息修改模型配置参数，然后单击“测试并添加”，重新执行模型连通性测试。若确认模型参数配置无误，也可以单击“直接保存”，完成模型添加。
- 若测试通过，新增模型将展示在“自定义”模型列表中，且状态默认为“开启”。
- 参考快速启动操作，登录码道IDE。
- 单击页面右上角的设置图标 ，进入IDE模式全局设置页面。
- 在设置页面的左侧导航栏中，选择“模型”，进入“模型”页面。
- 单击“添加模型”，弹出“添加模型”对话框。
- 选择“自定义配置”，参考表4配置自定义模型的其他参数。 图2 通过自定义配置添加模型
表4 通过自定义配置添加模型 参数
说明
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。
若开启“使用完整URL”，请填写模型的完整地址。
模型ID
输入从模型供应商处获取的模型ID，长度不超过64个字符，创建后不可修改。例如：glm-5.2。
模型展示名称
设置模型在华为云码道代码智能体中显示的名称，长度不超过64个字符。
API Key
输入从模型供应商处获取的API Key。
上下文窗口Tokens
可选，设置输入Tokens和输出Tokens。
- 输入Tokens：表示模型一次请求可以接收的最大Token。
- 输出Tokens：表示模型一次响应可以生成的最大Token。
描述
可选，自定义模型的描述信息，长度不超过200个字符。
- 单击“添加模型”，系统自动进行模型连通性测试。连通性测试将发起一次真实请求，会消耗少量模型Token。
- 若测试不通过，页面将展示可能失败的原因。你可以根据提示信息修改模型配置参数，然后单击“测试并添加”，重新执行模型连通性测试。若确认模型参数配置无误，也可以单击“直接保存”，完成模型添加。
- 若测试通过，新增模型将展示在“自定义”模型列表中，且状态默认为“开启”。
使用自定义模型
在聊天界面的输入框下方选择“内置 > 智能体”或自定义智能体，在右侧模型列表中选择自定义模型，即可使用该自定义模型。
管理自定义模型
自定义模型创建成功后，企业成员还可以对其进行编辑、删除和关闭等操作。
