# Agent 会话模块设计

## 1. 核心模型

| 对象 | 说明 |
|------|------|
| Agent 定义 | Agent 配置主数据 |
| Agent 会话 | 一段连续对话上下文 |
| Agent 消息 | 会话中的单条消息 |
| 能力绑定 | Agent 或 Workflow 绑定知识库、MCP、Skill 等能力 |

## 2. 对话模式

- 普通对话：直接根据会话消息调用 Chat 模型。
- RAG 对话：先向量化问题，再召回知识切片，再组装上下文调用 Chat 模型。
- Workflow 对话：通过绑定的 Workflow 运行，消息与运行记录互相关联。

## 3. 引用设计

`agent_message.citation_json` 保存回答引用：

- 文档 ID。
- 切片 ID。
- 分数。
- 引用文本摘要。
- 知识库 ID。

引用只保存必要摘要，完整切片仍以 `rag_chunk` 为准。

## 4. 状态设计

会话状态建议包括：

- ACTIVE：活跃。
- CLOSED：已关闭。
- FAILED：异常终止。

消息角色建议包括：

- USER。
- ASSISTANT。
- SYSTEM。
- TOOL。

## 5. 模块依赖

- 依赖知识资产模块完成 RAG 召回。
- 依赖模型与路由模块完成 Chat 调用。
- 可依赖 Workflow 模块执行复杂流程。
- 运行观测模块读取会话关联的运行记录。