更新时间:2026-06-11 GMT+08:00
分享

数据上报概述

智能体应用不同于传统的确定性程序,其运行过程具有高度的动态性和复杂性。在单次任务执行中,往往涉及大模型推理、外部工具调用等多个环节的链式组合。

在开发与运维过程中,开发者常面临以下挑战:

  • “黑盒”运行:难以直观判断智能体为何做出某种决策,或在哪一步骤发生了阻塞。
  • 故障定界难:当智能体输出结果异常时,难以快速定位是模型幻觉、工具调用失败还是上下文溢出所致。
  • 性能瓶颈模糊:无法量化各环节(如模型响应耗时、工具执行时长)的性能分布,难以进行针对性优化。

AgentArts观测能够将智能体的运行过程“透明化”。AgentArts观测提供智能体运行数据采集与分析能力,支持平台原生应用自动上报高代码应用集成上报第三方智能体通过OpenTelemetry上报三种模式,帮助开发者实现智能体运行的全程可观测性。

请根据您的应用开发方式选择对应的数据上报接入:如果在AgentArts平台创建的智能体,平台会自动上报;如果为本地高代码开发,选择高代码集成上报如果是非AgentArts平台开发的第三方智能体,选择通过OpenTelemetry上报

表1 上报方式

应用开发方式

上报方式

接入方式

在AgentArts平台内创建的智能体

平台原生自动上报

在智能体“提交版本”页面配置数据上报开关。随后通过API方式调用智能体,系统将自动采集并上报观测数据。

本地代码开发并托管至AgentArts平台运行的智能体

托管至AgentArts平台后上报

部署至AgentArts运行时后上报。通过API或AgentArts SDK调用后,自动采集并上报观测数据。如需查看上报的运行数据,请参考查看高代码应用运行数据

非AgentArts平台开发的第三方智能体

通过OpenTelemetry上报

在平台创建智能体获取接入凭证,通过OpenTelemetry埋点上报数据至AgentArts。

在观测界面展示数据不收取任何费用,但智能体数据上报产生的日志、指标及调用链数据将分别上报至LTS、AOM和APM服务,会产生相应的管理费用,请在开启前评估成本。具体计费场景如下:

LTS、AOM和APM服务采用按需计费,并提供一定量的免费额度,超出免费额度部分按实际使用量计费。详细计费规则可参考对应服务的计费说明。

  • 日志记录:开启后,日志数据会上报到云日志服务LTS,费用明细请参考LTS计费说明
  • 调用链:开启后,调用链数据会上报到应用性能管理APM,费用明细请参考APM计费说明
  • 指标:开启后,指标数据会上报到应用运维管理AOM,费用明细请参考AOM计费说明

AgentArts智能体数据上报

针对在AgentArts平台上创建的单智能体、工作流及多智能体应用,系统默认开启自动上报,提交发布智能体版本时,用户可以保持开启或手动关闭。

  • 全流程自动采集:智能体发布后,系统将自动上报通过API调用产生的数据。

    当前暂不支持上报控制台上预览调试产生的数据。

  • 应用调优:开发者可以使用Trace数据实时查看各环节(如模型推理、工具调用)的执行情况。通过可视化的调用链路,快速定位逻辑中断或性能瓶颈,实现智能体的优化。

如下图所示,在“观测 > 调用链分析”页面中,可以清晰地查看并筛选出用户请求上报的数据及执行细节。

图1 AgentArts智能体

高代码智能体数据上报

针对开发者本地开发的智能体应用,AgentArts提供灵活的集成接入能力,打破环境壁垒,实现统一观测。

  • 灵活接入:支持将本地开发的智能体应用接入AgentArts平台。采用SDK集成直接托管的方式,并配置数据上报开关,即可实现运行数据的自动上报。如何上报数据请参考上报高代码智能体数据
  • 运行数据观测:数据上报后,开发者可实时监测本地开发智能体的运行状态。

如下图所示,在“观测 > 智能体运行分析 > 智能体运行时”页面中,查看所有已接入的本地开发应用的上报数据。

图2 高代码智能体

OpenTelemetry数据上报

针对非AgentArts平台开发的智能体应用(如使用LangChain等框架开发的智能体),AgentArts提供基于OpenTelemetry标准协议的API上报能力。

开发者只需要在平台创建一个智能体实体接入凭证,然后在代码中集成OpenTelemetry协议,即可将运行数据上报至AgentArts观测平台,实现智能体数据监控。如何上报数据请参考上报第三方智能体Trace、Metric数据

相关文档