更新时间:2026-07-15 gmt 08:00

部署多智能体应用为api-j9九游会登录

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

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

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

费用说明

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

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

    智能体部署并通过api调用后,除模型tokens消耗外,如果开启了日志记录(lts)、调用链(apm)、指标(aom)功能,以及使用了api key认证(dew凭据托管),均会产生按需计费费用。建议在部署前了解各项服务的计费规则,合理控制成本。

提交版本

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

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

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

  5. 在“提交版本”页面,配置发布信息,具体参数说明请参考表1
    图1 提交版本
    表1 发布多智能体参数说明

    参数

    说明

    版本名称

    系统自动生成带年月日的版本名称,以v开头。也可以自定义版本名称,由1~32个字符组成。

    版本描述(非必填)

    多智能体的描述信息。由0~1024个字符组成。

    部署至实例

    默认勾选。

    将该版本同步部署为api接口,便于后续接口调用。

  6. 单击“确定”。

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

    如果勾选“部署至实例”,进入“部署智能体”页面,具体部署操作请参考部署智能体

  7. (可选)查看api调用接口信息。
    1. 在“版本提交”页面,单击“分享”,进入“渠道管理”页面。
    2. “渠道管理”中单击“查看api”即可查看api调用接口信息。

    如果未部署过任何版本,“查看api”页面中的api详情中的url为空。请先完成部署后再查看。

部署智能体

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

  1. 登录。
  2. 在左侧导航栏,选择“开发中心 > 智能体管理 ”。
  3. 选择“多智能体”页签,单击待部署的多智能体应用卡片。
  4. 在“多智能体配置”页面右上角,单击。
  5. 在“部署智能体”页面,配置部署信息如图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,帮助开发者追踪和分析应用的性能问题。调用链管理费用按需收取,具体计费详情请参考。

    进入“运营运维 > 观测 > 调用链分析”的详情页,在“链路信息”页签中查看详细的调用链信息。

  6. 单击“确定”。

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

    多智能体部署后,支持通过api调用,具体请参考通过api调用多智能体应用

  7. (可选)查看api调用接口信息。
    1. 在“发布部署”页面,单击“分享”,进入“渠道管理”页面。
    2. “渠道管理”中单击“查看api”即可查看api调用接口信息。

常见问题

部署智能体时,入站身份认证选择错误,如何处理?

答:部署智能体时,入站身份认证选择后不支持修改,选择的入站身份认证在通过api接口调用此智能体时作为身份校验使用。如果选择错误,建议在智能体卡片上单击“复制”复制一个智能体,重新进行部署。

相关文档

多智能体应用发布后,可以通过api接口调用,请参考通过api调用多智能体应用

相关文档

网站地图