已跑通会话创建、消息持久化、模型调用与 token / 延迟 / 错误记录的 V1 对话闭环
AI-assistant
产品名:企业级 AI 助手平台
项目代号为 ai-study,目标不是做一次性的聊天 Demo,而是从可验证的对话闭环开始,逐步构建包含 RAG、权限过滤、Agent、评测与多模型网关的企业级 AI 应用。当前已完成 V0 运行骨架和 V1 对话 MVP:Vue 前端、Java 业务 API、Python 模型适配、会话与调用记录均可在 Docker Compose 环境中运行。
项目定位
面向 Java 后端开发者进阶 AI 应用工程的实战项目。Java 负责企业业务、身份上下文、审计与数据边界;Python 负责模型接入、检索与后续 Agent 编排,在一个可运行、可验证、可复盘的项目中把两类能力真正串起来。
目标用户
核心价值
Java 与 Python 通过显式请求上下文协作,租户、用户、角色和 request ID 可跨服务追踪
提供 demo provider 与 OpenAI 兼容接口两种模式,先保证本地确定性验证,再接入真实模型
Docker Compose 统一编排 PostgreSQL、Redis、Milvus、Java、Python 与前端,并区分存活和就绪检查
MVP 范围
开发路线
V0 / V1:运行骨架与对话闭环(已完成)
- Docker Compose 环境
- 请求上下文
- Chat 会话与调用日志
- Vue 工作台
- demo 与 OpenAI 兼容模型适配
V2:文档知识库 RAG MVP
- 文档上传与解析
- 分段和向量化
- Milvus 检索
- 带引用的知识库问答
V3 / V4:企业 RAG 加固与 Agent
- 文档权限过滤
- 混合检索与重排
- 工具调用
- 高风险操作人工确认
V5 - V7:评测、模型网关与作品集
- RAG / Agent 评测
- 调用观测与成本统计
- 多模型路由与配额
- 完整演示和项目复盘
风险与注意事项
- 当前开发模式允许 demo 租户、用户和角色;接入正式认证前不能将该模式用于生产环境
- 当前前端使用同步对话接口,后端 SSE 仍需在真实模型接入后升级为端到端 token 流式与断连收尾机制
- 外部模型调用不受数据库事务覆盖,超时、重试、半成功与补偿策略需要在真实调用场景中继续完善
- RAG 上线前必须把租户、用户和角色过滤前置到检索链路,不能仅依赖提示词约束
- 真实模型 API Key、调用成本、日志脱敏和数据合规需要建立独立的配置与治理机制
项目文章
AI 助手 07:不用 Kibana,如何把 Elasticsearch 日志检索接入业务管理后台
基于 ai-study V1.6 已实现基线,记录 Java、Python、Filebeat、Elasticsearch 与管理员日志页面如何通过 requestId 形成可控的排查链路。
AI 助手 06:Spring Boot 多租户系统如何设计登录态和权限上下文
基于 ai-study V1.5 已实现基线,拆解 JWT access token、refresh token 轮换、请求上下文与 RBAC 如何共同替代浏览器伪造的租户身份。
AI 助手 05:写迭代博客时,先把事实和路线图分开
记录本次项目页整理得到的写作约束:已实现能力、明确风险和后续计划必须分层表达,避免把路线图误写成项目成果。
AI 助手 04:别用一段简介代替项目档案
记录这次如何把 AI-assistant 项目页从简略卡片补成可维护的项目档案:当前能力、技术边界、路线图和风险必须放在同一个页面里。
AI 助手 03:先确认依赖就绪,再宣布服务可用
记录 V0 到 V1 的多服务启动策略:Docker Compose 如何组织 PostgreSQL、Redis、Milvus、Java 与 Python,并区分存活检查和就绪检查。
AI 助手 02:先固定请求上下文,再谈知识库权限
记录 V1 如何在 Java 与 Python 服务之间传递 requestId、租户、用户和角色,并把开发便利与生产边界分开。
AI 助手 01:先做一个可验证的企业级对话闭环
记录 Enterprise AI Assistant Platform 的第一轮实现:为什么先打通会话、上下文、模型调用和调用记录,而不是直接堆 RAG 与 Agent。