Run:每一次 Agent 任务都应该有生命周期

上一节,我们已经第一次真正把 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 任务都应该有生命周期-大赛人网

Run 生命周期:

图片[2]-Run:每一次 Agent 任务都应该有生命周期-大赛人网

本节先正式实现:

READY
RUNNING
COMPLETED
FAILED

WAITING_APPROVAL 会在后面的 Human in the Loop 章节展开;CANCELLING、CANCELLED 和 BUDGET_EXCEEDED 先作为工程版扩展状态出现。核心规则不变:只有状态图允许的边才能走,终态不能被随手改回 RUNNING。

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

昵称

取消
昵称

    请登录后查看评论内容