# 模型 模型服务为智能体提供核心推理能力，是智能体实现自主决策和任务执行的基础。 模型管理为用户提供自定义模型服务的统一接入与全生命周期管理能力，实现模型提供商、模型服务和模型代理的一站式配置与运维。 模型管理支持两种访问方式：私网访问（通过模型代理）和公网访问（直接访问），根据模型提供商的网络配置决定。 图1工作原理 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002774774983.png "点击放大") **公网访问（直接访问）** 适用于网络配置为"公网"的模型提供商，无需创建模型代理，调用方直接通过base_url访问后端。 1. 调用方发起请求：Agent或SDK直接向模型提供商的base_url发起推理请求。 2. 出站身份认证：模型供应商下的模型服务的鉴权方式。 3. 访问后端：请求被转发到模型提供商后端（如OpenAI、Anthropic等），返回推理结果。 **私网访问（通过模型代理）** 适用于网络配置为"私网"的模型提供商，需创建模型代理作为访问入口。 1. 调用方发起请求：Agent或SDK通过 /inference/{path} 向模型代理发起推理请求。 2. 入站认证：模型代理验证调用方身份，确保只有授权的调用方才能访问后端模型，防止未授权访问。入站认证在创建模型代理时配置。 3. 转发到模型提供商：模型代理将请求转发到关联的模型提供商。 4. 出站身份认证：模型供应商下的模型服务的鉴权方式。 5. 访问后端：请求被转发到模型提供商后端（如OpenAI、Anthropic等），返回推理结果。 关于更多模型的介绍请参考[模型介绍](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_108.html)。 模型在Managed Agents由用户自定义配置，配置后，在创建智能体时支持选择。 #### 前提条件 - 已开通AgentArts服务，并在"管理中心 \> 授权管理"完成依赖云服务授权。 #### 接入公网模型 公网模型，即通过互联网直接调用各厂商云端API（如OpenAI、华为云MaaS等）所接入的模型。 这里以接入华为云MaaS的GLM-5.3模型为例，采用OpenAI兼容协议，区域选择"西南-贵阳一"。 在"创建智能体"页面，"模型及提示词"区域，单击"模型管理"，配置模型信息。 图2管理模型 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743491644.png "点击放大") #### 查看及获取MaaS的GLM-5.3模型信息 1. 进入"西南-贵阳一"[MaaS页面](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)，选择"模型推理 \> 在线推理"，找到GLM-5.3模型，查看模型类型。 图3获取模型信息1 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002774917425.png "点击放大") 2. 单击"API调用 \> 主推版本"，查看接口协议，获取API地址（Base_url）、model参数值（模型名称）、认证方式及位置。 图4获取模型信息2 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002745198248.png "点击放大") 3. 获取API Key。 在MaaS左侧导航，选择"模型与统计 \> API Key 管理"，单击"创建 API Key"，如[图5]所示，单击"确定"，复制保存API Key信息。 图5创建API Key ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002774797323.png "点击放大") 4. 查看API Key鉴权请求格式。 在[OpenAI兼容接口](https://support.huaweicloud.com/model-call-maas/model-call-021.html)页面，查看鉴权请求。 图6API Key请求格式 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002745358138.png "点击放大") #### 接入模型供应商 模型供应商提供的模型服务使企业和个人能够快速获取和使用高质量模型。在接入模型服务之前需要先接入模型供应商。 单击"添加模型供应商"，配置模型供应商信息。 **基本信息** 如[图7]所示。Base_url为模型API地址，获取方法请参考[2]。 图7配置模型供应商信息 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002772926671.png "点击放大") **权限与访问控制** 如[图7]所示。 图8权限与访问控制 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002774917427.png) - 出站身份认证：模型供应商下的模型服务的鉴权方式。获取请参考[2]。 支持API Key和IAM两种认证方式。 - IAM认证 选择出站身份，如下拉框无选项请单击"创建出站身份"，创建"IAM 委托"类型的出站身份，如果无IAM信任委托需[创建信任委托](https://support.huaweicloud.com/usermanual-iam5/iam_01_1163.html)。 图9创建信任委托 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743247532.png "点击放大") 使用的IAM信任委托需包含如下action： sts::setContext：获取STS5委托所需权限，获取临时凭据时携带用户工作负载访问令牌（workload access token）信息。 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002772926679.png) - API Key：在转发请求时，将API Key附加到请求头或查询参数中。 - 选择出站身份，如下拉框无选项请单击"创建出站身份"，创建"API Key"类型的出站身份。 API Key值：获取方式请参考[3]。 图10创建出站身份 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002745198250.png "点击放大") - 选择位置。 选择API Key的传递位置。获取请参考[2]和[4]。 - 标头：在HTTP请求的头部字段中传递API Key。 - 查询参数：在HTTP请求的URL中传递API Key。 - 参数名称（可选）：输入参数名称，在请求中传递API的密钥时使用的具体名称，默认为Authorization。 - 前缀（可选）：在请求头中传递API Key时，API密钥值之前的前缀部分，如在授权标头中使用的"Bearer"。填写时不需要增加空格，平台会自动在密钥值前添加空格组装，例如填写"Bearer"，平台最终组装为"Bearer xxx"进行传递。 - 出网网络配置：访问模型提供商后端的网络。 - 公网访问 能够连接到外部的互联网，访问外部的资源和服务。 - 私网访问 连接内部的私有网络，访问内部的资源和服务。 - 选择已配置的VPC，如未配置，请单击"新建VPC"，具体请参考[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 - 选择已配置的子网，如未配置，请单击"新建子网"，具体请参考[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 - 选择已配置的安全组，如未配置，请单击"新建安全组"，具体请参考[创建安全组](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013748715.html)。 配置后如修改模型供应商信息，则已关联模型代理不可更改出网网络配置。 **高级配置**：保持默认即可。 图11高级配置 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743247530.png "点击放大") 为模型供应商添加标签，便于后续管理、搜索。 模型供应商信息配置完成后，即可[接入模型服务]。 #### 接入模型服务 1. 单击"添加模型服务"，配置模型信息，如[图12]所示，配置完成后，单击"确定"。 模型名称：查看GLM-5.3接口中的model字段值，具体请参考[2]。 API接口协议：查看GLM-5.3遵循的接口协议，具体请参考[2]。 模型类型：查看GLM-5.3的模型类型，具体请参考[1]。 图12配置模型信息 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002772926677.png "点击放大") 2. 单击"创建"。 模型供应商显示在模型列表中，接入的模型服务显示在模型供应商详情页面的模型服务列表中，即可被选择使用。 #### 接入私网模型 私网模型，即部署在公司或个人的局域网/私有服务器中的模型。 在"创建智能体"页面，"模型及提示词"区域，单击"模型管理"，配置模型信息。 图13管理模型 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002773130783.png "点击放大") #### 接入模型供应商 模型供应商提供的模型服务使企业和个人能够快速获取和使用高质量模型。在接入模型服务之前需要先接入模型供应商。 单击"添加模型供应商"，配置模型供应商信息。 **基本信息** 如[图14]所示。 Base_url：https://*\<主机名或IP\>:\<端口\>/\<可选的基础路径\>* 图14配置模型供应商基本信息 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743404344.png "点击放大") **权限与访问控制** 图15权限与访问示例 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743405420.png) - 出站身份认证：模型供应商下的模型服务的鉴权方式。 支持API Key和IAM两种认证方式。 - IAM认证 选择出站身份，如下拉框无选项请单击"创建出站身份"，创建"IAM 委托"类型的出站身份，如果无IAM信任委托需[创建信任委托](https://support.huaweicloud.com/usermanual-iam5/iam_01_1163.html)。 图16创建信任委托 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743407418.png "点击放大") 使用的IAM信任委托需包含如下action： sts::setContext：获取STS5委托所需权限，获取临时凭据时携带用户工作负载访问令牌（workload access token）信息。 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002772766769.png) - API Key：在转发请求时，将API Key附加到请求头或查询参数中。 - 选择出站身份，如下拉框无选项请单击"创建出站身份"，创建"API Key"类型的出站身份。 - 选择位置。 选择API Key的传递位置。 - 标头：在HTTP请求的头部字段中传递API Key。 - 查询参数：在HTTP请求的URL中传递API Key。 - 参数名称（可选）：输入参数名称，在请求中传递API的密钥时使用的具体名称，默认为Authorization。 - 前缀（可选）：在请求头中传递API Key时，API密钥值之前的前缀部分，如在授权标头中使用的"Bearer"。填写时不需要增加空格，平台会自动在密钥值前添加空格组装，例如填写"Bearer"，平台最终组装为"Bearer xxx"进行传递。 - 出网网络配置：访问模型提供商后端的网络。 - 公网访问 能够连接到外部的互联网，访问外部的资源和服务。 - 私网访问 连接内部的私有网络，访问内部的资源和服务。 - 选择已配置的VPC，如未配置，请单击"新建VPC"，具体请参考[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 - 选择已配置的子网，如未配置，请单击"新建子网"，具体请参考[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 - 选择已配置的安全组，如未配置，请单击"新建安全组"，具体请参考[创建安全组](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013748715.html)。 配置后如修改模型供应商信息，则已关联模型代理不可更改出网网络配置。 **高级配置**：默认即可。 图17高级配置 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743245680.png "点击放大") 为模型供应商添加标签，方便按类别筛选、检索和区分多个模型供应商。 模型供应商信息配置完成后，即可[接入模型服务]。 #### 接入模型服务 单击"添加模型服务"，配置模型信息，如[图18]所示，配置完成后，单击"确定"。 模型名称：模型接口中的model字段值。 API接口协议：模型接口遵循的接口协议。 图18配置模型信息 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002772925777.png "点击放大") #### 接入模型代理 私网模型部署在VPC内网中，与公网隔离，外部服务无法直接访问。配置模型代理是为了在网络隔离的环境下，通过代理转发请求，实现对私网内模型服务的访问。 1. 单击"添加模型代理"，如[图19]所示，配置完成后，单击"确定"。 图19接入模型代理 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743407276.png "点击放大") - **入站身份认证** ：调用模型时，验证请求身份信息。 支持以下两种认证方式： - IAM认证：将华为云IAM身份配置为入站身份认证，以验证调用者的身份。 - API Key认证：将预设的密钥对（键和值）配置为入站身份认证，以验证请求中携带的密钥合法性。选择后需配置API Key名称。 用于指定在HTTP请求头中传递API Key的键名，调用方需在请求头中携带该键名和对应的密钥值。系统会自动生成API Key的名称，可根据需求自定义修改。 - **入网配置** ：通过互联网或者VPC内网访问模型代理。 如下拉框无选项，请单击[前往网络配置](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_068.html)创建新的网络配置。 - **委托** ：为保证模型代理正常运行，所选委托需具备相关权限。 可使用系统默认创建的AgentArtsGatewayAgency委托。 如需手动创建，请单击"创建委托"并参考如下配置创建。 - 委托名称：自定义。 - 信任主体类型：选择"云服务"。 - 云服务：搜索service.WorkloadSandboxMetadata。 - 其余参数使用默认值。 图20创建委托 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743257652.png "点击放大") 委托创建完成后可对委托进行授权，操作具体详情请参考[创建委托并授权](https://support.huaweicloud.com/usermanual-iam/iam_06_0002.html)。 2. 单击"创建"。 模型供应商显示在模型列表中，接入的模型服务显示在模型供应商详情页面的模型服务列表中，配置的模型代理显示在模型供应商详情页面的模型代理列表中，即可被选择使用。 #### 在智能体中使用模型 在创建智能体时，选择接入的模型。 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002739791752.png "点击放大") #### 后续步骤 [将工作交给智能体](https://support.huaweicloud.com/managedagents-agentarts/agentarts_13_0015.html)