配置企业自定义模型

约束与限制

• 接入第三方模型仅支持OpenAI规范的Chat Completions API格式和Anthropic规范的Messages API格式。
• 在控制台新建的自定义模型所有智能体均可调用，在客户端新建的自定义模型仅系统内置智能体、AgentTeam和自定义智能体可调用，智能问答无法调用。

企业自定义模型权限说明

企业自定义模型在创建、管理和使用各阶段所需权限存在差异。华为账号和账号根用户拥有全量操作的权限，而IAM用户和企业联邦用户需要具备表1所列权限/角色，方可执行对应操作。

前提条件

• 已购买华为云码道代码智能体专业版套餐。
• 新建企业自定义模型前，请确保IAM用户或企业联邦用户已被授予Tenant Administrator权限。

  华为账号给IAM用户授权的具体步骤请参考创建用户组并授权或创建用户组并授权（IAM新版），为企业联邦用户授权的具体步骤请参考创建用户组并授权。企业联邦用户所属用户组权限修改后，必须重启企业IdP才能使相关设置生效。

• 新建企业自定义模型前，请先从模型供应商处获取模型ID、模型URL和API Key。

步骤一：新建企业自定义模型

华为云码道代码智能体支持两种企业自定义模型创建方式：一是通过模型提供商快速创建，二是通过自定义配置进行创建。

步骤二：将企业自定义模型添加至模型列表中

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. 参考表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。
   上下文窗口	可选，保持默认。
   描述	可选，保持默认。

8. 单击“确定”，完成MaaS模型的接入。

   在“企业内置模型”区域，查看新接入的MaaS模型。

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

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

配置成员自定义模型权限

1. 使用已授权企业管理员角色的账号登录码道代码智能体控制台。
2. 在左侧导航栏选择“企业设置 > 模型配置”，进入“模型配置”页面。
3. 在“成员自定义模型权限配置”区域，开启或关闭开关。
   • 开启：企业成员可在华为云码道代码智能体客户端添加自定义模型。
   • 关闭：企业成员无法在华为云码道代码智能体客户端添加自定义模型。

管理企业自定义模型

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