
# 接入模型供应商
模型供应商提供的模型服务使企业和个人能够快速获取和使用高质量模型。
在AgentArts中接入外部模型服务API前，需先接入模型供应商，用于对模型来源进行统一管理与标识。完成供应商接入后，您可在该供应商下继续接入具体的模型服务。
#### 前提条件
已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。
#### 新建模型供应商
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 在左侧导航栏，选择"开发中心 \> 开发配置"。
3. 选择"自定义模型"页签，单击"新建模型供应商"。
4. 在"新建模型供应商"页面，配置参数信息，如[图1]所示，具体参数说明请参考[表1]。
   
   图1新建模型供应商   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790388.png "点击放大")
    表1新建模型供应商参数说明 
   | 参数      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 示例                                                                                    |
   |:---|:---|:---|
   | 供应商图标   | 系统默认供应商图标，用户也可以自定义图标。 1. 鼠标移动至系统默认图标上，单击鼠标左键。  2. 在虚线框中，单击鼠标左键，上传已准备好的供应商图标。 支持jpg、png格式图片，且不大于100KB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 系统默认图标                                                                                |
   | 供应商名称   | 供应商的名称。由2\~64个字符组成，包含中英文、数字、下划线、中划线、空格、竖线。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 深度求索                                                                                  |
   | 供应商英文名称 | 供应商的英文名称。由2\~64个字符组成，包含英文、数字、下划线、中划线、空格、竖线。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | DeepSeek                                                                              |
   | 描述      | 非必填。供应商的描述信息。由0\~1000个字符组成。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 深度求索（DeepSeek），是量化巨头幻方探索AGI（通用人工智能）的新组织，成立于2023年，专注于研究世界领先的通用人工智能底层模型与技术，挑战人工智能前沿性难题。 |
   | 选择认证方式  | 选择在智能体、工作流或通过API调用该模型服务时的认证鉴权方式。 支持以下认证方式，详情请参考[表2]： - **无鉴权**：模型服务无需认证即可调用。  - **Api-key**：通过API Key进行认证。  - **AK/SK**：适用于盘古大模型的AK/SK认证方式。  - **App-code**：通过APP认证方式调用。  - **自定义ApiKey**：通过自定义请求头认证参数进行认证。  - **IAM鉴权**：华为云IAM认证，通过IAM账号获取用户Token进行认证。  - **HMAC**：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。   **关于密钥加密：** 鼠标移动至"选择认证方式"右侧的![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549877.png)上，可查看密钥的加密方式。平台默认使用**KMS加密 + 默认密钥** 方式对认证密钥进行加密存储，防止信息泄露。 - 加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。  - 费用说明：实例不收费，每月提供20,000次免费调用额度。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考[更换密钥的加密方式](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0288.html)。超出后按实际调用次数计费，详见[密码安全中心计费说明](https://support.huaweicloud.com/price-dew/dew_03_0001.html)。   | Api-key                                                                               |
      
    表2认证方式说明 
   | 认证方式      | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   |:---|:---|
   | Api-key   | 通过请求Header的Authorization字段携带Bearer \<Api-key\>进行认证。 Api-key：输入待接入的供应商模型服务的API Key。输入后关键信息将加密保存，设置后约2分钟生效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | AK/SK     | 适用于盘古大模型，通过AK/SK加密调用请求。 - AK（Access Key ID）：输入待接入的供应商模型服务的AK。输入后关键信息将加密保存。  - SK（Secret Access Key）：输入待接入的供应商模型服务的SK。输入后关键信息将加密保存。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | App-code  | 通过请求Header的"X-Apig-Appcode"字段携带App-code进行认证。 App-code：输入待接入的供应商模型服务的App-code。输入后关键信息将加密保存，设置后约2分钟生效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | 自定义ApiKey | 通过自定义请求头参数进行认证。 1. 在"Header配置"右侧，单击"+"新增Header参数。  2. 填写Header参数信息： - 参数名称：输入调用模型服务的Header参数名称。  - 参数值：输入调用模型服务的Header参数值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | IAM鉴权     | 通过华为云IAM账号获取用户Token进行认证。 **鉴权配置：** - IAM认证url：获取IAM用户Token的接口地址。例如：https://{iam_host}/v3/auth/tokens，其中{iam_host}表示IAM Endpoint地址，即承载REST服务端点的服务器域名或IP。由于不同服务在不同区域的Endpoint各不相同，详情请参见[终端节点](https://support.huaweicloud.com/api-iam/iam_01_0001.html#section2)。 例如： 您需要获取"西南-贵阳一"区域的Token，则需使用"西南-贵阳一"区域的Endpoint（iam.cn-southwest-2.myhuaweicloud.com），并结合[获取IAM用户Token（使用密码）](https://support.huaweicloud.com/api-iam/iam_30_0001.html)API的资源路径（/v3/auth/tokens），拼接后的完整请求地址如下。 ``` https://iam.cn-southwest-2.myhuaweicloud.com/v3/auth/tokens ```   - 账号名：IAM用户所属的账号名。  - 项目：服务所属的区域信息。例如：cn-southwest-2   **验证方式（二选一）：** 方式一：IAM用户名/密码 - IAM用户名：IAM用户的名称。  - IAM密码：IAM用户的登录密码。   方式二：Access Key ID / Secret Access Key - Access Key ID：访问密钥ID。  - Secret Access Key：与访问密钥ID结合使用的密钥。   |
   | HMAC      | 通过AK/SK加密签名调用请求。 - AK（Access Key ID）：输入待接入的供应商模型服务的AK。输入后关键信息将加密保存。  - SK（Secret Access Key）：输入待接入的供应商模型服务的SK。输入后关键信息将加密保存。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
      
   
   
5. 单击"确定"完成模型供应商接入。 
   新建的模型供应商将显示在"自定义模型"供应商卡片列表中，默认状态为"已配置鉴权"。处于"已配置鉴权"状态的模型供应商下的模型服务支持调测和使用。
   
   
6. 完成模型供应商接入后，请参见[接入模型服务](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0191.html)接入具体的模型API，并进行调测与发布。
 
#### 相关操作
在模型供应商卡片列表，支持的其他操作请参考[表3]。
 表3模型供应商信息相关操作 
| 操作        | 说明                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|
| 查看模型供应商信息 | 单击模型供应商卡片，进入供应商详情页，查看模型供应商基本信息。                                                                                                                                                                                                                                                                                                             |
| 移除鉴权配置    | 警告： 移除鉴权配置后，该供应商下的所有模型将**无法**进行调测和使用，可能导致依赖这些模型的智能体服务中断。 在新增模型供应商时，"鉴权方式"选择"Api-key"、"AK/SK"、"App-code"、"自定义ApiKey"、"IAM鉴权"、"HMAC"时，才支持移除鉴权配置。 鼠标移动至需要移除鉴权配置的模型供应商卡片上，单击"鉴权配置"，单击"移除"。 移除鉴权配置后，模型服务为"未配置鉴权"，**未配置鉴权**的模型，不支持调测、使用。 |
| 修改模型供应商信息 | 鼠标移动至需要修改的模型供应商卡片上，单击"编辑"。                                                                                                                                                                                                                                                                                                                  |
| 删除模型供应商   | 警告： 删除模型供应商将永久清除该供应商的所有配置信息，且不可恢复。如果供应商下存在已发布的模型服务，需先删除相关模型服务后方可执行。 鼠标移动至需要删除的模型供应商卡片上，单击"删除"。                                                                                                                                                                                                            |
   
#### 相关文档
[接入和使用DeepSeek模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0005.html)
[手动接入和使用OpenAI协议模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0096.html)
