# 部署多智能体应用为API 虽然多智能体应用已试运行成功，但目前仍局限于开发环境，无法直接对外提供服务。为了实现应用的落地与对接，用户提交版本并完成部署后，即可通过API接口进行调用。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 提交版本是将当前多智能体应用配置保存为一个不可变的版本快照；部署是将指定版本发布为可调用的API接口，创建一个独立的运行实例。 **典型场景**：多智能体应用试运行验证通过后，需要将其集成到企业的客服系统或业务后台中。通过提交版本并部署为API，获取API地址和认证信息，供业务系统调用。 #### 费用说明 智能体发布后通过API接口调用时，会产生tokens消耗。 - 如果需要使用平台预置的MaaS模型即服务的模型，需要先开通模型并设置鉴权。具体操作请参考[接入预置的付费模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0185.html)，计费规则请参考[MaaS模型即服务价格](https://support.huaweicloud.com/price-maas/price-maas-0001.html)。 - 如果使用自定义接入的第三方模型，其收费规则请参考该第三方模型的官方说明。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png) 智能体部署并通过API调用后，除模型tokens消耗外，如果开启了日志记录（LTS）、调用链（APM）、指标（AOM）功能，以及使用了API Key认证（DEW凭据托管），均会产生按需计费费用。建议在部署前了解各项服务的计费规则，合理控制成本。 #### 前提条件 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 - 已[创建并配置多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0106.html)。 #### 提交版本 将多智能体部署为API前，需要先提交版本，部署时是按版本进行部署。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏，选择"开发中心 \> 智能体管理"。 3. 选择"多智能体"页签，单击待提交版本的多智能体应用卡片。 4. 在"多智能体配置"页面右上角，单击"提交版本"。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 已经提交版本的多智能体应用，修改后再次发布，显示为"更新版本"。 5. 在"提交版本"页面，配置发布信息，具体参数说明请参考[表1]。 图1提交版本 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790432.png) 表1发布多智能体参数说明 | 参数 | 说明 | |:---|:---| | 版本名称 | 系统自动生成带年月日的版本名称，以v开头。也可以自定义版本名称，由1\~64个字符组成。 | | 版本描述（非必填） | 多智能体的描述信息。由0\~1024个字符组成。 | | 部署至实例 | 默认勾选。 将该版本同步部署为API接口，便于后续接口调用。 | 6. 单击"确定"。 提交成功后，在"多智能体"页面的卡片上，显示"已提交"。您可在版本历史记录中查看已提交的版本。 如果勾选"部署至实例"，进入"部署智能体"页面，具体部署操作请参考[部署智能体]。 7. （可选）查看API调用接口信息。 1. 在"版本提交"页面，单击"分享"，进入"渠道管理"页面。 2. 在"渠道管理"中单击"查看API"即可查看API调用接口信息。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 如果未部署过任何版本，"查看API"页面中的API详情中的URL为空。请先完成部署后再查看。 #### 部署智能体 未部署的智能体，不能通过API接口调用，部署是以版本为单位进行部署。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏，选择"开发中心 \> 智能体管理"。 3. 选择"多智能体"页签，单击待部署的多智能体应用卡片。 4. 在"多智能体配置"页面右上角，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950284.png)。 5. 在"部署智能体"页面，配置部署信息如[图2]所示，参数配置请参考[表2]。 图2部署智能体 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390045.png "点击放大") 表2部署智能体 | 参数 | 说明 | |:---|:---| | 智能体名称 | 为[创建并配置多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0106.html)自定义的智能体名称，不可修改。 | | 智能体版本 | 为[提交版本]的版本名称。默认为最新版本名称，可以在下拉框中切换。切换版本后需重新部署。 | | 运行时名称 | 运行时的名称，系统默认，**仅第一次部署时支持自定义修改。** 由2\~48个字符组成，包含小写字母、数字、中划线，以小写字母开头，以小写字母或数字结尾。 | | 入站身份认证 | 选择调用此API接口时，使用的认证鉴权方式，如何进行认证鉴权请参考[认证鉴权](https://support.huaweicloud.com/api-agentarts/agentarts_07_0005.html)。默认IAM认证，**仅第一次部署时支持选择。** - IAM认证：将华为云IAM身份配置为入站身份认证，以验证调用者的身份。适用于华为云内部系统或已接入华为云IAM的系统，集成复杂度低，安全等级高。 - OAuth 2.0认证：将JWT（如OAuth令牌）配置为入站身份认证，以验证传入的令牌签名和范围。适用于已有身份提供商（如Okta、Cognito等）的企业系统，集成复杂度高，安全等级高。 - Discovery URL：身份提供商（例如Okta、Cognito等）提供的Discovery URL，该URL通常可在该提供商的文档中找到。 - JWT授权配置：配置JWT令牌的访问控制规则。 - 允许的受众：指定的受众是否在Agent Identity运行中指定的受众匹配或为其子集。 - 允许的客户端：指定的客户端标识符是否被允许访问Agent Identity。 - 允许的范围：仅当令牌包含此处配置的至少一个必须范围时，才允许访问自定义声明。 - 自定义声明：仅当令牌中的特定声明与预定义字符串值相匹配时，才允许访问。 - API Key认证：将预设的密钥对（键和值）配置为入站身份认证，以验证请求中携带的密钥合法性。适用于内部测试或轻量级集成，集成复杂度低，安全等级中。 注意： 身份认证凭证在凭据管理服务（DEW）托管，托管按需计费，使用DEW产生的费用请参考[DEW计费说明](https://support.huaweicloud.com/price-dew/dew_03_0001.html)。 | | 日志记录 | 默认开启。 开启日志记录功能后，智能体产生的日志会上报到云日志服务 LTS，便于日志的集中管理和分析。日志管理费用按需收取，具体计费详情请参考[LTS计费说明](https://support.huaweicloud.com/price-lts/lts_001_04.html)。 进入"运营运维 \> 观测 \> 调用链分析"的详情页，在"日志"页签中查看详细的日志信息。 | | 指标 | 默认开启。 开启指标功能后，智能体产生的指标数据会上报到应用运维管理 AOM，便于实时监控和分析应用的运行状态。指标管理费用按需收取，具体计费详情请参考[AOM计费说明](https://support.huaweicloud.com/price-aom2/aom_07_0004.html)。 进入"运营运维 \> 观测 \> 调用链分析"的详情页，在"指标"页签中查看详细的指标信息。 | | 调用链 | 默认开启。 开启调用链功能后，智能体产生的调用链数据会上报到应用性能管理 APM，帮助开发者追踪和分析应用的性能问题。调用链管理费用按需收取，具体计费详情请参考[APM计费说明](https://support.huaweicloud.com/price-apm2/apm_07_0019.html)。 进入"运营运维 \> 观测 \> 调用链分析"的详情页，在"链路信息"页签中查看详细的调用链信息。 | | 智能体卫士 | 默认关闭。 开启后，实时检测智能体执行链路与操作轨迹，监控全量行为并识别安全异常。不同安全风险处理规则和检测记录可前往[企业主机安全 HSS](https://support.huaweicloud.com/usermanual-hss2.0/hss_01_0048.html)管理及查看。HSS的智能体卫士当前为公测阶段，暂不收费。 | 6. 单击"确定"。 部署成功后，可以在"部署运行 \> 智能体运行时"页面，搜索运行时名称查看部署的智能体。 多智能体部署后，支持通过API调用，具体请参考[通过API调用多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0109.html)。 7. （可选）查看API调用接口信息。 1. 在"发布部署"页面，单击"分享"，进入"渠道管理"页面。 2. 在"渠道管理"中单击"查看API"即可查看API调用接口信息。 #### 常见问题 **部署智能体时，入站身份认证选择错误，如何处理？** 答：部署智能体时，入站身份认证选择后不支持修改，选择的入站身份认证在通过API接口调用此智能体时作为身份校验使用。如果选择错误，建议在智能体卡片上单击"复制"复制一个智能体，重新进行部署。 #### 相关文档 多智能体应用发布后，可以通过API接口调用，请参考[通过API调用多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0109.html)。