SuperBizAgent MVP 文档
更新日期：2026-07-05
本目录保存 MVP 阶段的架构、问题、演示、评测和数据表说明。当前架构入口已经整理到 mvp/architecture/，旧版架构材料已归档，避免继续把历史方案当成当前实现。
当前入口
| 目录/文档 | 用途 |
|---|---|
| architecture/README.md | 当前 MVP 架构入口 |
| architecture/current-mvp-architecture.md | 当前可运行系统架构 |
| architecture/interview-one-pager.md | 面试一页式架构讲解 |
| architecture/agent-orchestration.md | Agent 编排架构 |
| architecture/harness-quality-gates.md | Harness 与质量门禁 |
| architecture/rag-architecture.md | RAG/知识检索新架构 |
| architecture/retrieval-observability.md | 检索与可观测性架构 |
| architecture/feedback-architecture.md | 反馈与自评估架构 |
| architecture/session-trace-lifecycle.md | 会话与 Trace 生命周期 |
| architecture/knowledge-base-authoring.md | 知识库文档编写与维护 |
| architecture/data-model.md | 数据模型总览 |
| architecture/evolution-roadmap.md | Agent 架构演进路线 |
| issues/rag-refactor-plan.md | RAG 重构计划和阶段拆解 |
| demo/README.md | Demo 运行和面试演示材料 |
| demo/ten-minute-interview-demo.md | 10 分钟面试演示脚本 |
| eval/README.md | 诊断评测材料 |
| issues/README.md | MVP issue 索引 |
当前系统一句话
SuperBizAgent MVP 是一个可追踪的故障诊断 Agent：Chat 和 AIOps 入口进入 Agent 编排，Executor 显式调用知识库、日志、指标等工具收集证据，诊断过程落到 diagnosis_session、agent_step、tool_invocation，最终通过 Trace API、Verifier 和评测脚本证明结果可解释、可回放、可对比。
文档结构
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 脚本做回归验证。
关键运行链路
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/current-mvp-architecture.md 与 architecture/rag-architecture.md 为准。