EduSpark 智能教学实训平台
基于 A2A 架构的 AI 驱动教学平台，为教师提供智能出题、课程管理、学习分析等功能，为学生提供个性化 AI 辅导和自适应练习
独立开发者、架构师、设计师、产品经理、全栈开发、测试运维 · 2024年5月 - 至今 · 个人项目
Coze / Framer Motion / MyBatis-Plus / Next.js 15 / PGVector / PostgreSQL / React 19 / Spring AI / Spring Boot 3.4.6 / Tailwind CSS 4 / TypeScript / Zustand / 智谱AI / 讯飞星火 / 阿里云百炼
项目简介
EduSpark 是一款基于开源大模型的教学实训智能体软件，旨在通过 AI 赋能教师和学生，提升备课效率，提供个性化练习与指导，推动教育数字化转型。平台采用现代化的 A2A（Agent-to-Agent）架构，支持 AI 智能助教、AI 出题、知识库问答、作业管理等核心功能。
核心亮点
A2A 智能 Agent 架构: 采用调度 Agent + 专家 Agent 模式，调度 Agent 负责意图理解和任务分发，Expert Agents 负责课程设计、RAG 检索、代码生成、逻辑验证等专业任务，支持动态路由和成本优化
白盒化 RAG 知识库: 完整实现 Retrieval-Augmentation-Generation 三阶段，基于 PGVector HNSW 索引实现向量相似度检索，支持 10 万字符上下文上限保护，智能截断防止 Token 超限
多模型智能路由: 原生集成智谱 AI（glm-4）、阿里云百炼（qwen-max）、讯飞星火（spark-pro）三大国产大模型，支持根据任务类型和成本效益动态选择最优模型
SSE 流式响应: 基于 Server-Sent Events 实现实时流式对话，支持上下文感知（课程/章节/知识点），最终返回检索引用的知识切片，实现可溯源的 AI 回答
Coze 平台深度集成: 完整对接 Coze API，支持工作流调用、知识库创建、文档自动分片（chunk strategy）、本地文件/URL 一键上传
完整教学闭环: 覆盖课程管理→知识库构建→AI 助教问答→AI 智能出题→作业布置→自动批改→学习分析全流程
现代化全栈架构: 前端 Next.js 15 + React 19 + Zustand + Tailwind CSS 4，后端 Spring Boot 3.4.6 + Spring AI + MyBatis-Plus，数据库 PostgreSQL + pgvector 向量引擎
挑战
- 复杂任务分解: 将教学任务分解为可由不同专家 Agent 处理的子任务，实现任务智能分发
- 多模型协调: 根据任务特点、模型能力和成本效益动态选择最优 AI 模型
- 知识库构建: 基于 PGVector 构建课程内容的向量知识库，支持语义检索和 HNSW 索引加速
- 上下文感知: 根据用户选择的课程/章节/知识点动态构建知识背景，实现精准问答
- Token 保护: 严格的上下文长度控制，防止超出模型 Token 限制
- 流式交互: SSE 长连接实现实时流式响应，支持中断和错误恢复
解决方案
- A2A 架构设计: 实现 Dispatcher Agent 负责意图理解和任务分发，Expert Agents 负责具体执行，支持动态路由
- 白盒化 RAG: 完整的检索-增强-生成流程实现，向量检索 + Prompt 组装 + LLM 生成三阶段清晰可见
- 模型路由层: 开发智能路由层，根据任务类型、模型能力、成本自动选择最适合的模型
- RAG Pipeline: 构建完整的向量化存储和检索流程，支持 PDF 文档解析、智能分片、语义匹配
- 上下文构建: 从课程/章节/知识点递归获取内容，动态构建问答上下文
- SSE 流式处理: 前端使用 ReadableStream 处理流式数据，后端使用 SseEmitter 推送事件
