大模型应用开发 / 系统课时
保存会话历史
保存会话历史
会话历史要同时解决“能按原顺序重放”和“能恢复工具调用状态”两个问题。本节用一个最小数据库模型保存会话、消息、角色、内容与调用状态,并给出可直接运行的 SQLite 示例验证顺序和关联约束。
学习目标
- 设计会话与消息的最小持久化结构
- 用稳定序号保证消息能够按原顺序重放
- 保存工具调用 ID 与执行状态,避免恢复会话时丢失上下文
把会话和消息拆开存
一条会话负责保存会话级属性,例如创建时间和业务用户标识;具体对话内容则拆成多条消息。消息至少需要 session_id、seq_no、role、content,工具相关消息再保存 tool_call_id 与 call_state。
不要只依赖数据库自增主键判断对话顺序。并发写入、数据迁移或批量导入都可能让主键顺序与真实消息顺序不一致。更稳妥的做法是在每个会话内部维护从 1 开始递增的 seq_no,并对 (session_id, seq_no) 建唯一约束。

用最小表结构持久化历史
下面的 Python 脚本使用标准库 sqlite3 创建两张表,并写入一段包含工具调用的会话。它既能直接运行,也展示了保存顺序和调用状态所需的最小字段。
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("PRAGMA foreign_keys = ON")
conn.executescript(
'''
CREATE TABLE sessions (
session_id TEXT PRIMARY KEY,
created_at TEXT NOT NULL
);
CREATE TABLE messages (
message_id INTEGER PRIMARY KEY AUTOINCREMENT,
session_id TEXT NOT NULL,
seq_no INTEGER NOT NULL,
role TEXT NOT NULL,
content TEXT,
tool_call_id TEXT,
call_state TEXT,
FOREIGN KEY (session_id) REFERENCES sessions(session_id),
UNIQUE (session_id, seq_no)
);
'''
)
conn.execute(
"INSERT INTO sessions(session_id, created_at) VALUES (?, ?)",
("sess_001", "2026-09-04T06:00:00Z"),
)
rows = [
("sess_001", 1, "user", "查询订单 A100", None, None),
("sess_001", 2, "assistant", None, "call_1", "requested"),
(
"sess_001",
3,
"tool",
'{"order_id":"A100","status":"shipped"}',
"call_1",
"completed",
),
("sess_001", 4, "assistant", "订单 A100 已发货。", None, None),
]
conn.executemany(
'''
INSERT INTO messages(
session_id, seq_no, role, content, tool_call_id, call_state
) VALUES (?, ?, ?, ?, ?, ?)
''',
rows,
)
for row in conn.execute(
'''
SELECT seq_no, role, COALESCE(tool_call_id, '-'), COALESCE(call_state, '-')
FROM messages
WHERE session_id = ?
ORDER BY seq_no
''',
("sess_001",),
):
print(row)
conn.close()预期输出
(1, 'user', '-', '-')
(2, 'assistant', 'call_1', 'requested')
(3, 'tool', 'call_1', 'completed')
(4, 'assistant', '-', '-')示例中的 sess_001、call_1 和时间只是演示值;生产环境应替换为真实的 <ID> 与 <TIME>。
恢复会话时按序重放
读取历史时,应始终用 session_id 过滤并按 seq_no 升序排序,再映射成模型 API 需要的消息对象。不要把数据库里的 message_id 当作协议字段直接发给模型,除非你的模型接口明确要求它。
工具调用恢复还要检查状态。requested 表示助手已经提出调用但结果尚未写回;completed 表示对应工具结果可以安全参与下一轮推理;如果状态是 failed,应同时保存可诊断错误信息,并由应用决定重试、回退还是向用户报告失败。
保证写入不会出现半截历史
一次“助手发起工具调用 → 工具返回结果”的链路可能跨多个请求,因此数据库要允许中间状态存在。关键不是强行把所有消息塞进一个事务,而是确保每次状态变化都有明确记录,并能在崩溃后判断停在哪里。
写入单条消息时,先分配下一个 seq_no,再用唯一约束避免同一会话出现重复序号。若应用有多个并发写入者,应通过事务、行级锁或原子计数器生成序号,而不是先查询最大值再无保护地加一。
会话历史真正需要持久化的是“可重放的事实”:谁说了什么、发生在第几步、工具调用属于谁、现在完成到什么状态。把这些字段保存完整后,截断、摘要、归档和迁移都可以在不破坏语义的前提下继续演进。