小节一:Session 和 Run 到底为什么必须拆开——一个管“会话”,一个管“执行”

先看这张图,整体结构会一下子顺很多。它把 Session 负责“谁在聊、上下文怎么延续”,以及Run 负责“这次执行到底发生了什么” 这两件事分开画出来了。

图片[1]-小节一:Session 和 Run 到底为什么必须拆开——一个管“会话”,一个管“执行”-大赛人网

如图可以很直观地看到:同一个 Session 更像用户长期存在的任务空间,而不同的 Run 则像一次次独立的执行记录。用户先查询资料、再分析数据、再生成报告,这三件事完全可以放在同一个 Session 里连续完成,但最好拆成多个 Run 分别追踪。这样,后面的状态、步骤、错误信息才不会混在一起。

这是本章最核心的概念。

Session 和 Run 是两个完全不同的东西。

很多早期项目为了方便,直接:

session_id == run_id

对于最小 Demo 似乎没问题。

但只要支持真正多轮交互,就会马上出问题。

Session 是长期会话容器

Session 主要管理:

messages
working_memory
tool_history
runs
会话状态

它回答,“用户现在处在哪一段上下文里?”

例如:

sess_project_bug_001

从上午到下午都可以继续。

Run 是一次具体任务执行

Run 回答,“刚才那一次 Agent 任务执行,现在是什么状态?”

比如:

run_001:
定位失败原因

run_002:
修改代码

run_003:
验证测试

每个 Run 都有自己的:

start_time
end_time
status
steps
error

为什么一个 Session 可以有多个 Run?

因为用户的对话和 Agent 的执行不是一一对应的“只有一次”。

比如:

User:
先帮我分析,不要修改。

Run 1。

Agent 分析完。

用户:

可以修改。

Run 2。

Agent 修改完。

用户:

再跑一次完整测试。

Run 3。

上下文一直连续。

所以:

Session 1 ──> Run 1
          ├─> Run 2
          └─> Run 3

这是典型的一对多。

为什么不能用一次 HTTP 请求代表 Run?

很多时候当前确实是:

1 request = 1 run

但以后不一定。

例如:

POST /api/v1/runs

只负责创建任务。

真正执行可能由 Worker 异步进行。

客户端后面:

GET /api/v1/runs/{run_id}

多次查询。

所以,Run 是业务任务对象,不是 HTTP Request 本身。

Working Memory 属于 Session 还是 Run?

这一块如果只看文字,很多同学会感觉抽象。配合下面这张关系图去看,就会更容易抓住重点。

图片[2]-小节一:Session 和 Run 到底为什么必须拆开——一个管“会话”,一个管“执行”-大赛人网

图里其实讲的是一个很实用的判断:Working Memory 更接近 Session 级状态,而不是某一次瞬时执行的私有字段。 会话历史和工作记忆都跟着 Session 持续存在,因此它们可以为多个 Run 反复提供上下文支持。换句话说,Run 之间虽然彼此独立,但并不是彼此隔绝,它们共享的是同一个 Session 里的连续任务背景。

前面为了学习简单,我们把 Working Memory 放在 Session。

从更成熟角度看,可以进一步拆:

Session Memory:
长期会话背景

Run Working Memory:
当前任务 Goal / Plan / Error / Next Action

本章先不重构全部实现。

但要形成这个意识,越是与“这一次执行”相关的状态,越应该逐渐靠近 Run。

Run 结束不等于 Session 结束

Run:

COMPLETED

用户可能继续问:

“为什么你这么改?”

Session 仍然:

ACTIVE

所以不要做:

run completed
→ close session

这是非常常见的错误。

一个最小关系模型

from __future__ import annotations
from dataclasses import dataclass, field


@dataclass
class Run:
    run_id: str
    session_id: str
    status: str = "READY"


@dataclass
class Session:
    session_id: str
    runs: list[str] = field(
        default_factory=list
    )


if __name__ == "__main__":
    session = Session(
        session_id="sess_001"
    )

    run1 = Run(
        run_id="run_001",
        session_id=session.session_id,
    )

    run2 = Run(
        run_id="run_002",
        session_id=session.session_id,
    )

    session.runs.extend([
        run1.run_id,
        run2.run_id,
    ])

    print(session)
    print(run1)
    print(run2)

这个模型很简单。

但一对多关系已经建立。

© 版权声明
THE END
喜欢就支持一下吧
点赞7 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容