接入模型供应商
模型供应商提供的模型服务使企业和个人能够快速获取和使用高质量模型。
在AgentArts中接入外部模型服务API前,需先接入模型供应商,用于对模型来源进行统一管理与标识。完成供应商接入后,您可在该供应商下继续接入具体的模型服务。
前提条件
- 已开通AgentArts服务。
- 登录用户为空间所有者、空间管理员、开发工程师、运维工程师,详细信息请参考管理团队空间成员。
新建模型供应商
- 登录AgentArts智能体开发平台,在左侧导航栏“个人空间”区域,选择目标空间。
- 在左侧导航栏,选择“开发中心 > 开发配置”。
- 选择“自定义模型”页签,单击“新建模型供应商”。
图1 新建模型供应商
- 在“新建模型供应商”页面,配置参数信息,如图2所示,具体参数说明请参考表1。
表1 新建模型供应商参数说明 参数
说明
示例
供应商图标
系统默认供应商图标,用户也可以自定义图标。
系统默认图标
供应商名称
供应商的名称。由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进行认证。
关于密钥加密:鼠标移动至“选择认证方式”右侧的
上,可参看密钥的加密方式。平台默认使用KMS加密 + 默认密钥方式对认证密钥进行加密存储,防止信息泄露。
- 加密机制:使用用户选择的密钥派生DEK进行加密,默认密钥为kms-agentarts/default。
- 费用说明:实例不收费,每月提供20,000次免费调用次数。解密时支持缓存,但敏感数据较多时可能超出免费次数。如需更换加密方式,具体请参考更换密钥的加密方式。
Api-key
表2 认证方式说明 认证方式
参数说明
Api-key
通过请求Header的Authentication字段携带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
通过自定义请求头参数进行认证。
- 在“Header配置”右侧,单击“+”新增Header参数。
- 填写Header参数信息:
- 参数名称:输入调用模型服务的Header参数名称。
- 参数值:输入调用模型服务的Header参数值。
IAM鉴权
通过华为云IAM账号获取用户Token进行认证。
鉴权配置:
- IAM认证url:获取IAM用户Token的接口地址。例如:https://{iam_host}/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结合使用的密钥。
- 单击“确定”完成模型供应商接入。
新建的模型供应商将显示在“自定义”模型供应商卡片列表中,默认状态为“已配置鉴权”。处于“已配置鉴权”状态的模型供应商下的模型服务支持调测和使用。
- 完成模型供应商接入后,请参见接入模型服务接入具体的模型API,并进行调测与发布。
相关操作
在模型供应商卡片列表,支持的其他操作请参考表3。
|
操作 |
说明 |
|---|---|
|
移除鉴权配置 |
警告:
移除鉴权配置后,模型不支持调测、使用。 在新增模型供应商时,“鉴权方式”选择“Api-key”、“AK/SK”、“App-code”、“自定义ApiKey”、“IAM鉴权”时,才支持移除鉴权配置。 鼠标移动至需要移除鉴权配置的模型供应商卡片上,单击“鉴权配置”,单击“移除”。 移除鉴权配置后,模型服务为“未配置鉴权”,未配置鉴权的模型,不支持调测、使用。 |
|
修改模型供应商信息 |
鼠标移动至需要修改的模型供应商卡片上,单击“编辑”。 |
|
删除模型供应商 |
注意:
模型供应商中有已发布的模型服务,需要先删除模型服务。 鼠标移动至需要删除的模型供应商卡片上,单击“删除”。 |
