异步 Agent Loop 分享

这次内部分享用一个逐步扩展的小 Agent 讲解同步和异步工具调用。

术语

主讲稿 供讲者现场投屏、按分享大纲手动翻页的网页。讲解页承载现状、原理和核心代码，演示页可在原地操作并观察运行。

演示页 同屏展示核心代码和实际运行的主讲稿页面。每页对应一个可运行的核心实现，讲者可在页内独立启动、操作和重跑。

现场演示 讲者在演示页启动并操作的一次 Agent 运行。它发起真实模型请求，展示模型请求、工具执行和用户输入在这次运行中的先后关系。

运行轨迹 一次现场演示中实际发生的模型请求与返回、工具执行、收件箱投递和网页答复的有序记录。讲者可以从关键事件查看对应的请求体或工具输入输出。

核心代码 从现场演示所运行的源码中摘出的片段。首次讲解展示完整的小循环，后续片段对应各页演示的行为变化。

基础工具 本次周报 Agent 用于搜索、读取、写入和执行命令的 grep、read、write 和 bash。

后台任务 由 Agent 发起、可以独立于当前工具调用继续运行的工作。工具可以先返回回执，任务的结果随后交回会话。

周报工作目录 现场演示开始时为空的仓库，供 Agent 生成本周周报。工作证据来自其他研发仓库。

会话线索 本周有活动的 Agent 会话及其工作目录，用于发现可能相关的研发仓库。

候选工作项 Agent 从跨仓库的提交和其他可核对证据中归纳出的本周工作进展，由讲者决定是否写进周报。已有可核对产出的调研、设计或原型也可以入选。

周报决策 讲者提供的下周优先事项，以及对本周候选工作项的取舍。Agent 在开始收集时征询前者，归纳出候选工作项后征询后者。