Agent可观测
更新时间:2026-02-06
概述
Agent 可观测服务,实时追踪 Agent 的耗时、错误率、限流、Token用量等核心指标, 兼容 LangChain、LangGraph、CrewAl 等主流框架,可视化展示 Agent 端到端调用链路的详细信息, 为生产级 Agent 的持续优化与高效运维提供精准的数据支撑。
Agent可观测完全对接开源Langfuse监控系统,针对Agent场景提供的全托管、高可用、可扩展的可观测监控服务。
- 说明:关于开源Langfuse的更多信息可见 Langfuse 官方文档。
核心概念
| 名词 | 解释说明 |
|---|---|
| Agent | 智能体,基于LLM的应用程序,能够理解用户意图并执行任务。 |
| Session | 用户与Agent的一次完整会话。 |
| Traces | 一个Trac通常代表一个单独的请求或操作。例如,当用户向聊天机器人提问时,从用户提出问题到机器人给出回应的这一交互过程会被记录为一个追踪 。 |
| Observations | 是分布式跟踪中的基本工作单元,代表系统中执行的一个操作,例如:一次数据库查询、一个函数执行、一次远程服务调用等。每个 Observations 拥有唯一标识,附带操作名称、开始时间、结束时间、标签、日志等关键属性。 |
注意事项
- Agent可观测当前处于公测阶段,功能限时免费。
- Agent可观测在开启的时候会自动部署托管版的Langfuse服务,默认是公网访问。
- Agent可观测目前支持的地域 华北-北京、华南-广州、华东-苏州三个地域。
支持Agent数据观测的资源
- Agent智能体
- 智能体运行时(Agent Runtime)
- 沙箱(Sandbox)
- 网关(Gateways)
- 身份认证(Identity)
说明:
- 若基于Agent托管部署的Agent,Agent可观测为Agent托管提供一套埋点监控方案,在Agent托管SDK内部接入OpenTelemetry埋点,以更好观测Agent智能体运行时调用过程。整体涵盖分布式追踪(Tracing)和指标监控(Metrics)两大核心模块。
操作步骤
开通Langfuse服务
- 登录百度智能云平台函数计算(CFC)控制台。
- 在左侧导航栏选择Agent可观测,单击立即开通,弹出选择服务弹窗,配置登录Langfuse服务的密码,点击确认,完成配置。
- 开通完成之后,会展示Langfuse服务的基本信息:登录账号、密码、公网访问域名。

说明:
- 开通Langfuse服务后,系统会自动部署Langfuse服务,默认开启公网访问。
- Langfuse服务创建后,您可以在百度云控制台对Langfuse进行网络接入设置。 接入网络后,Langfuse服务将作为服务发布点挂载到服务网卡,打开Traces数据上报通道。Langfuse与私有网络中Agent进行关联,即可实现Agent中Traces数据的采集与上报,最多支持接入10个私有网络。
- 开通Langfuse服务之后,登录Langfuse的账号默认生成,暂不支持修改。
登录Langfuse服务
- 在Agent可观测页面,复制账号信息并且点击Langfuse公网访问域名,进入Langfuse服务的登录页面;
- 将账号信息输入登录框中,并且输入开通Langfuse服务配置的登录密码,若忘记密码支持可在服务开通完成之后修改密码;
- 点击登录,进入Langfuse服务页面。

AgentRuntime配置Langfuse
- 进入langfuse,创建project,或者使用默认的project

- 进入project设置页面,创建trace推送的apiKey,创建完后请即时复制保存


- 为对应的AgentRuntime配置langfuse的apiKey和端点,进入AgentRuntime页面,在创建或编辑agent时填写如下环境变量,环境变量名与langfuse保持一致,涉及pk、sk、访问端点(API Keys页面的端点即公网访问域名),注意变量值不用加双引号


- agent执行调用后即可在langfuse页面查看trace

- 查看agent整体调用情况


