能力简介
什么是可观测
可观测中心（Agent-Trace）是企业端管理后台内置的一站式 Agent 可观测平台，对企业的智能体使用情况做全链路数据采集、存储与分析——从宏观的实时监控大盘，到 Session / Trace 级的中观查询，再到单次对话逐节点的微观轨迹定位，让企业级 Agent 全链路“看得到、看得清”。
产品按三个层级组织数据：
层级 | 对应功能 | 说明 |
① 宏观聚合 | 实时监控 | 按应用 / 任务场景 / 组织范围 / 时间筛选，查看流量、成本、性能、质量四大维度的大盘趋势与分布 |
② 中观查询 | 会话追踪 | Session（任务会话）与 Trace（单轮对话）双粒度查询，多维筛选定位目标会话，支持明细导出 |
③ 微观定位 | Trace 轨迹详情 | 单次对话的完整链路轨迹：时间线、Span 环节树、每个节点的输入 / 输出详情 |
解决哪些问题
效率与体验分析：业务跑得怎么样？通过会话量、活跃用户（DAU）、耗时 P50/P90/P99 等指标，掌握企业内 Agent 的使用规模与响应体验。
成本管理：钱花得值不值？积分 / Token 消耗可拆到部门、模型、单次对话，支撑模型选型与成本归因，发现异常消耗。
质量与安全审计：哪里出错了？异常率趋势、模型 / 工具异常分布，配合 Trace 级行为留痕，支持合规追溯与越权风险排查。
Agent 持续优化：效果不好怎么改？从大盘发现 badcase > 下钻 Session / Trace 定位根因 > 指导 Prompt 迭代、Tool 选择与模型版本对比，形成优化闭环。
面向哪些企业内用户：
运营：看宏观流量与质量，判断业务跑得好不好、钱花得值不值；
运维 / SRE：发现耗时与异常后，从宏观下钻到微观，定位慢 Trace、错 Trace 的根因；
安全：告警命中后做合规追溯，查 Session 来源、溯 Trace 上下文；
业务产研：验证效果、定位 badcase，驱动 Agent 效果迭代。
使用说明
开始体验
说明：
可观测中心当前处于白名单内测阶段，需申请内测。内测期间免费，公测后将根据数据留存时长收费。
步骤 3：开始体验，建议路径为先看“实时监控”关注整体趋势与异常 > 再到“会话追踪”按条件筛选定位目标会话 > 最后进入“Trace 详情”逐节点定位问题。
实时监控
实时监控是可观测中心的宏观大盘，从“用户流量、成本消耗、性能耗时、质量状态”四个维度展示企业 Agent 的整体运行情况，帮助您第一时间发现趋势变化与异常。
全局筛选：支持组合筛选以下条件，整页数据图表将联动刷新：
应用名称：筛选不同应用查看用量（workbuddy、codebuddy IDE、codebuddy CLI、codebuddy 插件）；
组织范围：按企业部门组织树筛选，下钻查看不同部门的数据情况；
时间：支持自定义时间范围筛选；
任务场景（待上线）：筛选不同任务场景（任务 / 助理 / 企业智能体 / 自动化任务等）。
1. 用户流量
查看会话量趋势（Session）、各部门会话量趋势、对话量趋势（Trace）、各部门对话量趋势、活跃对话用户趋势（DAU）以及工具调用次数分布，掌握企业内使用规模与活跃情况。
2. 成本消耗
查看积分消耗趋势、各部门积分消耗趋势、模型消耗分布（Top10 模型），把成本拆到部门与模型粒度，定位成本消耗的分布。
3. 性能耗时
查看对话耗时趋势（端到端对话、首 Token）与分模型首 Token 耗时趋势，捕捉耗时异常的对话与性能异常的模型。
4. 质量状态
查看对话异常率趋势、模型 / 工具调用异常趋势、模型调用异常分布（Top10 模型）、工具调用异常分布（Top10 工具），及时发现质量问题。
小技巧：在大盘上发现异常（如某时段耗时飙升、异常率升高）后，可记下时间与场景，到“会话追踪”中按相同条件筛选，进一步下钻定位。
会话追踪
会话追踪提供 Trace（单轮对话）与 Session（任务会话）双粒度查询，是从大盘下钻到具体会话的中观入口。
Trace 粒度：查单轮对话
Trace 粒度按
traceId 逐条列出单轮对话链路，适合筛选失败或慢对话。支持以下筛选条件：应用名称 / 任务场景：按接入应用与任务类型筛选；
用户 ID：按用户 ID 或昵称定位某个员工的使用记录；
会话 ID（conversationId）/ 对话 ID（traceId）：精确定位单条记录；
对话状态：筛选成功 / 异常的对话；
用户问题检索：按提问关键词检索；
对话耗时 / 对话时间：按耗时区间与时间段筛选。
列表展示每条的输入 / 输出摘要、开始时间、耗时、状态、会话 ID、对话 ID、用户 ID 与任务场景，顶部同步展示当前筛选结果下的对话数、成功率、首 Token 耗时、单次对话耗时、积分消耗与 Tokens 汇总。
Session 粒度：查完整任务
Session 粒度按
conversationId 聚合一次完整任务会话，展示会话名称、开始 / 最新时间、会话 ID、用户 ID 与任务场景，适合从任务维度看整体表现。
导出明细
列表右上角支持“选择”多条记录与“导出明细”，可将筛选后的对话 / 会话明细导出，用于线下分析或对账。
Trace 轨迹详情
Trace 详情页展示单次对话的完整执行轨迹，是定位“为什么慢、为什么错、为什么贵”的微观视图。
任务 Trace 列表：从 Session 粒度进入时，左侧列出该会话（conversationId）下的逐轮 Trace，可逐轮切换查看，每轮展示耗时与 Token 消耗；
摘要信息：当前 Trace 的积分、Tokens、耗时、节点数汇总，支持按“全部 / LLM / Tool”过滤视图范围；右上角“AI 分析助手”可辅助解读当前 Trace；
时间线甘特图：各节点在时间轴上的耗时分布与占比，直观看到时间花在哪；
Trace 全链路：按 AGENT / USER / SYSTEM / LLM / TOOL 等节点类型逐层展开执行链路，每行展示耗时与 Token；异常节点会红色标出；
单节点详情：选中任意节点后，查看该节点的 Input + Output 出入参详情与更多属性（spanId、输入输出、状态等）。
