# 手动接入和使用OpenAI协议模型 #### 案例概述 当您需要使用AgentArts平台未预置的模型，或者使用自建部署的模型服务时，就需要通过"自定义模型"方式接入。 AgentArts支持接入兼容OpenAI接口规范的第三方大语言模型。本实践以**GLM模型**为例，指导您完成从获取API密钥到接入自定义模型的操作。 平台中预置的模型，可以在[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)"资产广场"中查看。 图1查看预置模型 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389355.png "点击放大") #### 什么场景需要手动接入模型 表1场景说明 | 场景 | 说明 | |:---|:---| | 平台已预置的模型 | 200万Tokens免费额度内直接使用。配置方法参考[一键为AgentArts接入模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0094.html)。 | | 华为云MaaS提供的模型 | 免费额度使用完后，对接MaaS模型API Key使用付费模型。配置方法参考[接入华为云MaaS服务付费模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0095.html)。 | | 不在MaaS支持范围的第三方模型 | 需手动配置。 | | 自建部署的模型 | 需手动配置。 | 如果平台预置模型或MaaS模型已能满足需求，优先使用前两种方式，配置更为简单。只有在确实需要特定模型时，才使用自定义接入模型方式。 #### 模型接入流程 手动接入模型分为三大步骤： 步骤一：获取GLM模型API Key及模型配置信息。 步骤二：接入模型供应商，包括新建供应商、配置认证方式操作。 步骤三：接入模型服务，包括新建模型服务、调测验证、发布使用操作。 供应商是"谁来提供模型"，模型服务是"具体哪个模型"。先注册供应商，再在供应商下添加具体的模型。 #### 步骤一：获取GLM模型API Key及配置信息 1. 在[智谱BigModel开放平台](https://zhipuaishengchan.datasink.sensorsdata.cn/t/ME)注册开发者账号。 2. 获取[智谱BigModel开放平台的API Key](https://zhipuaishengchan.datasink.sensorsdata.cn/t/ME)。 **为保障模型正常使用，智谱平台中账号余额不可为0，余额不足请在智谱平台进行充值。** 图2获取API Key ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949586.png "点击放大") 3. 在[智谱API文档](https://docs.bigmodel.cn/cn/api/introduction)中获取接口信息。 表2GLM模型接口信息 | 模型信息 | 取值 | |:---|:---| | 模型服务API地址 | https://open.bigmodel.cn/api/paas/v4/chat/completions | | 模型名称 | 智谱API文档中列举了支持使用的模型，可以选择所需模型使用，例如glm-5.1。 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789746.png "点击放大") | 图3获取GLM模型信息 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549227.png "点击放大") #### 步骤二：接入模型供应商 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)，参考[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)完成服务开通。 2. 在左侧导航栏中选择"开发中心 \> 开发配置"，并进入"自定义模型"页面。单击"新建模型供应商"。参考下表完成配置。 表3模型供应商配置说明 | 参数 | 填写说明 | |:---|:---| | 供应商图标 | 按需替换。 | | 供应商名称 | 填写：智谱 | | 供应商英文名称 | 填写：Zai | | 描述 | 填写：智谱系列模型 | | 选择认证方式 | 选择：Api-key | | 请输入API key | 输入[步骤一：获取GLM模型API Key及配置信息]获取的API key | 图4新建模型供应商 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949598.png "点击放大") #### 步骤三：接入模型服务并测试发布 1. 模型供应商创建好后，单击供应商卡片。 图5模型供应商 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389351.png "点击放大") 2. 单击"新建模型服务"，参考下表完成GLM模型配置。 表4新建模型服务说明 | 参数 | 填写说明 | |:---|:---| | 模型服务名称 | 填写：glm5.1 | | 模型名称 | 填写：glm5.1 | | 类型 | 选择：文本对话 | | 模型服务API地址 | 填写：https://open.bigmodel.cn/api/paas/v4/chat/completions 可参考[步骤一：获取GLM模型API Key及配置信息]获取。 | | API接口协议 | 选择：标准OpenAI协议 | | 流控配置 | 按照GLM模型实际流控进行配置，GLM模型流控说明请参见：[速率限制说明](https://docs.bigmodel.cn/cn/api/rate-limit)。 | | 选择标签 | 使用默认设置 | | 自定义标签(最多5个) | 使用默认设置 | | 模型服务描述 | 使用默认设置 | 图6新建模型服务 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949590.png "点击放大") 3. 模型配置完成后，在模型卡片中选择"模型调测"。调测完成后，回到模型卡片页面，进行模型发布。 只有经过发布，模型才可以在智能体中使用。 图7模型调测与发布 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789732.png "点击放大") 图8模型调测 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389343.png "点击放大") #### 常见问题 - **接入后调测，模型无返回结果或者报错怎么办** API Key填写错误，如多填写了Bearer前缀。 API Key本身已过期或无效，需要到模型服务商官网确认API Key状态，必要时重新生成。 - **API地址应该填基础路径还是完整路径** 需要填入模型服务商文档中给出的完整API地址，例如： 表5模型API地址示例 | 模型服务商 | API地址示例 | |:---|:---| | DeepSeek | https://api.deepseek.com/chat/completions | | 智谱 | https://open.bigmodel.cn/api/paas/v4/chat/completions | 不同模型服务商的路径结构不同（如智谱是/api/paas/v4/chat/completions，DeepSeek是/chat/completions），请以服务商官方文档为准，填写完整地址。 - **模型名称填错了怎么办** "模型名称"字段必须与模型服务商定义的模型名称完全一致，该值会直接作为接口请求体中model字段的值。随意填写会导致模型不可用。 模型名称需要到模型服务商官网查看，注意大小写和分隔符必须完全匹配。 ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549231.png "点击放大") - **可以接入本地部署的模型吗** 可以，但需要确保： - 模型API对AgentArts平台可达（公网可访问）。 - API符合AgentArts平台的模型对接协议。