引导一次运行而不打断它
观察一个缓慢的轮次:引导消息落在哪里、后续跟进消息何时到达,以及 clearQueue 如何返回 Escape 会恢复到编辑器里的内容。
在 Pi 工作时键入并不是一次打断:一条引导消息在当前轮次的工具调用之后、下一个请求之前进入,一条后续跟进消息等到智能体否则就要停下来时才进入,而 Escape 会中止并把你排队的文本还给你。下面的演练镜像了 1.0.4 上的 ch25-queue/queue.test.ts,后者把消息排进一个真实会话,这个会话运行在一个刻意缓慢的工具下,使用一个脚本化的 provider。
时间线
turn 1 提示词 "start"
模型请求那个缓慢的工具;它的工具调用运行
你键入 steer "change direction" → 已排队,模型还读不到它
turn_end 最后一个工具结果之后
下一个请求 system | user:start | assistant | toolResult | user:change direction
turn 2 模型回答这个纠正
更早排队的一条后续跟进消息仍在等待
agent_settled 没有未完成的事项 → 后续跟进消息终于被交付中间那个请求形状正是测试所断言的内容:引导消息落在工具结果之后、下一个提示词之前(测试里的 shape() 省略了系统消息)。有一个顺序你从按键上看不出来:引导消息先于后续跟进消息排空,即使后续跟进消息先排队也一样。
交付规则
| 事件 | 会发生什么 |
|---|---|
一次轮次运行期间调用 steer() |
落在该轮次的工具调用之后、下一个请求之前 |
调用 followUp() |
只有在没有工具调用或引导消息剩下时才交付 |
流式输出期间的 prompt,没有 streamingBehavior |
被拒绝——一个错误,而不是一次猜测 |
流式输出期间的扩展命令(/status) |
立即运行;同样的文本被引导则会被拒绝 |
queue_update 每次都带着完整的队列,而不是增量——测试断言第二次更新仍列出第一条消息,而最后一次更新是空的。steeringMode 和 followUpMode 都默认 "one-at-a-time",即每轮交付一条引导消息;"all" 则一次交付所有排队的消息。
Escape 把你的文本还给你
clearQueue() 返回排队的文本——测试观察到 { steering: ["S1"], followUp: ["F1"] }——这就是一个客户端会恢复到它的编辑器里的内容,并且 pendingMessageCount 降到零。要复现 Escape,请在 abort 之前发送 clear_queue,好让这次运行在没有任何待处理项的情况下停止。
机制与局限
有文档记载: 两个交付点、模式设置、queue_update,以及先 clear_queue 再 abort 的顺序,这些都是 1.0.4 上有文档记载的 RPC/SDK 行为。已观察:queue.test.ts 通过一个真实会话对上面每一行做出断言——包括精确的 ["user:start","assistant","toolResult","user:change direction"] 形状、一次一条与 all 的交付对比、完整队列的更新,以及那个在流式输出期间运行的扩展命令。
这里的一切都是关于一条消息何时被交付,而不是模型是否接受它:provider 是一个脚本化的 faux,所以本页没有任何东西展示一个真实模型服从一条引导指令。而边界是 agent_settled,不是 agent_end——重试、压缩恢复和排队的工作仍可能跟随在 agent_end 之后,这个区别本身并未被这个队列示例演练。
完整源码与测试 。
Understand this example
Copy this prompt into your AI tool. No code runs here.
Apply this example
Copy this prompt into your AI tool. No code runs here.