部署多智能体应用为API

虽然多智能体应用已试运行成功，但目前仍局限于开发环境，无法直接对外提供服务。为了实现应用的落地与对接，用户需提交版本并完成部署，即可通过API接口进行调用。

提交版本是将当前多智能体应用配置保存为一个不可变的版本快照；部署是将指定版本发布为可调用的API接口，创建一个独立的运行实例。

典型场景：多智能体应用试运行验证通过后，需要将其集成到企业的客服系统或业务后台中。通过提交版本并部署为API，获取API地址和认证信息，供业务系统调用。

费用说明

智能体发布后通过API接口调用时，会产生tokens消耗。

如果需要使用平台预置的MaaS模型即服务的模型，需要先开通模型并设置鉴权。具体操作请参考接入预置的付费模型，计费规则请参考MaaS模型即服务价格。
如果使用自定义接入的第三方模型，其收费规则请参考该第三方模型的官方说明。

智能体部署并通过API调用后，除模型tokens消耗外，如果开启了日志记录（LTS）、调用链（APM）、指标（AOM）功能，以及使用了API Key认证（DEW凭据托管），均会产生按需计费费用。建议在部署前了解各项服务的计费规则，合理控制成本。

前提条件

已开通AgentArts服务。
已创建并配置多智能体。

提交版本

将多智能体部署为API前，需要先提交版本，部署时是按版本进行部署。

登录AgentArts智能体平台。
在左侧导航栏，选择“开发中心 > 智能体管理 ”。
选择“多智能体”页签，单击待提交版本的多智能体应用卡片。
在“多智能体配置”页面右上角，单击“提交版本”。

已经提交版本的多智能体应用，修改后再次发布，显示为“更新版本”。

在“提交版本”页面，配置发布信息，具体参数说明请参考表1。

图1 提交版本

表1 发布多智能体参数说明
参数	说明
版本名称	系统自动生成带年月日的版本名称，以v开头。也可以自定义版本名称，由1~32个字符组成。
版本描述（非必填）	多智能体的描述信息。由0~1024个字符组成。
部署至实例	默认勾选。将该版本同步部署为API接口，便于后续接口调用。

单击“确定”。

提交成功后，在“多智能体”页面的卡片上，显示“已提交”。您可在版本历史记录中查看已提交的版本。

如果勾选“部署至实例”，进入“部署智能体”页面，具体部署操作请参考部署智能体。
（可选）查看api调用接口信息。
1. 在“版本提交”页面，单击“分享”，进入“渠道管理”页面。
2. 在“渠道管理”中单击“查看API”即可查看API调用接口信息。
如果未部署过任何版本，“查看API”页面中的API详情中的URL为空。请先完成部署后再查看。

部署智能体

未部署的智能体，不能通过API接口调用，部署是以版本为单位进行部署。

登录AgentArts智能体平台。
在左侧导航栏，选择“开发中心 > 智能体管理 ”。
选择“多智能体”页签，单击待部署的多智能体应用卡片。
在“多智能体配置”页面右上角，单击。

在“部署智能体”页面，配置部署信息如图2所示，参数配置请参考表2。

图2 部署智能体

表2 部署智能体
参数	说明
智能体名称	为创建并配置多智能体自定义的智能体名称，不可修改。
智能体版本	为提交版本的版本名称。默认为最新的版本名称，可以在下拉框中切换。
运行时名称	运行时的名称，默认以jiuwen-开头的名称，例如jiuwen-1234。仅第一次部署时支持自定义。由2~48个字符组成，包含小写字母、数字、中划线，以小写字母开头，以小写字母或数字结尾。
入站身份认证	选择调用此API接口时，使用的认证鉴权方式，如何进行认证鉴权请参考认证鉴权。 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计费说明。
日志记录	默认开启。开启日志记录功能后，智能体产生的日志会上报到云日志服务 LTS，便于日志的集中管理和分析。日志管理费用按需收取，具体计费详情请参考LTS计费说明。进入“运营运维 > 观测 > 调用链分析”的详情页，在“日志”页签中查看详细的日志信息。
指标	默认开启。开启指标功能后，智能体产生的指标数据会上报到应用运维管理 AOM，便于实时监控和分析应用的运行状态。指标管理费用按需收取，具体计费详情请参考AOM计费说明。进入“运营运维 > 观测 > 调用链分析”的详情页，在“指标”页签中查看详细的指标信息。
调用链	默认开启。开启调用链功能后，智能体产生的调用链数据会上报到应用性能管理 APM，帮助开发者追踪和分析应用的性能问题。调用链管理费用按需收取，具体计费详情请参考APM计费说明。进入“运营运维 > 观测 > 调用链分析”的详情页，在“链路信息”页签中查看详细的调用链信息。

单击“确定”。

部署成功后，可以在“部署运行 > 智能体运行时”页面，搜索运行时名称查看部署的智能体。

多智能体部署后，支持通过API调用，具体请参考通过API调用多智能体应用。
（可选）查看api调用接口信息。
1. 在“发布部署”页面，单击“分享”，进入“渠道管理”页面。
2. 在“渠道管理”中单击“查看API”即可查看API调用接口信息。

表3 多智能体应用相关操作
操作	说明
查看版本历史记录	单击，查看版本历史记录。在版本历史记录中，可以执行如下操作。复制版本：在“版本ID”右侧，单击，可以复制发布的版本ID。还原版本：单击“还原版本”，可以还原到此版本。注意：还原后，当前多智能体应用配置将不再保留，建议还原前先提交当前版本作为备份。删除版本：单击“删除”，可以删除此发布版本。