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

模型

您可以在码道Space客户端添加第三方大语言模型。

约束与限制

表1 约束与限制

限制类别

具体限制

API格式

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

Token消耗

用户调用自定义模型时,不会消耗华为云码道代码智能体套餐内的Token。

唯一性限制

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

前提条件

查看内置模型列表

  1. 参考快速启动操作,登录码道Space。
  2. 在码道Space客户端左下角单击个人头像 ,选择“设置”。
  3. 在设置页面的左侧导航栏中,选择“模型”。
  4. 在“内置”区域,查看系统内置模型列表。

添加自定义模型

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

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

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

    参数

    说明

    模型提供商

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

    模型ID

    在下拉列表中选择待添加模型的模型ID。若您需要的模型ID未在列表中,请选择“自定义”。

    自定义模型ID

    仅在“模型ID”选择“自定义”时,支持配置此参数。

    输入从模型供应商处获取的模型ID,长度不超过64个字符。

    自定义模型名称

    设置模型在码道Space中显示的名称,长度不超过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。

    上下文窗口 Token 限制

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

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

    描述

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

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

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

  1. 在设置页面的左侧导航栏中,选择“模型”。
  2. 单击“添加模型”,弹出“添加模型”对话框。
  3. 选择“自定义配置”,参考表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。

    自定义模型名称

    设置模型在码道Space中显示的名称,长度不超过64个字符。

    API Key

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

    上下文窗口Token限制

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

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

    描述

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

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

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

使用自定义模型

在聊天界面的模型列表中选择自定义模型,即可使用该自定义模型。

管理自定义模型

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

操作

具体步骤

编辑自定义模型

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

删除自定义模型

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

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

开启/关闭自定义模型

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

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

相关文档