更新时间:2026-08-19 GMT+08:00
分享

模型

企业成员支持在华为云码道代码智能体客户端添加第三方大语言模型。若您已购买华为云码道代码智能体专业版套餐,同时支持在控制台添加第三方大语言模型,具体请参见配置企业自定义模型

约束与限制

表1 约束与限制

限制类别

具体限制

API格式

仅支持OpenAI规范的Chat Completions格式Anthropic规范的Messages格式

调用工具

仅可由系统内置智能体、AgentTeam和自定义智能体调用,智能问答无法调用

Token消耗

用户调用自定义模型时,不会消耗华为云码道代码智能体套餐内的Token。但是代码补全功能为降低推理延迟,采用专属内置模型提供服务,不支持自定义模型。

唯一性限制

相同模型提供商和模型ID的模型仅允许添加一次。

前提条件

查看内置模型列表

  1. 参考快速启动操作,登录华为云码道代码智能体IDE。
  2. 单击华为云码道代码智能体IDE右上角的设置图标 ,进入全局设置页面。
  3. 在设置页面的左侧导航栏中,选择“模型”,进入“模型”页面。
  4. 在“内置”区域,查看系统内置模型列表。

    若您已购买华为云码道代码智能体专业版套餐,除系统内置模型外,还将展示企业管理员在控制台创建的自定义模型。系统内置模型的“服务商”为“华为云码道代码智能体”,控制台创建的自定义模型的“服务商”为“企业内置”。

    页面展示所有系统内置模型和控制台创建的自定义模型,无论模型在控制台是否为“开启”状态。

添加自定义模型

华为云码道代码智能体支持两种添加自定义模型方式:一是通过模型提供商快速添加,二是通过自定义配置进行添加。

  • 通过模型提供商添加模型:华为云码道代码智能体已预置了一些主流大模型供应商,用户选择模型供应商和模型ID后,系统自动回填模型URL,仅需输入API Key,即可快速完成自定义模型的新建。
  • 通过自定义配置添加模型:用户需自行填写模型URL、模型ID和API Key,适用于接入本地自建模型,或模型供应商不在预置列表中的模型。
  1. 参考快速启动操作,登录华为云码道代码智能体IDE。
  2. 单击华为云码道代码智能体IDE右上角的设置图标 ,进入全局设置页面。
  3. 在设置页面的左侧导航栏中,选择“模型”,进入“模型”页面。
  4. 单击“添加模型”,弹出“添加模型”对话框。
  5. 选择“模型提供商”,参考表2配置自定义模型的其他参数。

    图1 通过模型提供商添加模型
    表2 通过模型提供商添加模型

    参数

    说明

    模型提供商

    在下拉列表中选择待添加模型所属的供应商名称。

    模型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个字符。

  6. 单击“确认”,完成自定义模型的添加。

    在“自定义”区域,查看新添加的自定义模型,该模型默认为“开启”状态。

  1. 参考快速启动操作,登录华为云码道代码智能体IDE。
  2. 单击华为云码道代码智能体IDE右上角的设置图标 ,进入全局设置页面。
  3. 在设置页面的左侧导航栏中,选择“模型”,进入“模型”页面。
  4. 单击“添加模型”,弹出“添加模型”对话框。
  5. 选择“自定义配置”,参考表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.2。

    模型展示名称

    设置模型在华为云码道代码智能体中显示的名称,长度不超过64个字符。

    API Key

    输入从模型供应商处获取的API Key。

    上下文窗口Tokens

    可选,设置输入Tokens和输出Tokens。

    • 输入Tokens:表示模型一次请求可以接收的最大Token。
    • 输出Tokens:表示模型一次响应可以生成的最大Token。

    描述

    可选,自定义模型的描述信息,长度不超过200个字符。

  6. 单击“确认”,完成自定义模型的添加。

    在“自定义”区域,查看新添加的自定义模型,该模型默认为“开启”状态。

使用自定义模型

在聊天界面的输入框下方选择“内置 > 智能体”或自定义智能体,在右侧模型列表中选择自定义模型,即可使用该自定义模型。

管理自定义模型

自定义模型创建成功后,企业成员还可以对其进行编辑、删除和关闭等操作。

操作

具体步骤

编辑自定义模型

  1. 在“自定义”区域,单击目标自定义模型后的 ,弹出“编辑模型”对话框。
  2. 根据实际需求编辑模型参数,单击“确认”,完成自定义模型的编辑。

删除自定义模型

  1. 在“自定义”区域,单击目标自定义模型后的 ,弹出“删除模型”对话框。
  2. 单击“删除”,完成自定义模型的删除。

    目标自定义模型已从“自定义”区域移除,表示自定义模型删除成功。

开启/关闭自定义模型

在“自定义”区域,单击目标自定义模型后的 ,即可开启/关闭自定义模型。

关闭自定义模型后,在聊天界面输入框下方的模型列表中将不展示此模型。

相关文档