# 数据上报概述
智能体应用不同于传统的确定性程序，其运行过程具有高度的动态性和复杂性。在单次任务执行中，往往涉及大模型推理、外部工具调用等多个环节的链式组合。
在开发与运维过程中，开发者常面临以下挑战：
- **"黑盒"运行**：难以直观判断智能体为何做出某种决策，或在哪一步骤发生了阻塞。
- **故障定界难**：当智能体输出结果异常时，难以快速定位是模型幻觉、工具调用失败还是上下文溢出所致。
- **性能瓶颈模糊**：无法量化各环节（如模型响应耗时、工具执行时长）的性能分布，难以进行针对性优化。
AgentArts观测能够将智能体的运行过程"透明化"。AgentArts观测提供智能体运行数据采集与分析能力，支持平台原生应用自动上报、高代码应用集成上报和第三方智能体通过OpenTelemetry上报三种模式，帮助开发者实现智能体运行的全程可观测性。
请根据您的应用开发方式选择对应的数据上报接入：如果是在AgentArts平台创建的智能体，平台会自动上报；如果是本地代码开发，选择高代码集成上报；如果是非AgentArts平台开发的第三方智能体，选择通过OpenTelemetry上报。
表1上报方式 
| 应用开发方式                      | 上报方式              | 接入方式                                                                                                                                                      |
|:---|:---|:---|
| 在AgentArts平台内创建的智能体         | 平台原生自动上报          | 在智能体"提交版本"页面配置数据上报开关，随后通过API方式调用智能体，系统将自动采集并上报观测数据。                                                                                                       |
| 本地代码开发并托管至AgentArts平台运行的智能体 | 托管至AgentArts平台后上报 | 部署至AgentArts运行时后上报。通过API或AgentArts SDK调用后，自动采集并上报观测数据。如需查看上报的运行数据，请参考[查看高代码应用运行数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0014.html)。 |
| 非AgentArts平台开发的第三方智能体       | 通过OpenTelemetry上报 | 在平台创建智能体获取接入凭证，通过OpenTelemetry埋点上报数据至AgentArts。                                                                                                           |
   
在观测界面展示数据不收取任何费用，但智能体数据上报产生的日志、指标及调用链数据将分别上报至LTS、AOM和APM服务，会产生相应的费用，请在开启前评估成本。具体计费场景如下：
LTS、AOM和APM服务采用按需计费，并提供一定量的免费额度，超出免费额度部分按实际使用量计费。详细计费规则可参考对应服务的计费说明。
- **日志记录** ：开启后，日志数据会上报到云日志服务LTS，费用明细请参考[LTS计费说明](https://support.huaweicloud.com/price-lts/lts_001_04.html)。
- **调用链** ：开启后，调用链数据会上报到应用性能管理APM，费用明细请参考[APM计费说明](https://support.huaweicloud.com/price-apm2/apm_07_0019.html)。
- **指标** ：开启后，指标数据会上报到应用运维管理AOM，费用明细请参考[AOM计费说明](https://support.huaweicloud.com/price-aom2/aom_07_0004.html)。
#### AgentArts智能体数据上报
针对在AgentArts平台上创建的单智能体、工作流及多智能体应用，系统默认开启自动上报，提交发布智能体版本时，用户可以保持开启或手动关闭。
- **全流程自动采集** ：智能体发布后，系统将自动上报通过API调用产生的数据。
  ![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/note_3.0-zh-cn.png)
  当前暂不支持上报控制台上**预览调试**产生的数据。
  
- **应用调优**：开发者可以使用Trace数据实时查看各环节（如模型推理、工具调用）的执行情况。通过可视化的调用链路，快速定位逻辑中断或性能瓶颈，实现智能体的优化。
如下图所示，在"观测 \> 调用链分析"页面中，可以清晰地查看并筛选出用户请求上报的数据及执行细节。
图1AgentArts智能体   
![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717675739.png)
#### 高代码智能体数据上报
针对开发者本地开发的智能体应用，AgentArts提供灵活的集成接入能力，打破环境壁垒，实现统一观测。
- **灵活接入** ：支持将本地开发的智能体应用接入AgentArts平台。采用SDK集成直接托管的方式，并配置数据上报开关，即可实现运行数据的自动上报。如何上报数据请参考[上报高代码智能体数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0006.html)。
- **运行数据观测**：数据上报后，开发者可实时监测本地开发智能体的运行状态。
如下图所示，在"观测 \> 智能体运行分析 \> 智能体运行时"页面中，查看所有已接入的本地开发应用的上报数据。
图2高代码智能体   
![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002688075986.png)
#### OpenTelemetry数据上报
针对非AgentArts平台开发的智能体应用（如使用LangChain等框架开发的智能体），AgentArts提供基于OpenTelemetry标准协议的API上报能力。
开发者只需要在平台创建一个智能体实体接入凭证，然后在代码中集成OpenTelemetry协议，即可将运行数据上报至AgentArts观测平台，实现智能体数据监控。如何上报数据请参考[上报第三方智能体Trace、Metric、Log数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0008.html)。