# Agent 会话模块需求

## 1. 模块目标

Agent 会话模块负责 Agent 定义、对话调试、会话持久化、消息记录、引用切片和运行追踪，使一次调试或发布后的对话可以被复盘。

## 2. 功能需求

- 支持 Agent 定义管理，包含编码、名称、系统提示词、默认知识库和状态。
- 支持普通对话和 RAG 对话。
- 支持会话持久化，记录 `agent_session`。
- 支持消息持久化，记录用户、Agent、系统等角色消息。
- 支持保存引用切片 JSON，便于回答溯源。
- 支持关联 Workflow 运行记录，形成端到端 Trace。

## 3. 会话场景

1. 用户选择 Agent 输入调试问题。
2. 系统创建或复用会话。
3. RAG 模式下执行检索召回。
4. 调用 Chat 模型生成回答。
5. 写入消息、引用、模型请求 ID 和运行追踪。

## 4. 关联资料

- 表：`agent_definition`、`agent_session`、`agent_message`、`agent_capability_binding`
- 脚本：`script/sql/agent_definition.sql`、`script/sql/agent_session.sql`、`script/sql/agent_capability_binding.sql`
- 前端原型：`AgentWorkspacePage.vue`
- 后端入口：`AgentDefinitionController`、`AgentDefinitionServiceImpl`