配置模型

前提条件

• 已购买码道专业版套餐。
• 如需新建企业自定义模型，请确保IAM用户已被授予Tenant Administrator权限。华为账号给IAM用户授权的具体步骤请参考创建用户组并授权或创建用户组并授权（IAM新版）。
• 新建企业自定义模型前，请先从模型供应商处获取模型ID、模型URL和API Key。

管理系统内置模型

1. 使用企业管理员登录码道代码智能体控制台。
2. 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
3. 在“系统内置模型”区域，单击目标模型后的 或 ，开启或关闭该模型。

   所有系统内置模型默认为开启状态。

   关闭模型后，在华为云码道客户端的智能体模式中将不展示此模型。

新建企业自定义模型

1. 使用已授予Tenant Administrator授权的企业管理员登录码道代码智能体控制台。
2. 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
3. 在“企业自定义模型”区域，单击“新建模型”，弹出“新建企业自定义模型”对话框。
4. 参考表1配置企业自定义模型信息。
   图1 新建企业自定义模型
   

   表1 企业自定义模型参数说明

   参数	说明
   模型名称	企业自定义模型的名称，长度不超过64个字符。 自定义模型名称可与系统内置模型名称相同，但不可与其他已创建的自定义模型名称相同。
   模型ID	输入从模型供应商处获取的模型ID，长度不超过64个字符。例如：glm-5.1。
   模型URL	输入从模型供应商处获取的模型URL，仅填写API的Base URL。例如：模型完整地址为https://open.bigmodel.cn/api/paas/v4/chat/completions，应填写的模型URL为https://open.bigmodel.cn/api/paas/v4。
   API Key	输入从模型供应商处获取的API Key。
   描述	可选，自定义模型的描述信息，长度不超过200个字符。

5. 单击“确定”，系统会自动执行模型连通性测试。
   • 若测试成功，企业自定义模型创建完成。
   • 若测试失败，系统将弹出“模型连通性测试失败”对话框。即便连通性测试失败，仍可继续创建企业自定义模型。单击“继续新建”，即可完成企业自定义模型的创建。

   在“企业自定义模型”区域，查看新创建的模型。

将企业自定义模型添加至模型列表中

1. 企业管理员在左侧导航栏选择“智能体设置 > 智能体中心”，进入“智能体中心”页面。
2. 在系统内置的“智能体”后，单击“编辑”，进入“编辑智能体”页面。
3. 在“基础模型”下拉框中勾选新建的企业自定义模型，单击右上角的“确定”，将该模型添加到智能体中。

使用企业自定义模型

企业自定义模型添加至模型列表并启用后，企业内所有成员均可在码道客户端中使用该模型，且不会消耗码道套餐内的Token。

1. 使用企业成员或企业管理员登录码道客户端。
2. 在聊天界面的输入框下方选择“内置智能体 > 智能体”或自定义智能体，在右侧模型列表中选择新建的企业自定义模型，即可使用该自定义模型。

接入并使用MaaS模型示例

1. 在MaaS控制台购买Token Plan套餐，具体步骤请参考Token Plan套餐概览。
2. 从Token Plan套餐概览文档中获取模型的Model Name和Base Url。
3. 创建API Key并复制保存，具体步骤请参考创建API Key。
4. 使用已获得Tenant Administrator授权的企业管理员登录码道代码智能体控制台。
5. 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
6. 在“企业自定义模型”区域，单击“新建模型”，弹出“新建企业自定义模型”对话框。
7. 参考表2接入MaaS模型。
   图2 接入MaaS模型
   

   表2 接入MaaS模型参数说明

   参数	说明
   模型名称	企业自定义模型的名称，长度不超过64个字符。 自定义模型名称可与系统内置模型名称相同，但不可与其他已创建的自定义模型名称相同。 输入“MaaS-Kimi-K2.6”。
   模型ID	输入2中获取的Model Name，如：Kimi-K2.6。
   模型URL	输入2中获取的Base Url，如：https://api.modelarts-maas.com/plan/v2。
   API Key	输入3中保存的API Key。
   描述	可选，不设置。

8. 单击“确定”，弹出“模型连通性测试失败”对话框。
   图3 模型连通性测试失败
   

9. 单击“继续新建”，即可完成MaaS模型的接入。

   在“企业自定义模型”区域，查看新接入的MaaS模型。

10. 在左侧导航栏选择“智能体设置 > 智能体中心”，进入“智能体中心”页面。
11. 在系统内置的“智能体”后，单击“编辑”，进入“编辑智能体”页面。
12. 在“基础模型”下拉框中勾选MaaS模型，单击右上角的“确定”，将该模型添加到智能体中。
    图4 勾选MaaS模型
    

13. 打开华为云码道客户端的聊天界面，在输入框下方选择“内置智能体 > 智能体”，在右侧模型列表中选择MaaS模型。在输入框中输入“什么是二叉树”，若模型返回正确内容，说明MaaS模型可正常使用。
    图5 使用MaaS模型
    

管理企业自定义模型

企业自定义模型创建完成后，企业管理员可对模型进行搜索操作，除此之外的管理操作，仅允许已授予Tenant Administrator授权的企业管理员执行。