AI Agent / 系统课时

会话状态设计

会话状态设计

多轮 Agent 能否稳定工作,关键不在于把全部消息反复传给模型,而在于维护一个可恢复的会话状态。本节从字段设计、持久化时机和并发控制出发,用 SQLite 实现一个带版本号的最小状态仓库。

学习目标

  • 把消息历史、任务状态、工具结果和控制字段拆成清晰的状态结构。
  • 选择适合会话状态的持久化时机、TTL 与恢复策略。
  • 使用版本号和事务避免并发请求互相覆盖状态。

状态不是聊天记录

聊天记录只是状态的一部分。真正可执行的会话状态还要回答“现在要完成什么、已经拿到哪些槽位、下一步能否调用工具、当前处理到第几轮”。因此应把可读消息与机器可判断字段分开,避免每次都依赖模型重新从长文本推断。

字段组 典型字段 作用
身份与边界 session_id、user_id 定位会话并隔离用户
对话进度 turn、messages 保留必要上下文与轮次
任务状态 goal、slots、pending_action 让流程可继续执行
控制信息 version、updated_at、expires_at 支持并发、恢复和过期

messages 不宜无限增长。较长会话可以保留最近若干轮原文,再把更早内容压缩成摘要;而 goal、slots 这类结构化字段应直接持久化,因为它们决定后续控制流。

一轮请求如何更新状态

多轮 Agent 会话状态的读取与提交时序

推荐把一轮处理看成“读取快照 → 计算下一状态 → 原子提交”。如果同一 session_id 可能同时收到两个请求,不能简单地“最后一次写入覆盖前一次写入”,否则先完成的工具结果或用户输入可能丢失。

版本号是最小可行的乐观锁:读取到 version=4 后,只允许在数据库仍是 4 时更新为 5。若更新行数为 0,可能是旧版本、身份不匹配或记录已过期。应按已认证身份重新读取状态,核对业务请求是否仍适用,再决定是否重试。

用 SQLite 持久化最小状态

下面把状态 JSON、版本号和过期时间分开。脚本只在专用临时目录写入一个 SQLite 文件。每次操作都重开并关闭连接;时间参数使用固定的模拟秒数以便复现。真实接口须由服务器提供时钟及已验证的用户身份。

python
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("到期状态被重新写活")

预期输出如下。

text
旧快照: 冲突
重连读回: version=2, turn=2, time=15:00
其他用户: None
到期状态: None

示例模拟两个请求读取同一旧版本,之后只允许第一个写入。到期读不到并不等于底层记录已经删除,清理应由明确的保留策略负责。会话标识应由服务端生成并保持不复用,避免删除后旧请求误写同名新会话。

处理过期、检查点与副作用

会话状态通常需要 TTL。短期客服会话可以在长时间不活跃后自动清理;持续数天的工作流则应把业务任务状态和纯聊天上下文拆开,避免聊天 TTL 到期后把仍需继续的任务一起删除。

会话版本号只保护本地状态。若工具会创建工单、支付或发送消息,应先持久化待执行意图和稳定动作 ID,再调用外部工具。工具支持幂等键时,重试沿用同一个键;超时后优先查询或对账,并持久化执行结果。若外部服务既不能按动作 ID 查询,也不提供幂等能力,应保留结果未知状态,等待进一步核实。

状态设计的验收标准不是字段越多越好,而是服务重启后能继续、并发请求不会互相覆盖、过期数据能清理,并且每个关键工具动作都能从持久化状态中判断已经执行到哪一步。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

会话状态设计

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通