配置企业自定义模型
华为云码道代码智能体支持企业接入第三方大语言模型，可根据业务场景灵活定制，并满足企业私有化部署、数据安全与合规管控要求，实现模型能力与业务深度适配。
华为云码道代码智能体专业版套餐支持通过控制台和客户端配置自定义模型，基础版套餐和体验版套餐仅支持在客户端配置自定义模型。
- 控制台：仅企业管理员可配置自定义模型，并可管控企业成员在客户端配置自定义模型的权限。
- 客户端：所有企业成员均可配置自定义模型。
本章节介绍企业管理员在控制台配置自定义模型的操作，如需在客户端配置自定义模型，请参考模型。
约束与限制
| 限制类别 | 具体限制 |
|---|---|
| API格式 | 仅支持OpenAI规范的Chat Completions格式和Anthropic规范的Messages格式。 |
| 数量 | 单租户最多可新建100个自定义模型。 |
| 调用工具 | 仅可由系统内置智能体、AgentTeam和自定义智能体调用，智能问答无法调用。 |
| Token消耗 | 用户调用自定义模型时，不会消耗华为云码道代码智能体套餐内的Token。但是代码补全功能为降低推理延迟，采用专属内置模型提供服务，不支持自定义模型。 |
| 版本限制 | 在26.8.1版本之前创建的自定义模型需在系统内置智能体的“基础模型”中添加该模型，方可在客户端中使用。具体步骤请参考修改系统内置智能体的基础模型。 |
前提条件
- 已购买华为云码道代码智能体专业版套餐。
- 新建企业自定义模型前，请先从模型供应商处获取模型ID、模型URL和API Key。
步骤一：新建企业自定义模型
华为云码道代码智能体支持两种企业自定义模型创建方式：一是通过模型提供商快速创建，二是通过自定义配置进行创建。
- 通过模型提供商添加模型：华为云码道代码智能体已预置了一些主流大模型供应商，用户选择模型供应商和模型ID后，系统自动回填模型URL，仅需输入API Key，即可快速完成自定义模型的新建。
- 通过自定义配置添加模型：用户需自行填写模型URL、模型ID和API Key，适用于接入本地自建模型，或模型供应商不在预置列表中的模型。
- 使用已授权企业管理员角色的账号登录码道代码智能体控制台。
- 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
- 在“企业内置模型”区域，单击“新建模型”，弹出“新建模型”对话框。
- 选择“模型提供商”，参考表2配置企业自定义模型的其他参数。 图1 通过模型提供商添加模型
表2 通过提供商添加模型 参数
说明
模型提供商
在下拉列表中选择待添加模型所属的供应商名称。
模型ID
在下拉列表中选择待添加模型的模型ID。若您需要的模型ID未在列表中，请选择“自定义”。
自定义模型ID
仅在“模型ID”选择“自定义”时，支持配置此参数。
输入从模型供应商处获取的模型ID。
模型展示名称
设置模型在华为云码道代码智能体中显示的名称，长度不超过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：表示模型一次请求可以接收的最大Token。
- 输出Tokens：表示模型一次响应可以生成的最大Token。
描述
可选，自定义模型的描述信息，长度不超过200个字符。
- 单击“确定”，完成自定义模型的添加。
在“企业内置模型”区域，查看新创建的模型，该模型默认为“开启”状态。
- 使用已授权企业管理员角色的账号登录码道代码智能体控制台。
- 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
- 在“企业内置模型”区域，单击“新建模型”，弹出“新建模型”对话框。
- 选择“自定义配置”，参考表3配置企业自定义模型的其他参数。 图2 通过自定义配置添加模型
表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.1。
模型展示名称
设置模型在华为云码道代码智能体中显示的名称，长度不超过64个字符。
模型展示名称可与系统内置模型名称相同，但不可与其他已创建的自定义模型名称相同。
API Key
输入从模型供应商处获取的API Key。
可用范围
定义自定义模型的可用范围，创建后不可修改。
- 企业：企业全员可用。
- 团队：仅指定团队可用。
企业管理员可使用所有企业级和团队级自定义模型。
可用团队
“可用范围”设置为“团队”时，展示此参数。
在下拉列表中选择团队，支持选择多个团队。
上下文窗口
可选，设置输入Tokens和输出Tokens。
- 输入Tokens：表示模型一次请求可以接收的最大Token。
- 输出Tokens：表示模型一次响应可以生成的最大Token。
描述
可选，自定义模型的描述信息，长度不超过200个字符。
- 单击“确定”，完成自定义模型的添加。
在“企业内置模型”区域，查看新创建的模型，该模型默认为“开启”状态。
步骤二：使用企业自定义模型
企业成员在客户端中使用企业自定义模型进行推理时，不会消耗华为云码道代码智能体套餐内的Token。但是代码补全功能为降低推理延迟，采用专属内置模型提供服务，不支持自定义模型。
- 使用已授权企业成员或企业管理员角色的账号登录华为云码道代码智能体客户端。
- 在聊天界面的输入框下方选择“内置 > 智能体”或自定义智能体，在右侧模型列表中选择企业自定义模型，即可使用该自定义模型。
团队级自定义模型仅团队成员（包含团队管理员）和企业管理员可使用。
接入并使用MaaS模型示例
- 在MaaS控制台购买Token Plan套餐，具体步骤请参考Token Plan套餐概览。
- 从Token Plan套餐概览文档中获取模型的Model Name和Base Url。
- 创建API Key并复制保存，具体步骤请参考创建API Key。
- 使用已授权企业管理员角色的账号登录码道代码智能体控制台。
- 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
- 在“企业内置模型”区域，单击“新建模型”，弹出“新建模型”对话框。
- 参考表4接入MaaS模型。 图3 接入MaaS模型
表4 接入MaaS模型参数说明 参数
说明
模型提供商
选择“华为云MaaS”。
模型ID
选择2中获取的Model Name，如：Kimi-K2.6。
模型展示名称
设置模型在华为云码道代码智能体中显示的名称，长度不超过64个字符。
模型展示名称可与系统内置模型名称相同，但不可与其他已创建的自定义模型名称相同。
输入“MaaS-Kimi-K2.6”。
API Key
输入3中保存的API Key。
可用范围
选择“企业”，表示所有企业成员均可使用该自定义模型。
自定义模型URL
开启“自定义编辑”，输入2中获取的Base Url，如：https://api.modelarts-maas.com/plan/v2。
上下文窗口
可选，保持默认。
描述
可选，保持默认。
- 单击“确定”，完成MaaS模型的接入。
在“企业内置模型”区域，查看新接入的MaaS模型。
- 打开华为云码道代码智能体客户端的聊天界面，在输入框下方选择“内置 > 智能体”，在右侧模型列表中选择MaaS模型。在输入框中输入“什么是二叉树”，若模型返回正确内容，说明MaaS模型可正常使用。 图4 使用MaaS模型
配置成员自定义模型权限
企业管理员可通过控制台统一管控企业成员在客户端配置自定义模型的权限。开启后，企业成员可自行添加自定义模型。关闭后则无法添加。
- 使用已授权企业管理员角色的账号登录码道代码智能体控制台。
- 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
- 在“成员自定义模型权限配置”区域，开启或关闭开关。
- 开启：企业成员可在华为云码道代码智能体客户端添加自定义模型。
- 关闭：企业成员无法在华为云码道代码智能体客户端添加自定义模型。
管理企业自定义模型
企业自定义模型创建完成后，企业管理员可对其执行表5中所列操作。
