docs: add interview project materials

2026-07-05 01:39:37 +08:00
parent 246c99b954
commit bf5286c8f4
5 changed files with 607 additions and 0 deletions
@@ -0,0 +1,59 @@
+# SuperBizAgent Interview Guide
+
+## 一句话定位
+
+SuperBizAgent 是一个面向企业故障诊断场景的 Agent Engineering 项目：它把用户问题或告警事件转成可追踪的多 Agent 执行链路，并把工具证据、模型步骤、最终答案和反馈统一落到诊断 trace 中。
+
+## 面试重点
+
+- **多 Agent 编排**：普通 Chat 的复杂问题走 `Planner -> Executor -> Verifier`；AIOps 告警入口走 Supervisor 调度 Planner/Executor。
+- **工具证据链**：知识库、日志、指标和 Prometheus 告警都通过工具调用进入链路，并记录到 `tool_invocation`。
+- **可追踪诊断**：一次会话对应一个 `sessionId`，最终可以通过 `GET /api/diagnosis/{sessionId}/trace` 回放。
+- **质量门**：Chat 链路包含 Verifier，把 groundedness、facts checked 和 evidence refs 写回 `diagnosis_session.self_evaluation`。
+- **AIOps 产品边界**：有告警 payload 时聚焦该告警；没有 payload 时先自动发现 active alerts。
+- **可复现 Demo**：`mvp-demo` profile 使用 mock Prometheus 和 mock CLS，让面试演示不依赖真实线上故障。
+
+## 推荐阅读顺序
+
+1. `interview/demo-script.md`：面试现场怎么讲、怎么演示。
+2. `interview/architecture.md`：系统架构和两条主链路。
+3. `interview/design-tradeoffs.md`：关键设计取舍和可被追问的问题。
+4. `interview/acceptance-checklist.md`：面试前验证清单。
+5. `mvp/demo/README.md`：更细的 MVP 可执行 runbook。
+
+## 核心 Demo
+
+### Chat Diagnosis
+
+```text
+POST /api/chat
+-> ChatService.executeChatWithStrategy(...)
+-> simple ReactAgent or Planner -> Executor -> Verifier
+-> lookup_knowledge / query_logs / query_metrics
+-> diagnosis_session + agent_step + tool_invocation
+-> GET /api/diagnosis/{sessionId}/trace
+```
+
+### AIOps Alert Diagnosis
+
+```text
+POST /api/ai_ops
+-> AiOpsService.executeAiOpsAnalysis(...)
+-> ai_ops_supervisor
+-> planner_agent / executor_agent
+-> queryPrometheusAlerts + logs + knowledge
+-> scoped alert report
+-> GET /api/diagnosis/{sessionId}/trace
+```
+
+## 当前完成度
+
+- Chat 诊断链路：可运行、可追踪、有 Verifier。
+- AIOps 告警链路：可运行、可追踪、支持 payload scope control。
+- Trace API：统一返回 session、agent steps、tool invocations 和 summary。
+- Demo 文档：`mvp/demo/README.md` 和 `mvp/demo/aiops-alert-acceptance.md`。
+- Devflow 沉淀：`devflow/index.md` 记录了 MVP、Verifier、AIOps trace 和 AIOps scope-control 的演进。
+
+## 面试时的主叙事
+
+这个项目不是简单调用大模型，而是在做一个可审计的 Agent 诊断系统。核心价值是：模型可以规划和推理，但每一步工具证据、最终结论和质量评估都能被 trace API 回放。面试时重点展示“从问题到证据到答案到验证”的完整闭环。