51 lines
1.2 KiB
Markdown
51 lines
1.2 KiB
Markdown
# 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 模块执行复杂流程。
|
||
- 运行观测模块读取会话关联的运行记录。
|