概述
可观测性(Observability)通过对智能体执行过程的全链路记录,帮助你理解智能体的内部行为、定位问题、分析性能并持续优化。VeADK 内置的 Tracing 能力会把每一次请求——从接收用户输入,到模型推理、工具调用、记忆与知识库读写,再到生成响应——记录为结构化数据,并上报至火山引擎或第三方平台进行观测与分析。
核心能力
VeADK 的可观测能力遵循 OpenTelemetry 生成式 AI 语义规范,主要提供:
- 可视化链路:每次请求从接入到响应的完整流程都可被追踪;
- 结构化数据:记录上下文、状态、事件类型、耗时等信息;
- 跨组件追踪:覆盖 Agent、工具、记忆模块、知识库以及外部接口;
- 多 Agent 协调:在多 Agent 协作场景中分析各 Agent 的调用关系与数据流向;
- 内容采集控制:可通过
observability.opentelemetry.trace_content关闭 Agent、LLM 与工具输入输出内容采集,仅保留非内容 Trace 信息。
支持的平台
VeADK 通过不同的数据导出器(Exporter),将 Tracing 数据上报至多个火山引擎及第三方平台:
CozeLoop(扣子罗盘)
将 Trace 数据上报至扣子罗盘,实现调用链路观测与 Agent 评测。
APMPlus
接入火山引擎 APMPlus 平台,实现调用链路观测与模型指标分析。
TLS(日志服务)
接入火山引擎日志服务 TLS,进行 Agent 执行链路观测。
与 OpenTelemetry 的兼容性
VeADK 的字段命名遵循 OpenTelemetry 生成式 AI 规范,你可以直接将 Tracing 数据导入到 OpenTelemetry 兼容的系统中进行分析和可视化。