# 上报AgentArts中的智能体数据
AgentArts智能体平台提供了完善的可观测性能力，支持将智能体运行过程中的数据自动上报至运营运维平台。通过分析这些数据，开发者可以实时监测智能体运行状态、排查故障以及优化模型性能。
**数据上报机制**
平台采用默认开启的上报策略，具体流程如下：
![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717675769.png)
1. **默认行为** ：智能体创建后，系统默认开启数据上报开关，用户可选择开启或手动关闭。用户通过API调用智能体运行产生的日志、调用链及指标数据将自动上报。
   ![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/caution_3.0-zh-cn.png)
   - 仅通过API调用产生的数据才会上报到运营运维页面。使用API调用智能体，请参考[API调用实践](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0020.html)。
   
   - 在开通AOM、APM和LTS时，系统将自动创建一个名为AgentArts的默认资源，包括AOM实例、APM应用、LTS日志组和日志流、IAM委托（agent-arts-default-agencynew）及相应的授权记录。请勿随意更改这些默认资源，否则可能导致观测功能无法正常使用。请提前在AgentArts平台"授权管理"中完成服务授权。 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002688076012.png)
     
     
2. **数据流向** ：
   - 数据首先上报至LTS（云日志服务）、AOM（应用运维管理）和APM（应用性能管理）服务。
   
   - 读取上报至LTS、AOM和APM的数据，展示在"运营运维 \> 观测"中，支持开发者查看与分析智能体上报的数据。
    
3. **关闭方式：**如需停止数据上报，请在智能体"提交版本"页面手动关闭相应的数据上报开关。关闭数据上报开关后，智能体将不再上报新的数据，但已上报的数据仍可查看。
本文档以单智能体开启数据上报为例进行说明。工作流与多智能体应用的数据上报配置方式与单智能体一致，可参照执行。
#### 费用说明
在观测界面展示数据不收取任何费用，但智能体数据上报产生的日志、指标及调用链数据将分别上报至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服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。
- 已创建并发布智能体。
  - 创建智能体请参考[创建单智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0016.html)、[创建多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0106.html)和[搭建工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0045.html)。
  
  - 发布智能体请参考[发布应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0030.html)、[发布多智能体应用为API](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0108.html)和[发布工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.html)。
   
- 已开通和授权APM和AOM，授权操作请参考[管理云服务授权信息](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0218.html)。
 
 #### 开启数据上报
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 在左侧导航，选择"开发中心 \> 智能体管理"。
3. 选择"单智能体"页签，单击需要上报数据的单智能体应用卡片。
4. 在"单智能体配置"页面，单击"提交版本"并输入版本信息，然后单击"确定"。 
   ![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/note_3.0-zh-cn.png)
   如果应用已发布，修改后再次发布时，按钮将显示为"更新版本"。
   
   
5. 在"部署智能体"页面，开启"日志记录"、"调用链"和"指标"开关。开启开关后，智能体的交互数据将自动上报。 
   除了上述方式外，进入"部署运行 \> 智能体运行时"，并单击"名称/ID"，在"编辑"页面也可以开启日志上报开关。
   图1智能体发布开启数据上报开关   
   ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717835629.png)
   图2智能体运行时开启日志上报   
   ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002688076016.png)
   
   
6. 开关开启后，可以通过API调用触发一次智能体交互。在"运营运维 \> 观测 \> 调用链分析"页面，如果能查到最新的交互记录，说明数据上报已生效。通过API调用智能体请参考[API调用实践](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0020.html)。
 
#### 开关功能说明
各开关开启后，对应观测界面的展示信息如下表所示：
表1开关功能说明 
| 开关名称 | 开启后展示的观测界面及内容                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|
| 日志记录 | 在调用链详情的"日志"页签中查看智能体运行过程中的详细日志信息。 图3日志 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717675767.png)                                                                                                                                                                                                                                                                                                |
| 调用链  | 1. **调用链分析**：查看请求的完整调用路径及耗时分析。  2. **会话分析** ：查看智能体与用户对话的历史数据。 图4调用链分析、会话分析 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002717675765.png)                                                                                                                  |
| 指标   | 1. **智能体概览**：查看"业务指标"和"运维指标"页签中展示的统计信息。  2. **调用链分析** ：在调用链详情页面的"指标"页签中查看相关信息。 图5智能体概览 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002688076014.png) 图6调用链分析 ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002688076010.png)    |
   
#### 查看Trace数据
数据上报成功后，您可进入"运营运维 \> 观测"界面，通过以下页面分析智能体的运行数据：
- **智能体概览：**展示智能体的Tokens消耗、模型调用次数和模型调用平均耗时等指标，助您快速掌握整体运行情况。
- **调用链分析：**查看请求的完整调用链路，定位性能瓶颈或故障节点。
- **会话分析：**智能体与用户对话的历史数据，为优化对话逻辑和服务质量提供依据。