# 单 Diagnosis Agent Demo

**更新日期**：2026-07-22

## 运行前提

- 应用、MySQL、Redis、Milvus 与模型配置可用。
- `cls.mock-enabled=true` 用于 query_logs Mock 证据。
- query_mysql 只使用 `mysql-tool.datasources` 配置的隔离只读数据源；不查询应用数据库。

## 主流程

1. 启动应用：`mvn spring-boot:run`。
2. 向 `POST /api/chat` 提交 `requests/payment-timeout-chat.json`。
3. 验证 SSE：`metadata -> status* -> content|failure -> done`。
4. 保存 metadata 的 exact `session_id` 与 `run_id`。
5. 检查 `logs/application.log` 的 Run/Tool/Guard/Release 状态，确认无 Prompt、Thought 或 raw Tool payload。
6. 使用 `scripts/query_mysql.py` 按 exact runId 查询 `diagnosis_run`、`agent_step`、`tool_invocation`。
7. 打开 `/trace.html?sessionId=...&runId=...` 检查聚合 Trace。

## 验收重点

- 只有 `diagnosis_agent` 具有 Tool loop。
- Tool 只包含 `lookup_knowledge`、`query_logs`、`query_mysql`。
- EvidenceGuard/SemanticGuard 完成前没有 content。
- SUCCESS 发布 typed diagnosis report；证据或语义不支持时发布固定 safe fallback。
- query_logs 为 Mock；不把它表述为真实 CLS live 结果。

旧多角色与第二诊断入口的 demo 已保存在 `archive/2026-07-22-legacy/`，不代表当前运行时。