手动接入和使用OpenAI协议模型

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

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

平台中预置的模型，可以在AgentArts智能体开发平台“资产广场”中查看。

图1 查看预置模型

场景	说明
平台已预置的模型	200万Tokens免费额度内直接使用。配置方法参考一键为AgentArts接入模型。
华为云MaaS提供的模型	免费额度使用完后，对接MaaS模型API Key使用付费模型。配置方法参考接入华为云MaaS服务付费模型。
不在MaaS支持范围的第三方模型	需手动配置。
自建部署的模型	需手动配置。

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

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

步骤一：获取GLM模型API Key及模型配置信息。

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

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

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

在智谱BigModel开放平台注册开发者账号。
获取智谱 BigModel 开放平台的API Key。

为保障模型正常使用，智谱平台中账号余额不可为0，余额不足请在智谱平台进行充值。
图2 获取API Key

在智谱API文档中获取接口信息。

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

图3 获取GLM模型信息
点击放大

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

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

图4 新建模型供应商
点击放大

单击“新建模型服务”，参考下表完成GLM模型配置。

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

图6 新建模型服务

接入后调测，模型无返回结果或者报错怎么办
Api-key填写错误，如多填写了Bearer 前缀。

API Key本身已过期或无效，需要到模型服务商官网确认API Key状态，必要时重新生成。
API地址应该填基础路径还是完整路径
需要填入模型服务商文档中给出的完整API地址，例如：

表4 模型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字段的值。随意填写会导致模型不可用。

模型名称需要到模型服务商官网查看，注意大小写和分隔符必须完全匹配。
可以接入本地部署的模型吗
可以，但需要确保：

模型API对AgentArts平台可达（公网可访问）。

API符合AgentArt平台中的模型对接协议。