# 发布应用至云商店
华为云云商店是面向企业和开发者的数字化商品交易平台，支持将 API 能力以标准化商品形式对外售卖。通过将 AgentArts 智能体发布至云商店，您可以：
- **实现能力变现**：将构建好的智能体封装为可购买的 API 商品，按调用次数向买家收费。
- **扩大服务覆盖**：借助云商店的流量和分发能力，让更多企业用户发现并使用您的智能体服务。
- **标准化交付**：通过 APIG 网关统一管理 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_0016.html)。
 
#### 提交版本并分享至云商店渠道
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发布单智能体参数说明 
   | 配置项   | 功能描述                                                                                                                                  |
   |:---|:---|
   | 版本名称  | 必填。 系统根据时间戳自动生成，同时支持用户自定义。支持英文、数字、下划线，长度1\~64字符。                                                                                      |
   | 版本描述  | （可选）在此处输入版本的详细描述，以帮助团队成员和用户了解版本更新的具体内容和改进点。 长度0\~1024字符，建议填写本次更新的关键变更点，方便后续版本管理。 |
   | 部署至实例 | 默认勾选。 将该版本同步部署为API接口，便于后续接口调用。                                                  |
      
   图1提交版本   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950008.png "点击放大")
   
   
6. 单击"确定"。 
   提交成功后，在"单智能体"页面的卡片上，显示"已提交"。您可在版本历史记录中查看已提交的版本。
   如果勾选"部署至实例"，进入"部署智能体"页面，具体部署操作请参考[部署智能体](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0031.html#agentarts_05_0031__section1213335415018)。
   
   
7. 发布完成后可以单击"分享"按钮跳转至"渠道管理"页面。 
   也可通过左侧导航栏中选择"开发中心 \> 智能体管理"**，**单击目标应用，进入单智能体配置页面，选择上方"渠道管理"页签，进入渠道管理页面。
   在**渠道管理** 页面，**云商店** 分享渠道的**操作**列单击"发布"按钮后将出现"复制链接"。
   单击"复制链接"，可直接复制URL嵌入或分享到其他应用场景。
   ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
   - 如果未部署过任何版本，"复制链接"复制到的内容为空。请先完成部署后再查看。
   
   - 已发布的应用支持在Agent应用编辑页面选择"更新版本"按钮重新发布应用。也可在"是否更新版本"列单击"更新版本"，并在确认界面单击"更新版本"，该发布渠道将更新为最新版本配置。
   
   - "资源配置"列，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790414.png)可进行资源配置设置，支持配置"每日调用限额（次）"、"分享范围"。
     - "每日调用限额（次）"：支持用户自定义修改，默认100次。支持输入-1或0\~10000，其中-1表示调用次数无限制。
     
     - "分享范围"：可选择当前租户可用。
      
    
   
   
 
#### 对接APIG网关并提交商品发布
Agent应用分享到云商店渠道后，商家可将应用发布到华为云云商店。
APIG 网关类商品要求商家先在华为云 APIG 共享版网关上创建并发布 API，云商店发布商品时绑定 APIG 的 API 分组。
![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
在华为云云商店发布产品请先完成这些[准备工作]，否则无法正常管理和上架。
1. 获取智能体API 信息。 
   1. 在左侧导航栏选择"开发中心 \> 智能体管理"，单击目标应用，选择上方"渠道管理"页签。
   
   2. 单击API调用方式操作列的"查看API"，进入API详情页，可获取服务地址、请求Path、请求方式、凭证Key、请求参数。
      ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
      如果未部署过任何版本，"查看API"页面中的API详情中的URL为空，请先完成部署后再查看。具体部署操作请参考[部署智能体](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0031.html#agentarts_05_0031__section1213335415018)。
      图2服务地址   
      ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950264.png "点击放大")
      图3请求信息   
      ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390019.png "点击放大") 
   
   3. 获取服务鉴权信息：凭证Value。 在API详情页复制智能体ID，跳转至"部署运行 \> 智能体运行时"进行搜索，在智能体运行详情页面打开RUN界面即可获取API Key。
      ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549903.png "点击放大")
      ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950262.png "点击放大")
      
   
   
   
   
2. 在 APIG 网关完成技术对接，详细操作请参见[APIG网关类商品技术对接方案](https://support.huaweicloud.com/usermanual-marketplace/sp_topic_0000232.html)。
   
   创建API填写样例：
   图4定义API请求   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390023.png "点击放大")
   图5定义后端服务   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950260.png "点击放大")
   
   
3. 在卖家中心创建 APIG 网关类商品并提交审核，详细操作请参见[发布APIG网关类商品](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_topic_0000001291591952.html)。
 
 #### 准备工作
如需在华为云云商店发布产品请先完成以下准备，否则无法正常管理和上架：
1. 完成企业账号实名认证 
   华为云账号需完成企业实名认证，支持企业法人支付宝认证、对公账户打款认证等多种方式。详细操作请参见[企业账号实名认证流程](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0077914253.html)。
   
   
2. 加入华为云合作伙伴网络HCPN 
   完成实名认证后，申请加入 HCPN，获取合作伙伴基本权益，这是进入卖家中心的前置条件。详细操作请参见[加入华为云合作伙伴网络（HCPN）](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0071293210.html)。
   
   
3. 注册成为华为云商家 
   加入 HCPN 后，在卖家中心提交入驻申请，完成商业信息认证（含银行账号、税率等结算信息），审核通过后方可发布商品。详细操作请参见[注册成为商家](https://support.huaweicloud.com/usermanual-marketplace/sp_topic_0000007.html)。
   
   
4. 开通华为支付（可选） 
   若需在云商店向买家收费，请提前完成华为支付开通。免费商品可跳过此步骤。详细操作请参见[开通华为支付](https://support.huaweicloud.com/usermanual-marketplace/zh-cn_topic_00000026022400.html)。
   
   
 
#### 查看发布历史
单击右上角![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949946.png)，可查看当前单智能体发布历史记录。
图6发布历史   
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549589.png "点击放大")
![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
发布历史支持版本对比、还原版本和删除操作：
- 还原版本：单击"还原版本"，并在弹窗中单击"确定"，将还原当前单智能体应用至该历史版本的状态。当前最新配置将被覆盖，请谨慎操作。
- 删除：单击"删除"，并在弹窗中单击"确定"，将删除当前单智能体应用发布历史。
 
#### 常见问题
发布后API调用返回错误码AgentArts.02001017如何处理？
**原因：**表示您的智能体API调用次数已达到当前套餐的额度限制。系统检测到您的API调用量已超过套餐包含的调用次数上限。
**解决办法：**
1. 登录AgentArts控制台，检查当前套餐的API调用额度及使用情况。
2. 如需继续使用API服务，请升级至更高套餐以获得更大的API调用额度。
3. 升级套餐后，API调用功能将恢复正常。