30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# 单 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/`，不代表当前运行时。
|