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/archive/2026-07-05-legacy/
本次文档清理归档：archive/2026-07-09-doc-cleanup/

归档文档只用于追溯设计历史。当前实现和后续规划以 architecture/、issues/README.md、tables/README.md 和 OpenSpec/devflow 的最新记录为准。

5.0 KiB Raw Blame History Unescape Escape