30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# 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`
|