对话入口与生命周期管理

这部分是整个系统的"大门"，一个对话请求从前端发过来，系统怎么接住它、怎么管理它从生到死的整个过程，都在这里。

整体流程概览

一个对话请求的生命周期大致是这样的：

核心设计思路

整个流程用了"租约 + 注册表"双重保护：Redis 租约防止集群级别的并发冲突，JVM 注册表防止单机级别的重复处理。两层加在一起，确保同一个会话在同一时刻只有一个节点在处理。

包路径： org.javaup.ai.chatagent.controller

这是对话相关的所有 HTTP 接口入口。

方法	路径	说明
`stream()`	POST `/api/chat/stream`	SSE 流式对话主入口，返回 `text/event-stream`
`stop()`	POST `/api/chat/session/stop`	停止当前正在生成的回答
`session()`	POST `/api/chat/session/detail`	获取会话详情
`sessions()`	POST `/api/chat/session/list`	分页查询会话列表
`reset()`	POST `/api/chat/session/reset`	重置会话（清空历史）
`exchange()`	POST `/api/chat/exchange/detail`	获取单次问答的详细信息
`documentOptions()`	POST `/api/chat/document/options`	获取可选的知识文档列表
`rebuildSummary()`	POST `/api/chat/session/summary/rebuild`	重建会话记忆摘要
`retrievalResults()`	POST `/api/chat/exchange/retrieval/results`	查看检索观测结果
`channelExecutions()`	POST `/api/chat/exchange/channel/executions`	查看通道执行记录
`stageBenchmarks()`	POST `/api/chat/stage/benchmarks`	查看各阶段性能基准

付费内容提示

加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。

100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容

8套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台和 AI Agent 等方向

AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点

文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务

每套项目均包含从 0 到 1 讲解文档核心业务讲解视频

从基础项目到复杂业务场景，项目资料会持续更新。

8 套项目

进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。

从学习、面试到项目启动，都可以继续获得支持。