AI Agent / 系统课时
会话状态设计
会话状态设计
多轮 Agent 能否稳定工作,关键不在于把全部消息反复传给模型,而在于维护一个可恢复的会话状态。本节从字段设计、持久化时机和并发控制出发,用 SQLite 实现一个带版本号的最小状态仓库。
学习目标
- 把消息历史、任务状态、工具结果和控制字段拆成清晰的状态结构。
- 选择适合会话状态的持久化时机、TTL 与恢复策略。
- 使用版本号和事务避免并发请求互相覆盖状态。
状态不是聊天记录
聊天记录只是状态的一部分。真正可执行的会话状态还要回答“现在要完成什么、已经拿到哪些槽位、下一步能否调用工具、当前处理到第几轮”。因此应把可读消息与机器可判断字段分开,避免每次都依赖模型重新从长文本推断。
| 字段组 | 典型字段 | 作用 |
|---|---|---|
| 身份与边界 | session_id、user_id |
定位会话并隔离用户 |
| 对话进度 | turn、messages |
保留必要上下文与轮次 |
| 任务状态 | goal、slots、pending_action |
让流程可继续执行 |
| 控制信息 | version、updated_at、expires_at |
支持并发、恢复和过期 |
messages 不宜无限增长。较长会话可以保留最近若干轮原文,再把更早内容压缩成摘要;而 goal、slots 这类结构化字段应直接持久化,因为它们决定后续控制流。
一轮请求如何更新状态

推荐把一轮处理看成“读取快照 → 计算下一状态 → 原子提交”。如果同一 session_id 可能同时收到两个请求,不能简单地“最后一次写入覆盖前一次写入”,否则先完成的工具结果或用户输入可能丢失。
版本号是最小可行的乐观锁:读取到 version=4 后,只允许在数据库仍是 4 时更新为 5。若更新行数为 0,可能是旧版本、身份不匹配或记录已过期。应按已认证身份重新读取状态,核对业务请求是否仍适用,再决定是否重试。
用 SQLite 持久化最小状态
下面把状态 JSON、版本号和过期时间分开。脚本只在专用临时目录写入一个 SQLite 文件。每次操作都重开并关闭连接;时间参数使用固定的模拟秒数以便复现。真实接口须由服务器提供时钟及已验证的用户身份。
from contextlib import closing, contextmanager
import json
from pathlib import Path
import sqlite3
from tempfile import TemporaryDirectory
@contextmanager
def transaction(path):
with closing(sqlite3.connect(path)) as conn, conn:
yield conn
def initialize(path):
with transaction(path) as conn:
conn.execute("""
CREATE TABLE IF NOT EXISTS sessions (
user_id TEXT NOT NULL,
session_id TEXT NOT NULL,
state_json TEXT NOT NULL,
version INTEGER NOT NULL,
expires_at INTEGER NOT NULL,
PRIMARY KEY (user_id, session_id)
)
""")
def load(path, user, session, now):
with transaction(path) as conn:
row = conn.execute("""
SELECT state_json, version FROM sessions
WHERE user_id=? AND session_id=? AND expires_at>?
""", (user, session, now)).fetchone()
return None if row is None else (json.loads(row[0]), row[1])
def save(path, user, session, state, expected, now, ttl=120):
if ttl <= 0 or expected < 0:
raise ValueError("invalid TTL or expected version")
payload = json.dumps(state, ensure_ascii=False)
with transaction(path) as conn:
if expected == 0:
result = conn.execute("""
INSERT INTO sessions VALUES (?, ?, ?, 1, ?)
ON CONFLICT(user_id, session_id) DO NOTHING
""", (user, session, payload, now + ttl))
else:
result = conn.execute("""
UPDATE sessions
SET state_json=?, version=version+1, expires_at=?
WHERE user_id=? AND session_id=? AND version=? AND expires_at>?
""", (payload, now + ttl, user, session, expected, now))
if result.rowcount != 1:
raise RuntimeError("state conflict")
return expected + 1
with TemporaryDirectory() as directory:
path = Path(directory) / "agent_state.db"
initialize(path)
user, session = "u-42", "s-1001"
initial = {"turn": 1, "goal": "预订会议室", "slots": {"date": "2026-09-03"}}
assert save(path, user, session, initial, expected=0, now=1000) == 1
first, version = load(path, user, session, now=1001)
stale, stale_version = load(path, user, session, now=1001)
first["turn"] = 2
first["slots"]["time"] = "15:00"
assert save(path, user, session, first, version, now=1001) == 2
try:
save(path, user, session, stale, stale_version, now=1002)
except RuntimeError:
print("旧快照: 冲突")
else:
raise AssertionError("旧快照覆盖了新版本")
recovered, version = load(path, user, session, now=1002)
print(f"重连读回: version={version}, turn={recovered['turn']}, time={recovered['slots']['time']}")
isolated = load(path, "u-99", session, now=1002)
print("其他用户:", isolated)
assert isolated is None
expired = load(path, user, session, now=1121)
print("到期状态:", expired)
assert expired is None
try:
save(path, user, session, recovered, version, now=1121)
except RuntimeError:
pass
else:
raise AssertionError("到期状态被重新写活")预期输出如下。
旧快照: 冲突
重连读回: version=2, turn=2, time=15:00
其他用户: None
到期状态: None示例模拟两个请求读取同一旧版本,之后只允许第一个写入。到期读不到并不等于底层记录已经删除,清理应由明确的保留策略负责。会话标识应由服务端生成并保持不复用,避免删除后旧请求误写同名新会话。
处理过期、检查点与副作用
会话状态通常需要 TTL。短期客服会话可以在长时间不活跃后自动清理;持续数天的工作流则应把业务任务状态和纯聊天上下文拆开,避免聊天 TTL 到期后把仍需继续的任务一起删除。
会话版本号只保护本地状态。若工具会创建工单、支付或发送消息,应先持久化待执行意图和稳定动作 ID,再调用外部工具。工具支持幂等键时,重试沿用同一个键;超时后优先查询或对账,并持久化执行结果。若外部服务既不能按动作 ID 查询,也不提供幂等能力,应保留结果未知状态,等待进一步核实。
状态设计的验收标准不是字段越多越好,而是服务重启后能继续、并发请求不会互相覆盖、过期数据能清理,并且每个关键工具动作都能从持久化状态中判断已经执行到哪一步。