手动接入和使用openai协议模型-j9九游会登录

案例概述

当您需要使用agentarts平台未预置的模型，或者使用自建部署的模型服务时，就需要通过“自定义模型”方式接入。

agentarts支持接入兼容openai接口规范的第三方大语言模型。本实践以glm模型为例，指导您完成从获取api密钥、接入自定义模型的操作。

平台中预置的模型，可以在“资产广场”中查看。

图1 查看预置模型

什么场景需要手动接入模型

如果平台预置模型或maas模型已能满足需求，优先使用前两种方式，配置更为简单。只有在确实需要特定模型时，才走自定义接入模型方式。

模型接入流程

手动接入模型分为三大步骤：

步骤一：获取glm模型api key及模型配置信息。

步骤二：接入模型供应商，包括新建供应商、配置认证方式操作。

步骤三：接入模型服务，包括新建模型服务、调测验证、发布使用操作。

供应商是“谁来提供模型”，模型服务是“具体哪个模型”。先注册供应商，再在供应商下添加具体的模型。

步骤一：获取glm模型api key及配置信息

1. 在注册开发者账号。
2. 获取。
   为保障模型正常使用，智谱平台中账号余额不可为0，余额不足请在智谱平台进行充值。

   图2 获取api key
   
3. 在中获取接口信息。

   表2 glm模型接口信息

   模型信息	取值
   模型服务api地址	https://open.bigmodel.cn/api/paas/v4/chat/completions
   模型名称	智谱api文档中列举了支持使用的模型，可以选择所需模型使用，例如glm-5.1。

   图3 获取glm模型信息
   

步骤二：接入模型供应商

1. 登录，参考开通agentarts服务完成服务开通。
2. 在左侧导航栏中选择“开发中心 > 开发配置”，并进入“自定义模型”页面。单击“新建模型供应商”。参考下表完成配置。

   表3 模型供应商配置说明

   参数	填写说明
   供应商图标	按需替换。
   供应商名称	填写：智谱
   供应商英文名称	填写：zai
   描述	填写：智谱系列模型
   选择认证方式	选择：api-key
   请输入api key	输入步骤一：获取glm模型api key及配置信息获取的api key

   图4 新建模型供应商
   

步骤三：接入模型服务并测试发布

1. 模型供应商创建好后，单击供应商卡片。
   图5 模型供应商
   
2. 单击“新建模型服务”，参考下表完成glm模型配置。

   表4 新建模型服务说明

   参数	填写说明
   模型服务名称	填写：glm5.1
   模型名称	填写：glm5.1
   类型	选择：文本对话
   模型服务api地址	填写：https://open.bigmodel.cn/api/paas/v4/chat/completions 可参考步骤一：获取glm模型api key及配置信息获取。
   api接口协议	选择：标准openai协议
   流控配置	按照glm模型实际流控进行配置，glm模型流控说明请参见：。
   选择标签	使用默认设置
   自定义标签(最多5个)	使用默认设置
   模型服务描述	使用默认设置

   图6 新建模型服务
   
3. 模型配置完成后，在模型卡片中选择“模型调测”。调测完成后，回到模型卡片页面，进行模型发布。

   只有经过发布，模型才可以在智能体中使用。

   图7 模型调测与发布
   
   图8 模型调测
   

常见问题

• 接入后调测，模型无返回结果或者报错怎么办

  api-key填写错误，如多填写了bearer前缀。

  api key本身已过期或无效，需要到模型服务商j9九游会登录官网确认api key状态，必要时重新生成。

• api地址应该填基础路径还是完整路径
  需要填入模型服务商文档中给出的完整api地址，例如：

  表5 模型api地址示例

  模型服务商	api地址示例
  deepseek	https://api.deepseek.com/v1/chat/completions
  智谱	https://open.bigmodel.cn/api/paas/v4/chat/completions

  不同模型服务商的路径结构不同（如智谱是/api/paas/v4/chat/completions，deepseek是/v1/chat/completions），请以服务商官方文档为准，填写完整地址。

• 模型名称填错了怎么办

  “模型名称”字段必须与模型服务商定义的模型名称完全一致，这个值会直接作为接口请求体中model字段的值。随意填写会导致模型不可用。

  模型名称需要到模型服务商j9九游会登录官网查看，注意大小写和分隔符必须完全匹配。

  

• 可以接入本地部署的模型吗
  可以，但需要确保：

  • 模型api对agentarts平台可达（公网可访问）。
  • api符合agentart平台中的模型对接协议。