上报AgentArts中的智能体数据
AgentArts智能体开发平台提供了完善的可观测性能力,支持将智能体运行过程中的对话数据自动上报至运营运维平台。通过分析这些数据,开发者可以实时监测智能体运行状态、排查故障以及优化模型性能。
数据上报机制
平台采用默认开启的上报策略,具体流程如下:
- 默认行为:智能体创建后,系统默认开启数据上报开关。用户与智能体通过API调用交互产生的日志、调用链及指标数据将自动上报。
- 仅通过API调用产生的数据才会上报到运营运维。使用API调用智能体,请参考《最佳实践》中“API调用实践”章节。
- 在开通AOM、APM和LTS时,系统将自动创建一个名为AgentArts的默认资源,包括AOM实例、APM应用、LTS日志组和日志流以及IAM委托(agent-arts-default-agencynew)和相应的授权记录 。请勿随意更改这些默认资源,否则可能导致观测功能无法正常使用。
- 数据流向:
- 数据首先上报至LTS(云日志服务)、AOM(应用运维管理)和APM(应用性能管理)服务。
- 读取上报至LTS、AOM和APM的数据,展示在“运营运维 > 观测”中,支持开发者查看与分析智能体上报的数据。
- 关闭方式:如需停止数据上报,请在智能体“提交版本”页面手动关闭相应的数据上报开关。
本文档以单智能体开启数据上报为例进行说明。工作流与多智能体应用的数据上报配置方式与单智能体一致,可参照执行。
费用说明
在可观测界面展示数据不收取任何费用,但智能体数据上报至其他服务会产生相应的管理费用。具体计费场景如下:
前提条件
- 已开通AgentArts服务。
- 已创建并发布智能体。
- 已开通和授权APM和AOM,授权操作请参考管理云服务授权信息。
开启数据上报
- 在左侧导航,选择“开发中心 > 智能体管理”。
- 选择“单智能体”页签,单击需要上报数据的单智能体应用卡片。
- 在“单智能体配置”页面,单击“提交版本”。
已经发布的单智能体应用,修改后再次发布,显示为“更新版本”。
- 在“提交版本”页面,配置发布信息,并开启“日志记录”、“调用链”和“指标”开关。开启开关后,智能体的交互数据将自动上报。
在“部署运行 > 智能体运行时 ”,并单击“名称/ID”,在“编辑”页面也可以开启日志上报开关。图1 智能体发布开启数据上报开关
图2 智能体运行时开启日志上报
开关功能说明
各开关开启后,对应观测界面的展示信息如下表所示:
日志记录:在调用链详情的“日志”页签中查看智能体运行过程中的详细日志信息。
调用链:开启后,将在以下界面展示数据。
- 调用链分析:查看请求的完整调用路径及耗时分析。
- 会话分析:查看智能体与用户对话的历史数据。
图4 会话分析
指标:开启后,将在以下位置展示数据。
- 智能体概览:查看“应用指标”和“运维指标”页签中展示的统计信息。
- 调用链分析:在调用链详情页面的“指标”页签中查看相关信息。
图5 智能体概览
图6 调用链分析
查看Trace数据
数据上报成功后,您可进入“运营运维 > 观测”界面,通过以下页面分析智能体的运行数据:
- 智能体概览:展示智能体的Tokens消耗、模型调用次数和模型调用平均耗时等指标,助您快速把控整体运行情况。
- 调用链分析:请求的完整调用链路,定位性能瓶颈或故障节点。
- 会话分析:智能体与用户对话的历史数据,为优化对话逻辑与服务质量提供依据。