common_agent/后端实现文档/5.Agent会话模块后端实现.md

Agent 会话模块后端实现

1. 当前实现落点

当前 Agent 定义和调试入口位于 com.bruce.agent。后续会话能力建议继续放在该包下。

2. Controller 草案

• AgentDefinitionController：保留定义管理和兼容调试入口。
• AgentSessionController：新增会话查询、详情和消息发送。
• AgentRunController：新增运行入口，关联 Workflow 或模型调用。

3. Service 草案

Service	职责
IAgentDefinitionService	Agent 定义管理
IAgentSessionService	会话创建、关闭、查询
IAgentMessageService	消息写入和引用保存
IAgentRunService	对话编排、RAG 召回、模型调用
IAgentCapabilityBindingService	能力绑定维护

4. 校验规则

• Agent 必须启用才允许发起对话。
• RAG 对话必须绑定可用知识库和 Embedding 配置。
• 消息内容不能为空。
• citation_json 必须是数组结构。
• 会话关闭后不允许继续写入消息。