在使用各种Agent的时候,我们做的第一件事情一般都是:打开一个目录作为工作区,然后建立一个会话,在这个会话中和模型进行对话。今天我们就研究一下这个会话,也就是Session。
我们以阿里巴巴的Qoder为例进行研究,搞清楚
- 什么是Session
- 会话是怎么管理的
- 如何用好session
大多数内容同样适用于 DSH、Codex等其他Agent。
什么是会话
会话 是存储在本地的一段信息,它由各种记录组成,记录可以是用户发送的消息、模型回复的消息、执行工具调用的结果等,每个会话对应一个唯一的id。以qoder会话为例,它存在一个以会话id命名的jsonl文件中,如下是其中一段用户消息。
{
"type": "user",
"uuid": "b6bf503a-3882-4959-9d3c-75ea3ace8c20",
"timestamp": "2026-11-14T05:54:57.514Z",
"message": {
"role": "user",
"content": [
{
"type": "image",
"source": {
"type": "url",
"url": "https://qoder-vl-global.oss-ap-southeast-1.aliyuncs.com/cloud/wCF7OnKLIQ2OgocKqbmV3bMjPClHBzHpPf1q1ITu-BekL9r3inIvulpdviNmgmgR/3e0d70e5-de32-4ca3-b58c-d0b054715c12_1794635697456.png?Expires=1797227697&OSSAccessKeyId=LTAI5tEecipqHinJhS3LK6SV&Signature=1T7%2BA7dn2bOs%2Bbpi701YEocb9cg%3D"
}
},
{
"type": "text",
"text": "有个问题:清楚卡片文字后,点击回车,卡片文字不会变成空
附件引用:
- 文件:/Users/abcamus/.qoder/tmp/-Users-abcamus-Workspace-market-assist/images/09908724-533f-468c-9bcb-2b2a9303b30c/cf76bf92-8506-4449-8870-d7b0a17514c6.png"
}
]
},
"permissionMode": "auto",
"origin": {
"kind": "human"
},
"promptId": "bcfe4a2f-8d74-4539-a8b8-af68c5a501a3",
"humanInput": {
"text": "有个问题:清楚卡片文字后,点击回车,卡片文字不会变成空
附件引用:
- 文件:/Users/abcamus/.qoder/tmp/-Users-abcamus-Workspace-market-assist/images/09908724-533f-468c-9bcb-2b2a9303b30c/cf76bf92-8506-4449-8870-d7b0a17514c6.png",
"mode": "prompt"
},
"requestSetId": "b6bf503a-3882-4959-9d3c-75ea3ace8c20",
"businessModelKey": "dfmodel",
"businessIdentity": {
"product": "app",
"type": "agent",
"id": "b6bf503a-3882-4959-9d3c-75ea3ace8c20",
"model_key": "dfmodel"
},
"parentUuid": "60e07eec-9315-4c90-919c-52963b8178de",
"isSidechain": false,
"cwd": "/Users/abcamus/Workspace/market-assist",
"sessionId": "09908724-533f-468c-9bcb-2b2a9303b30c",
"userType": "external",
"entrypoint": "cli",
"version": "1.1.79-hotfix.19",
"gitBranch": "main"
}
而在会话内部,每条记录也有各种个样的id,每个id有其特定的含义,如下表所示:
| ID | 出现位置 | 作用 | 解释 |
|---|
| 09908724-… | 文件名 + 每条记录的 sessionId | 标识整个会话 | 全文只有一个值 |
| uuid | 每条 assistant/user 记录 | 标识记录节点 | 1580 条 uuid 全部互不相同,且没有一条等于会话 ID |
| parentUuid | 每条记录 | 指向上一节点 | 串成一条链,分支时形成树 |
| leafUuid | active-leaf 记录 | 指向当前叶子 | 用于定位继续/分支的位置 |
| message.id | assistant 记录的 message.id | 一次模型回复的编号 | 同一次回复的 thinking、tool_use 等拆成多条记录,共享同一个 message.id |
| requestId | requestTokenAnchor.requestId | 一次模型请求的编号 | 与 message.id 一一对应 |
| promptId | 用户轮次及其后续记录 | 一次用户提问的编号 | 对应人类输入 |
| requestSetId | 用户记录 | 这次提问引发的全部请求 | 值等于该用户记录自己的 uuid |
会话和上下文:Agent通过会话中的记录生成本轮对话的上下文发送给大模型。模型上下文长度是大模型训练后的特征,如果处理的内容超过上下文,模型工作效果就会大打折扣。
会话是记忆吗?会话记录了每个任务的前因后果,因此它其实就是一种记忆。
会话管理
Qoder 里”会话”是三层东西:一份按项目落盘的记录 + 一份状态 + 一棵消息树。Desktop 和 IDE 的记录独立存储,Desktop 另有 Data import 导入 IDE 数据。Desktop 界面把它叫 task(任务),CLI 叫 session(会话),其实都是指向的同一个对象。记录是追加式 JSONL,每条带 sessionId;消息用 uuid/parentUuid 串成树,active-leaf 标当前叶子。状态在 state.json(创建/更新时间、revision、名称等),压缩产物在 compression-v2/。会话可以创建、分叉、删除、归档。
前面我们提到会话和上下文的关系,那么Agent是如何生成上下文的呢?
每当用户输入,触发
- 从 active-leaf 沿 parentUuid 回溯出当前分支
- 系统层(提示词、规则文件、Hook 输出)
- 目录层(工具、Skill、Agent、MCP)
- 记忆层(Memory 索引与相关条目)
- 历史层(消息链与工具结果)
- 附本轮输入(文本、图片、@文件、附件)
- 超限则压缩早期消息
- 发送 → 模型回复 → 工具执行 → 结果回填 → 再次装配(循环)
目前很多工作集中在 4 记忆层,比如如何在新会话(或者新设备中)中更优地recall记忆。
如何用好会话
会话具备隔离性,为了更好的提示模型干活,推荐同一个类型的任务保持在同一个会话中,不宜频繁地创建新会话。比如我的实践是这样的,在产品迭代过程中,通常会常驻三个会话:
- 头脑风暴:用来和AI发散式讨论
- 开发:代码生成
- 问题修复:修复问题
- 市场:用于生成市场推广材料