先看这张图,整体结构会一下子顺很多。它把 Session 负责“谁在聊、上下文怎么延续”,以及Run 负责“这次执行到底发生了什么” 这两件事分开画出来了。
![图片[1]-小节一:Session 和 Run 到底为什么必须拆开——一个管“会话”,一个管“执行”-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1610.png)
如图可以很直观地看到:同一个 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 到底为什么必须拆开——一个管“会话”,一个管“执行”-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1611.png)
图里其实讲的是一个很实用的判断: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)
这个模型很简单。
但一对多关系已经建立。
















请登录后查看评论内容