127 lines
5.0 KiB
Markdown
127 lines
5.0 KiB
Markdown
# SuperBizAgent MVP 文档
|
||
|
||
**更新日期**：2026-07-10
|
||
|
||
本目录保存 MVP 阶段的架构、问题、演示、评测和数据表说明。当前材料按“当前入口”和“历史归档”拆开，避免把早期设计稿当成当前实现。
|
||
|
||
## 当前入口
|
||
|
||
| 目录/文档 | 用途 |
|
||
|---|---|
|
||
| [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/executor-evidence-pipeline-refactor.md](architecture/executor-evidence-pipeline-refactor.md) | Executor 证据链路改造记录 |
|
||
| [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/README.md](issues/README.md) | MVP issue 索引 |
|
||
| [issues/active/rag-refactor-plan.md](issues/active/rag-refactor-plan.md) | RAG 重构计划和阶段拆解 |
|
||
| [tables/README.md](tables/README.md) | 当前 MySQL 表说明 |
|
||
| [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) | 诊断评测材料 |
|
||
|
||
## 当前系统一句话
|
||
|
||
SuperBizAgent MVP 是一个可追踪的故障诊断 Agent：Chat 和 AIOps 入口进入 Agent 编排，Executor 显式调用知识库、日志、指标等工具收集证据；多轮会话元数据落到 `chat_session`，每次诊断运行落到 `diagnosis_run`，步骤和工具明细通过 `agent_step.run_id`、`tool_invocation.run_id` 关联，最终通过 Trace API、Verifier 和评测脚本证明结果可解释、可回放、可对比。
|
||
|
||
## 文档结构
|
||
|
||
```text
|
||
mvp/
|
||
architecture/
|
||
README.md
|
||
current-mvp-architecture.md
|
||
interview-one-pager.md
|
||
agent-orchestration.md
|
||
executor-evidence-pipeline-refactor.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/
|
||
issues/
|
||
README.md
|
||
active/
|
||
archived/
|
||
design-notes/
|
||
rag/
|
||
tables/
|
||
README.md
|
||
*表-*.md
|
||
archive/
|
||
demo/
|
||
README.md
|
||
ten-minute-interview-demo.md
|
||
requests/
|
||
scripts/
|
||
output/
|
||
eval/
|
||
README.md
|
||
schema.md
|
||
cases/
|
||
fixtures/
|
||
reports/
|
||
archive/
|
||
```
|
||
|
||
## 当前核心设计
|
||
|
||
- `lookup_knowledge` 保持显式 Agent Tool，不隐藏到 Chat Advisor。
|
||
- L0 降级为 domain/entity hint，不再默认承担最终召回决策。
|
||
- `VectorSearchService` 是检索稳定门面。
|
||
- Spring AI VectorStore 是当前读取主路径，Milvus SDK 保留为 fallback。
|
||
- AIOps payload 会生成推荐知识库 query，保留业务语义。
|
||
- `sessionId` 表示多轮会话上下文，`runId` 表示一次可回放诊断运行。
|
||
- Trace API 聚合 `diagnosis_run`、`agent_step.run_id`、`tool_invocation.run_id` 和 self evaluation。
|
||
- RAG 行为通过 offline baseline 和 live acceptance 脚本做回归验证。
|
||
|
||
## 关键运行链路
|
||
|
||
```text
|
||
Chat
|
||
-> ChatService
|
||
-> Planner / Executor / Verifier
|
||
-> evidence tools
|
||
-> chat_session / diagnosis_run
|
||
-> agent_step.run_id / tool_invocation.run_id
|
||
-> DiagnosisTraceService
|
||
|
||
AIOps
|
||
-> AiOpsService
|
||
-> PAYLOAD_TARGETED or AUTO_DISCOVERY
|
||
-> Planner / Executor
|
||
-> Prometheus / logs / lookup_knowledge
|
||
-> AiOpsRuleEvaluationService
|
||
-> diagnosis_run(agent_flow=AI_OPS)
|
||
-> 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/)
|
||
- 本次文档清理归档：[archive/2026-07-09-doc-cleanup/](archive/2026-07-09-doc-cleanup/)
|
||
|
||
归档文档只用于追溯设计历史。当前实现和后续规划以 `architecture/`、`issues/README.md`、`tables/README.md` 和 OpenSpec/devflow 的最新记录为准。
|