LEWIS / INTERACTIVE DEEP DIVE01 — PI CODING AGENT

从一句话,
到一轮轮行动。

模型负责提出下一步,运行时让它真正发生。
亲手走一遍 Pi 的循环,看清工具怎样执行、结果怎样返回,以及 Agent 为什么还会继续。

进入执行实验室 ↓

01 / THE EXECUTION LAB

让循环走给你看。

先选一个场景,再逐步推进。
原始 Pi 循环 + 脚本模型 + 浏览器内存工具

已就绪STEP 001
都没有 →
agent_start

Agent 开始一次运行

0模型请求
0真正执行工具
0消息事件
在运行中插一句亲手比较 steer 与 follow-up 的取出时机

steering 0 · follow-up 0

事件轨迹 点击可以回看
Space 播放 / 暂停 → 单步 ← 回看所有变更都留在本次浏览器演示里。

02 / UNDER THE HOOD

界面背后,四层各司其职。

点击一层,看它持有什么状态,
又把哪部分工作交给下一层。

03 / THREE DISTINCTIONS THAT MATTER

看见“发生了”,还要分清“发生到哪了”。

01

工具完成 ≠ 结果先入上下文

并行分支的 tool_execution_end 按完成顺序发出,随后 Promise.all 的结果按原调用顺序生成 toolResult 消息。切到“并行与消息顺序”实验,分别看工具面板与消息面板。

02

工具出错 ≠ 整个 Agent 退出

找不到工具、参数校验失败、被钩子阻止或 execute 抛错,通常会转成 isError 结果。模型再决定如何补救;模型响应自身的 error / aborted 则走退出路径。

03

转向 ≠ 立刻打断当前工具

本快照的 steering 在当前工具批次结束后进入下一次请求;follow-up 要等内层自然停下。abort 是另一条取消信号路径,工具和模型适配器都需要配合。

04 / READ THE SOURCE

动画之后,回到真正的判断分支。

代码来自固定 commit,
可以对照原文件逐行阅读。

这份演示的范围

核心 runAgentLoop 保留上游控制流,仅移除 TypeScript 类型并接入教学适配器。模型、格式转换、参数校验子集和工具实现均为教学替身;AgentSession、真实 provider、权限系统、持久化与压缩在架构导读中解释,未在此完整运行。