发布应用至云商店

费用说明

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

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

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

前提条件

• 已开通AgentArts服务。
• 已创建单智能体应用。

提交版本并分享至云商店渠道

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

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

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

   表1 发布单智能体参数说明

   配置项	功能描述
   版本名称	必填。 系统根据时间戳自动生成，同时支持用户自定义。支持英文、数字、下划线，长度1~64字符。
   版本描述	（可选）在此处输入版本的详细描述，以帮助团队成员和用户了解版本更新的具体内容和改进点。 长度0~1024字符，建议填写本次更新的关键变更点，方便后续版本管理。
   部署至实例	默认勾选。 将该版本同步部署为API接口，便于后续接口调用。

   图1 提交版本
   

6. 单击“确定”。

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

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

7. 发布完成后可以单击“分享”按钮跳转至“渠道管理”页面。

   也可通过左侧导航栏中选择“开发中心 > 智能体管理”，单击目标应用，进入单智能体配置页面，选择上方“渠道管理”页签，进入渠道管理页面。

   在渠道管理页面，云商店分享渠道的操作列单击“发布”按钮后将出现“复制链接”。

   单击“复制链接”，可直接复制URL嵌入或分享到其他应用场景。

   

   • 如果未部署过任何版本，“复制链接”复制到的内容为空。请先完成部署后再查看。
   • 已发布的应用支持在Agent应用编辑页面选择“更新版本”按钮重新发布应用。也可在“是否更新版本”列单击“更新版本”，并在确认界面单击“更新版本”，该发布渠道将更新为最新版本配置。
   • “资源配置”列，单击可进行资源配置设置，支持配置“每日调用限额（次）”、“分享范围”。
     • “每日调用限额（次）”：支持用户自定义修改，默认100次。支持输入-1或0~10000，其中-1表示调用次数无限制。
     • “分享范围”：可选择当前租户可用。

对接APIG网关并提交商品发布

Agent应用分享到云商店渠道后，商家可将应用发布到华为云云商店。

APIG 网关类商品要求商家先在华为云 APIG 共享版网关上创建并发布 API，云商店发布商品时绑定 APIG 的 API 分组。

在华为云云商店发布产品请先完成这些准备工作，否则无法正常管理和上架。

1. 获取智能体API 信息。
   1. 在左侧导航栏选择“开发中心 > 智能体管理”，单击目标应用，选择上方“渠道管理”页签。
   2. 单击API调用方式操作列的“查看API”，进入API详情页，可获取服务地址、请求Path、请求方式、凭证Key、请求参数。
      

      如果未部署过任何版本，“查看API”页面中的API详情中的URL为空，请先完成部署后再查看。具体部署操作请参考部署智能体。

      图2 API详情
      
   3. 获取服务鉴权信息：凭证Value。

      在API详情页复制智能体ID，跳转至“部署运行 > 智能体运行时”进行搜索，在智能体运行详情页面打开RUN界面即可获取API Key。

      

      

2. 在 APIG 网关完成技术对接，详细操作请参见APIG网关类商品技术对接方案。

   创建API填写样例：

   图3 定义API请求
   
   图4 定义后端服务
   

3. 在卖家中心创建 APIG 网关类商品并提交审核，详细操作请参见发布APIG网关类商品。

准备工作

如需在华为云云商店发布产品请先完成以下准备，否则无法正常管理和上架：

1. 完成企业账号实名认证

   华为云账号需完成企业实名认证，支持企业法人支付宝认证、对公账户打款认证等多种方式。详细操作请参见企业账号实名认证流程。

2. 加入华为云合作伙伴网络HCPN

   完成实名认证后，申请加入 HCPN，获取合作伙伴基本权益，这是进入卖家中心的前置条件。详细操作请参见加入华为云合作伙伴网络（HCPN）。

3. 注册成为华为云商家

   加入 HCPN 后，在卖家中心提交入驻申请，完成商业信息认证（含银行账号、税率等结算信息），审核通过后方可发布商品。详细操作请参见注册成为商家。

4. 开通华为支付（可选）

   若需在云商店向买家收费，请提前完成华为支付开通。免费商品可跳过此步骤。详细操作请参见开通华为支付。

查看发布历史

单击右上角，可查看当前单智能体发布历史记录。

图5 发布历史

发布历史支持版本对比、还原版本和删除操作：

• 还原版本：单击“还原版本”，并在弹窗中单击“确定”，将还原当前单智能体应用至该历史版本的状态。当前最新配置将被覆盖，请谨慎操作。
• 删除：单击“删除”，并在弹窗中单击“确定”，将删除当前单智能体应用发布历史。

常见问题

发布后API调用返回错误码AgentArts.02001017如何处理？

原因：表示您的智能体API调用次数已达到当前套餐的额度限制。系统检测到您的API调用量已超过套餐包含的调用次数上限。

解决办法：

1. 登录AgentArts控制台，检查当前套餐的API调用额度及使用情况。
2. 如需继续使用API服务，请升级至更高套餐以获得更大的API调用额度。
3. 升级套餐后，API调用功能将恢复正常。