---
title: 证据（Evidence）
order: 1
description: agent 用来佐证每一条结论的指标、查询、日志和文件。
---

# 证据（Evidence）

**证据（Evidence）** 是一次调研真正运行所依赖的原始材料。它出现在 workspace 右侧的 Studio
面板里，所有报告或建议最终都会指回这里。

Studio 中证据分两类：

- **Workspace Evidence**（工作空间证据）—— 绑定 source（告警、集群、工单）时系统自动收集
  的快照，覆盖事件窗口内集群的状态：指标、慢查询、日志、负载、资源控制、TiKV 线程 CPU 等。
- **Diagnosis run**（诊断运行）—— agent 在调研过程中写出的证据。每次运行会产生
  **key evidence**（agent 判定真正关键的那些）和 **supporting evidence**（其余的佐证）。

## 里面有什么

点击 Studio 中任意一张证据卡片可以下钻到背后的文件。常见内容：

| 文件 | 内容 |
| --- | --- |
| **Workspace Report** | 自动采集快照的顶层总结。 |
| **Metrics** | 触发的指标的 peak / mean / utilization。 |
| **Queries** | 慢查询与高 CPU 占用的 SQL digest，含执行次数。 |
| **Log Stats** | 按组件聚合的错误 / 警告数。 |
| **Workload** | 时间窗内的 QPS、延迟、连接画像。 |
| **Resource Control** | 资源组配额与压力。 |
| **TiKV Thread CPU** | TiKV 是嫌疑点时的逐线程 CPU 拆解。 |
| **Agent Summary** | agent 当作工作记忆使用的精简版 JSON / 文本。 |
| **Links** | 跳转到对应时间段的 Clinic / Grafana / TopSQL 链接。 |

不是每个 workspace 都有全部文件 —— Studio 只展示 source 实际产生的内容。

## agent 如何使用证据

你提问之后，agent 会：

1. 把硬盘上已有的 workspace 证据拉进上下文。
2. 决定该调用哪些技能和 MCP 工具，补齐还缺的上下文。
3. 把它认为关键的部分提升为 **key evidence** 展示在 Studio，其它的归入 **supporting evidence**。
4. 写一份报告，按名字引用证据，让你能跟着推理走。

正因如此，证据和 chat 不是两个分开的功能 —— 它们是同一次调研的两个视图。Chat 展示对话，
Studio 展示对话产出的证物。

## 怎么相信证据

几个有用的习惯：

- **打开证据背后的文件。** Studio 里每一个指标 / 查询 / 日志行都有底层 JSON 文件。看到
  反常的数字时，打开文件，确认时间区间、实例、单位。
- **不同意就说出来。** 报告里的 "key evidence" 和你在集群里看到的不符？在 chat 里直接讲，
  agent 持有整个 workspace 的上下文，会重新审视。
- **分享时用证据链接。** [共享 workspace](/docs/features/sharing) 会把完整的证据树一并带过去 ——
  不用截图，对方能下钻到你看到的同一份文件。

## 证据存在哪

证据文件存在后端 workspace 的 `evidences/` 目录下，通过 `/api/workspace/{id}/files`
接口暴露给前端。遵循 evidence-writer 约定的技能会把文件丢到这里，Studio 面板自动识别。