SuperBizAgent MVP 文档
更新日期：2026-07-10
本目录保存 MVP 阶段的架构、问题、演示、评测和数据表说明。当前材料按“当前入口”和“历史归档”拆开，避免把早期设计稿当成当前实现。
当前入口
| 目录/文档 | 用途 |
|---|---|
| architecture/README.md | 当前 MVP 架构入口 |
| architecture/current-mvp-architecture.md | 当前可运行系统架构 |
| architecture/interview-one-pager.md | 面试一页式架构讲解 |
| architecture/agent-orchestration.md | Agent 编排架构 |
| architecture/executor-evidence-pipeline-refactor.md | Executor 证据链路改造记录 |
| 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/README.md | MVP issue 索引 |
| issues/active/rag-refactor-plan.md | RAG 重构计划和阶段拆解 |
| tables/README.md | 当前 MySQL 表说明 |
| demo/README.md | Demo 运行和面试演示材料 |
| demo/ten-minute-interview-demo.md | 10 分钟面试演示脚本 |
| 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 和评测脚本证明结果可解释、可回放、可对比。
文档结构
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 脚本做回归验证。
关键运行链路
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/、issues/README.md、tables/README.md 和 OpenSpec/devflow 的最新记录为准。