全栈可观测平台
全栈可观测平台
文档指南
请输入
- 文档首页
全栈可观测平台实践与教程AI 应用监控实践VeADK 智能体链路监控
复制全文
下载 pdfVeADK 智能体链路监控
文档反馈
问问助手VeADK 提供用于记录 Agent 执行过程中的关键路径和中间状态的可观测能力，且支持将 Trace 数据通过 Exporter 上报至应用性能监控，有助于开发者进行调试、性能分析、行为追踪等任务。本文为您介绍如何通过应用性能监控观测 VeADK 上报的链路监控信息。
背景信息
VeADK（Volcengine Agent Development Kit），是由火山引擎推出的面向智能体（Agent）的全流程架构，旨在为开发者提供一套面向智能体构建、云端部署、评测与优化的全流程开发框架。相较于现有智能体开发框架，VeADK 具备与火山引擎产品体系深度融合的优势，能够帮助开发者更高效地构建企业级 AI 智能体应用。更多详细介绍参见：VeADK 官方介绍。
前提条件
- 已经安装 VeADK，详细说明参见：VeADK 安装说明。
- 已经获取 AK、SK 信息，火山引擎账号 AK/SK 获取方法参见：如何获取 API 访问密钥。
操作步骤
步骤一：配置环境变量
根据实际情况，将火山引擎 AK、SK 信息配置到应用的环境变量中，用于设置能够调用大模型的 API Key 或其他身份验证信息。
步骤二：观测数据上报
import json
from veadk import Agent, Runner
from veadk.memory.short_term_memory import ShortTermMemory
from veadk.tools.demo_tools import get_city_weather
from veadk.tracing.telemetry.exporters.apmplus_exporter import APMPlusExporter
from veadk.tracing.telemetry.exporters.cozeloop_exporter import CozeloopExporter
from veadk.tracing.telemetry.exporters.tls_exporter import TLSExporter
from veadk.tracing.telemetry.opentelemetry_tracer import OpentelemetryTracer
session_id = "your_session_id"
# Initialize tracing exporters
exporters = [APMPlusExporter()]
tracer = OpentelemetryTracer(exporters=exporters)
# Create agent with tool and tracer
agent = Agent(
name="chat_robot",
description="A robot talk with user.",
instruction="Talk with user friendly.",
tools=[get_city_weather],
tracers=[tracer],
)
# Create runner and execute
runner = Runner(
agent=agent,
short_term_memory=ShortTermMemory(),
)
await runner.run(messages="How is the weather like in Xi'an?", session_id=session_id)
print(f"Tracing file path: {tracer._trace_file_path}")
步骤三：Agent 链路监控
VeADK 观测数据上报成功后，即可通过应用性能监控查看 Agent 链路监控相关信息。
- 登录 应用性能监控，并在顶部导航栏选择项目和地域。
- 在左侧导航栏选择 服务监控 > 服务列表，前往服务列表页面。
- 根据服务名称筛选目标 Agent 关联的服务，单击服务名称，跳转到服务详情页，在 服务总览 页签查看 Agent 相关指标的监控信息，例如：大模型调用 QPS、大模型调用次数、Token 使用量。
- 在 Trace 分析 页签，单击目标 Trace ID，前往单链路详情页面。在列表视图中查看 Agent 埋点信息。
最近更新时间：2026.01.27 20:58:19
这个页面对您有帮助吗？
有用
有用
无用
无用