117 lines
4.3 KiB
Markdown
117 lines
4.3 KiB
Markdown
# SuperBizAgent MVP 文档
|
||
|
||
**更新日期**：2026-07-05
|
||
|
||
本目录保存 MVP 阶段的架构、问题、演示、评测和数据表说明。当前架构入口已经整理到 `mvp/architecture/`，旧版架构材料已归档，避免继续把历史方案当成当前实现。
|
||
|
||
## 当前入口
|
||
|
||
| 目录/文档 | 用途 |
|
||
|---|---|
|
||
| [architecture/README.md](architecture/README.md) | 当前 MVP 架构入口 |
|
||
| [architecture/current-mvp-architecture.md](architecture/current-mvp-architecture.md) | 当前可运行系统架构 |
|
||
| [architecture/interview-one-pager.md](architecture/interview-one-pager.md) | 面试一页式架构讲解 |
|
||
| [architecture/agent-orchestration.md](architecture/agent-orchestration.md) | Agent 编排架构 |
|
||
| [architecture/harness-quality-gates.md](architecture/harness-quality-gates.md) | Harness 与质量门禁 |
|
||
| [architecture/rag-architecture.md](architecture/rag-architecture.md) | RAG/知识检索新架构 |
|
||
| [architecture/retrieval-observability.md](architecture/retrieval-observability.md) | 检索与可观测性架构 |
|
||
| [architecture/feedback-architecture.md](architecture/feedback-architecture.md) | 反馈与自评估架构 |
|
||
| [architecture/session-trace-lifecycle.md](architecture/session-trace-lifecycle.md) | 会话与 Trace 生命周期 |
|
||
| [architecture/knowledge-base-authoring.md](architecture/knowledge-base-authoring.md) | 知识库文档编写与维护 |
|
||
| [architecture/data-model.md](architecture/data-model.md) | 数据模型总览 |
|
||
| [architecture/evolution-roadmap.md](architecture/evolution-roadmap.md) | Agent 架构演进路线 |
|
||
| [issues/rag-refactor-plan.md](issues/rag-refactor-plan.md) | RAG 重构计划和阶段拆解 |
|
||
| [demo/README.md](demo/README.md) | Demo 运行和面试演示材料 |
|
||
| [demo/ten-minute-interview-demo.md](demo/ten-minute-interview-demo.md) | 10 分钟面试演示脚本 |
|
||
| [eval/README.md](eval/README.md) | 诊断评测材料 |
|
||
| [issues/README.md](issues/README.md) | MVP issue 索引 |
|
||
|
||
## 当前系统一句话
|
||
|
||
SuperBizAgent MVP 是一个可追踪的故障诊断 Agent：Chat 和 AIOps 入口进入 Agent 编排，Executor 显式调用知识库、日志、指标等工具收集证据，诊断过程落到 `diagnosis_session`、`agent_step`、`tool_invocation`，最终通过 Trace API、Verifier 和评测脚本证明结果可解释、可回放、可对比。
|
||
|
||
## 文档结构
|
||
|
||
```text
|
||
mvp/
|
||
architecture/
|
||
README.md
|
||
current-mvp-architecture.md
|
||
interview-one-pager.md
|
||
agent-orchestration.md
|
||
harness-quality-gates.md
|
||
rag-architecture.md
|
||
retrieval-observability.md
|
||
feedback-architecture.md
|
||
session-trace-lifecycle.md
|
||
knowledge-base-authoring.md
|
||
data-model.md
|
||
evolution-roadmap.md
|
||
archive/2026-07-05-legacy/
|
||
issues/
|
||
README.md
|
||
rag-refactor-plan.md
|
||
ISS-*.md
|
||
rag-*.md
|
||
demo/
|
||
README.md
|
||
ten-minute-interview-demo.md
|
||
requests/
|
||
scripts/
|
||
output/
|
||
eval/
|
||
README.md
|
||
schema.md
|
||
cases/
|
||
fixtures/
|
||
reports/
|
||
notes/
|
||
plan/
|
||
tables/
|
||
```
|
||
|
||
## 当前核心设计
|
||
|
||
- `lookup_knowledge` 保持显式 Agent Tool，不隐藏到 Chat Advisor。
|
||
- L0 降级为 domain/entity hint，不再默认承担最终召回决策。
|
||
- `VectorSearchService` 是检索稳定门面。
|
||
- Spring AI VectorStore 是当前读取主路径，Milvus SDK 保留为 fallback。
|
||
- AIOps payload 会生成推荐知识库 query，保留业务语义。
|
||
- Trace API 聚合 session、step、tool invocation 和 self evaluation。
|
||
- RAG 行为通过 offline baseline 和 live acceptance 脚本做回归验证。
|
||
|
||
## 关键运行链路
|
||
|
||
```text
|
||
Chat
|
||
-> ChatService
|
||
-> Planner / Executor / Verifier
|
||
-> evidence tools
|
||
-> diagnosis_session / agent_step / tool_invocation
|
||
-> DiagnosisTraceService
|
||
|
||
AIOps
|
||
-> AiOpsService
|
||
-> PAYLOAD_TARGETED or AUTO_DISCOVERY
|
||
-> Planner / Executor
|
||
-> Prometheus / logs / lookup_knowledge
|
||
-> AiOpsRuleEvaluationService
|
||
-> DiagnosisTraceService
|
||
|
||
RAG
|
||
-> lookup_knowledge
|
||
-> L0 domain/entity hint
|
||
-> VectorSearchService
|
||
-> Spring AI VectorStore / Milvus SDK fallback
|
||
-> relevance normalization
|
||
-> tool_invocation
|
||
```
|
||
|
||
## 旧文档说明
|
||
|
||
旧版架构文档已移动到：
|
||
|
||
- [architecture/archive/2026-07-05-legacy/](architecture/archive/2026-07-05-legacy/)
|
||
|
||
归档文档只用于追溯设计历史。当前实现和后续规划以 `architecture/current-mvp-architecture.md` 与 `architecture/rag-architecture.md` 为准。
|