发布应用为API服务

费用说明

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

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

前提条件

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

发布Agent应用为API服务

1. 登录AgentArts智能体开发平台。
2. 单击左侧导航栏“开发中心 > 智能体管理”，单击左上角“单智能体”页签，进入单智能体应用管理界面。
   图1 单智能体应用开发页面
   

3. 应用开发主页面，选择已创建的Agent应用或单击左上角的“创建单智能体”按钮。创建应用时需在弹出的创建应用子窗口中填入应用“名称”、“描述”后单击“确定”进入应用编辑页面。
   图2 创建应用
   

4. 在应用编辑页面完成该应用的功能编辑调试，然后单击右上角的“提交版本”按钮。在弹出的发布信息填写提示窗中填写本发布的“版本名称”和“版本描述”信息，根据业务需求配置日志记录、调用链指标等，单击“确定”，系统将根据设置的日志记录、调用链和指标等功能，自动上报相关数据，并按需收取相应的管理费用。

   表1 提示界面信息

   配置项	功能描述
   版本名称	必填。 系统根据时间戳自动生成，同时支持用户自定义。支持英文、数字、下划线，长度1~64字符。
   版本描述	（可选）在此处输入版本的详细描述，以帮助团队成员和用户了解版本更新的具体内容和改进点。 长度0~1024字符，建议填写本次更新的关键变更点，方便后续版本管理。
   日志记录	默认开启。 开启日志功能后，智能体产生的日志会上报到云日志服务(LTS)，便于日志的集中管理和分析。日志管理费用按需收取，具体计费详情请参阅LTS计费详情。 日志信息展示在“运营运维 > 观测 > 调用链分析”的详情页的“日志”页签中。
   调用链	默认开启。 开启调用链功能后，智能体产生的调用链数据会上报到应用性能管理(APM)，帮助开发者追踪和分析应用的性能问题。调用链管理费用按需收取，具体计费详情请参阅APM计费详情。 调用链信息展示在“运营运维 > 观测 > 调用链分析”的详情页的“链路信息”页签中。
   指标	默认开启。 开启指标功能后，智能体产生的指标数据会上报到应用运维管理(AOM)，便于实时监控和分析应用的运行状态。指标管理费用按需收取，具体计费详情请参阅AOM计费详情。 指标信息展示在“运营运维 > 观测 > 调用链分析”的详情页的“指标”页签中。

   图3 编辑Agent应用
   
   图4 填写版本信息
   

   

   已发布的应用支持在Agent应用编辑页面选择“更新版本”按钮重新发布应用。

5. 发布完成后单击“分享”按钮跳转至“渠道管理”页面，可以查看API调用接口信息。
   也可通过左侧导航栏中选择“开发中心 > 智能体管理”，单击目标应用，进入单智能体配置页面，选择上方“渠道管理”页签，进入渠道管理页面。

   图5 调用API
   

通过API运行应用

应用发布为API服务之后，可通过API调用单智能体应用。详细说明可参考使用API调用单智能体应用。

典型场景

• 系统集成：将智能体能力集成到企业OA系统或客服工作台，通过API实现后台自动处理。
• 批量处理：通过脚本批量调用API，自动化处理大量文本数据。
• 自定义前端：获取API接口后，结合企业自有UI框架构建专属的对话交互界面。

常见问题

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

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

解决办法：

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