调用链是什么？Root Span和Model Span有什么区别？如何定位Agent的“幻觉”根因？华为云AgentArts用245页技术手册回答了这些问题——观测功能通过探针自动采集调用路径、耗时和状态，让智能体从“黑箱”走向“透明视图”。这份指南系统梳理了从数据上报到调用链分析的完整路径。
观测概述——为什么智能体需要可观测性
在AI应用的开发与部署过程中，请求调用路径往往复杂交错，难以追踪关键节点，导致问题定位困难、性能瓶颈难以发现。观测功能通过在请求处理的每个关键节点插入探针，自动采集处理时间、调用路径等信息，构建完整的调用链，并通过可视化界面展示。
核心概念——Trace与Span
Trace是一次完整请求的全生命周期记录，呈现从请求发起到最终返回结果的完整过程。Span是Trace中每一个独立的操作步骤，比如一次模型调用或一个函数调用。Trace中的第一个Span被称为Root Span，记录整个请求的开始和结束；而Root Span下的子Span则记录更具体、更细粒度的操作信息。
四类核心数据
链路信息：展示选中Span的输入与输出数据，帮助追踪数据流转过程及排查调用错误。元数据：运行过程中的键值对集合，如应用程序版本、运行环境、调用模型名称。标注：附加在Span上的自定义信息，支持按场景筛选并回流至评测集。日志：详细记录智能体的思考过程、工具调用的原始输入输出信息，是排查问题的关键依据。
三大数据来源与上报机制
平台原生自动上报
针对在AgentArts平台上创建的单智能体、工作流及多智能体应用，系统默认开启自动上报。智能体发布后，系统将自动上报通过API调用产生的数据。在智能体“提交版本”页面可开启或关闭“日志记录”、“调用链”和“指标”开关。
高代码智能体托管上报
针对本地开发的智能体应用，AgentArts提供SDK集成直接托管的方式。部署至AgentArts运行时后，通过API或AgentArts SDK调用后自动采集并上报观测数据。支持在“智能体运行时”、“沙箱工具”和“网关”三个维度查看运行日志。
第三方智能体OpenTelemetry上报
针对非AgentArts平台开发的智能体（如使用LangChain等框架），AgentArts提供基于OpenTelemetry标准协议的API上报能力。数据上报流程为：在平台创建智能体获取接入凭证→在代码中集成OpenTelemetry协议→运行数据上报至AgentArts观测平台。
调用链分析——定位性能瓶颈的核心工具
调用链列表与筛选
调用链列表包含Trace ID、请求状态、输入、输出、响应时间、会话ID、Tokens、开始时间、标注等字段。支持按上报时间、应用类型、应用、数据类型（ALL Span/Root Span/Model Span）、Trace ID、请求状态、输入、输出、会话ID、标注等多维度筛选。
调用链详情四维视图
进入调用链详情后，页面左侧展示调用树，右侧展示四个Tab页签。链路信息展示选中Span的输入输出内容，节点报错时可快速定位根因。元数据以JSON格式展示所选Span的键值对信息。标注展示人工标注的详细信息。指标以折线图展示当前Span的Token消耗趋势与平均响应时间变化（前后15分钟）。日志展示智能体运行的事件记录。
会话分析与智能体运行分析
会话分析
会话分析记录用户与系统的交互过程信息，每条会话记录包含会话ID、耗时、Tokens（Input/Output）、调用链数、用户ID、触发类型、开始时间。支持按应用类型、应用、时间、会话ID、用户ID、触发类型筛选。在会话详情中可单击Trace ID跳转至调用链详情。
智能体运行分析
智能体运行时页面展示高代码智能体的运行状态、更新时间及详细日志。沙箱工具页面展示代码解释器调用过程中的日志信息。网关页面展示网关调用过程中的运行时日志，包含调用时间、状态、请求路径、响应状态码。
