部署多智能体应用为api-j9九游会登录
虽然多智能体应用已试运行成功,但目前仍局限于开发环境,无法直接对外提供服务。为了实现应用的落地与对接,用户需提交版本并完成部署,即可通过api接口进行调用。
提交版本是将当前多智能体应用配置保存为一个不可变的版本快照;部署是将指定版本发布为可调用的api接口,创建一个独立的运行实例。
典型场景:多智能体应用试运行验证通过后,需要将其集成到企业的客服系统或业务后台中。通过提交版本并部署为api,获取api地址和认证信息,供业务系统调用。
费用说明
智能体发布后通过api接口调用时,会产生tokens消耗。
- 如果需要使用平台预置的maas模型即服务的模型,需要先开通模型并设置鉴权。具体操作请参考接入预置的付费模型,计费规则请参考maas模型即服务价格。
- 如果使用自定义接入的第三方模型,其收费规则请参考该第三方模型的官方说明。
智能体部署并通过api调用后,除模型tokens消耗外,如果开启了日志记录(lts)、调用链(apm)、指标(aom)功能,以及使用了api key认证(dew凭据托管),均会产生按需计费费用。建议在部署前了解各项服务的计费规则,合理控制成本。
前提条件
提交版本
将多智能体部署为api前,需要先提交版本,部署时是按版本进行部署。
- 登录。
- 在左侧导航栏,选择“开发中心 > 智能体管理 ”。
- 选择“多智能体”页签,单击待提交版本的多智能体应用卡片。
- 在“多智能体配置”页面右上角,单击“提交版本”。
已经提交版本的多智能体应用,修改后再次发布,显示为“更新版本”。
- 在“提交版本”页面,配置发布信息,具体参数说明请参考表1。 图1 提交版本
表1 发布多智能体参数说明 参数
说明
版本名称
系统自动生成带年月日的版本名称,以v开头。也可以自定义版本名称,由1~32个字符组成。
版本描述(非必填)
多智能体的描述信息。由0~1024个字符组成。
部署至实例
默认勾选。
将该版本同步部署为api接口,便于后续接口调用。
- 单击“确定”。
提交成功后,在“多智能体”页面的卡片上,显示“已提交”。您可在版本历史记录中查看已提交的版本。
如果勾选“部署至实例”,进入“部署智能体”页面,具体部署操作请参考部署智能体。
- (可选)查看api调用接口信息。
- 在“版本提交”页面,单击“分享”,进入“渠道管理”页面。
- 在“渠道管理”中单击“查看api”即可查看api调用接口信息。
如果未部署过任何版本,“查看api”页面中的api详情中的url为空。请先完成部署后再查看。
部署智能体
未部署的智能体,不能通过api接口调用,部署是以版本为单位进行部署。
- 登录。
- 在左侧导航栏,选择“开发中心 > 智能体管理 ”。
- 选择“多智能体”页签,单击待部署的多智能体应用卡片。
- 在“多智能体配置”页面右上角,单击。
- 在“部署智能体”页面,配置部署信息如图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产生的费用请参考。
日志记录
默认开启。
开启日志记录功能后,智能体产生的日志会上报到云日志服务 lts,便于日志的集中管理和分析。日志管理费用按需收取,具体计费详情请参考。
进入“运营运维 > 观测 > 调用链分析”的详情页,在“日志”页签中查看详细的日志信息。
指标
默认开启。
开启指标功能后,智能体产生的指标数据会上报到应用运维管理 aom,便于实时监控和分析应用的运行状态。指标管理费用按需收取,具体计费详情请参考。
进入“运营运维 > 观测 > 调用链分析”的详情页,在“指标”页签中查看详细的指标信息。
调用链
默认开启。
开启调用链功能后,智能体产生的调用链数据会上报到应用性能管理 apm,帮助开发者追踪和分析应用的性能问题。调用链管理费用按需收取,具体计费详情请参考。
进入“运营运维 > 观测 > 调用链分析”的详情页,在“链路信息”页签中查看详细的调用链信息。
- 单击“确定”。
部署成功后,可以在“部署运行 > 智能体运行时”页面,搜索运行时名称查看部署的智能体。
多智能体部署后,支持通过api调用,具体请参考通过api调用多智能体应用。
- (可选)查看api调用接口信息。
- 在“发布部署”页面,单击“分享”,进入“渠道管理”页面。
- 在“渠道管理”中单击“查看api”即可查看api调用接口信息。
常见问题
部署智能体时,入站身份认证选择错误,如何处理?
答:部署智能体时,入站身份认证选择后不支持修改,选择的入站身份认证在通过api接口调用此智能体时作为身份校验使用。如果选择错误,建议在智能体卡片上单击“复制”复制一个智能体,重新进行部署。
相关文档
多智能体应用发布后,可以通过api接口调用,请参考通过api调用多智能体应用。
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨