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