功能介绍
AgentArts观测功能支持统计三类数据来源：
| 数据来源 | 上报方式 | 说明 |
|---|---|---|
| 在AgentArts平台内创建的智能体 | 平台自动上报 | 智能体通过API调用后，系统自动采集并上报观测数据。 |
| 本地代码开发并托管至AgentArts平台运行的智能体 | 托管至AgentArts平台后上报 | 部署至AgentArts运行时后上报。通过API或AgentArts SDK调用后，自动采集并上报观测数据。如需查看上报的运行数据，请参考查看高代码应用运行数据。 |
| 非AgentArts平台开发的第三方智能体 | 对接观测OpenAPI上报 | 通过对接观测OpenAPI进行数据上报。 |
本章节介绍第三类：第三方智能体的观测数据上报。
如果您的智能体不是在AgentArts平台上开发或部署在AgentArts平台，可以通过观测OpenAPI，将智能体的Trace（调用链）和Metric（指标）数据上报至平台。该OpenAPI接收的数据格式遵循OpenTelemetry（OTel）协议（一种开源的可观测性标准协议），开发者可以使用OTel SDK进行对接，实现数据上报。
典型场景：您已使用LangChain等框架开发了智能体应用，希望借助AgentArts的观测能力监控其调用链路、分析Token消耗和排查异常，此时可通过OpenTelemetry协议将运行数据上报至AgentArts。
上报的数据类型
| 数据类型 | 说明 |
|---|---|
| Trace（调用链） | 记录一次完整请求的调用路径，包括各节点的调用顺序、耗时、输入输出等详情。 |
| Metric（指标） | 记录聚合统计信息，如请求次数、Token消耗量、成功率等。 |
数据上报流程
通过观测OpenAPI上报数据时，开发者需要在智能体代码中埋点采集观测数据（例如创建Span、设置Attribute等），并通过OpenAPI将数据发送至AgentArts。这种方式需要开发者对OpenTelemetry的基本概念和使用方式（如Span、Attribute、Metric）有一定了解，并需要修改业务代码添加上报逻辑。
数据上报流程如下：
① 在AgentArts平台创建智能体，获取接入地址、鉴权信息、智能体ID等信息
│
▼
② 在外部智能体代码中配置接入参数，埋点采集观测数据
│
▼
③ 在AgentArts观测页面查看数据（调用链分析、智能体概览、会话分析等） 上报的数据可以在AgentArts平台的观测中查看，您可以在观测页面的各页签中查看和分析。
