上一节,我们已经第一次真正把 Agent 包成了 HTTP Backend Service。
现在客户端可以调用:
POST /api/v1/chat
请求:
{
"message": "检查这个 Python 项目"
}
然后服务端返回:
{
"answer": "...",
"run_id": "run_xxx",
"status": "completed"
}
到这里,run_id 已经出现了。
但上一节的 run_id 还只是,一个用于标识这次执行的唯一字符串。
它还不是一个真正的“任务对象”。
真正的 Agent Backend 很快会遇到这样的问题:
这个任务什么时候开始的?
现在还在跑吗?
已经跑到第几步?
刚才调用了哪个 Tool?
失败了吗?
失败原因是什么?
什么时候结束的?
属于哪个 Session?
如果 run_id 后面什么都没有,我们根本回答不了这些问题。
所以这一节,我们正式把 Run 设计成一个有生命周期的对象:
run_id
session_id
status
created_at
start_time
end_time
steps
error
并实现两个非常重要的 API:
POST /api/v1/runs
GET /api/v1/runs/{run_id}
从这一节开始,我们不再把 Agent 执行理解成:
调用一个函数
等它返回
而是理解成,创建一个 Run,让它经历一段完整生命周期。
这也是 Agent Backend 和普通脚本之间非常明显的差别。
开场引入
先看一个简单场景。
用户在同一个 Session 中先说,“帮我定位这个 Python 项目为什么 pytest 失败。”
Agent 分析完成。
过一会用户继续,“可以,按你刚才的结论修掉。”
再过一会,“重新跑完整测试,再给我最终结论。”
这其实已经发生了三次具体任务执行:
Session:
sess_001
Run 1:
定位测试失败
Run 2:
执行修复
Run 3:
重新验证
如果我们只用:
session_id
来表示所有事情,那么日志里会变成:
sess_001 started
sess_001 tool_call
sess_001 completed
sess_001 started
sess_001 tool_call
sess_001 failed
sess_001 started
...
你很难知道,到底哪一次 started 对应哪一次 completed?
这就是 Run 出现的第一个理由,Session 内的每一次任务执行,都需要独立标识。
再看另一个场景。
用户提交:
分析这个项目
Agent 需要运行 90 秒。
第 20 秒时,前端问,“现在怎么样了?”
如果只有同步 /chat 接口,前端只能等。
但如果我们已经有 Run:
run_abc123
就可以查询:
GET /api/v1/runs/run_abc123
返回:
{
"run_id": "run_abc123",
"status": "running",
"steps": 4
}
到第 70 秒,再查:
{
"run_id": "run_abc123",
"status": "running",
"steps": 12
}
最后:
{
"run_id": "run_abc123",
"status": "completed",
"end_time": "...",
"steps": 15
}
这时 Run 就真正成为,Agent Backend 的任务生命周期对象。
这一节的重点不在“异步队列”。
我们先用同步执行,甚至先用内存存储。
但数据模型一定要先设计正确。
因为后面:
Streaming
SQLite
Tracing
Evaluation
Human in the Loop
全部都会围绕 Run 展开。
知识地图
![图片[1]-Run:每一次 Agent 任务都应该有生命周期-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1608.png)
Run 生命周期:
![图片[2]-Run:每一次 Agent 任务都应该有生命周期-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1609.png)
本节先正式实现:
READY
RUNNING
COMPLETED
FAILED
WAITING_APPROVAL 会在后面的 Human in the Loop 章节展开;CANCELLING、CANCELLED 和 BUDGET_EXCEEDED 先作为工程版扩展状态出现。核心规则不变:只有状态图允许的边才能走,终态不能被随手改回 RUNNING。
















请登录后查看评论内容