Agent 教程
从最小 loop 到总线、记忆、Evals、Computer Use。
Agent Bus：把多 Agent 协作写成可验证的任务契约
用 Python 标准库和 SQLite 离线构建多 Agent 任务总线，明确身份、权限、版本、状态迁移、结果验收与幂等提交，附两模拟 worker、33 项测试和七张图。
Agent Loop：批量工具调用与停止控制
用 Python 标准库实现可离线复现的 Agent Loop：整批预检、call_id 结果关联、有限重试、预算、超时取消和独立验收，含完整源码、31 项测试与 7 张图。
Agent 安排预约前，先问清这个当地时间是哪一次
用 Python 标准库 zoneinfo 把人工整理的预约日期、钟面与 IANA 时区变成待确认记录。实测纽约重复与不存在时间、上海跨年和 Lord Howe 半小时切换，附完整代码和 21 项测试。
Computer Use 的观察与执行闭环
用可运行的 Python 离线状态机理解 Computer Use：截图观察、坐标与焦点、等待取消、下载验收、提示注入边界和人工批准。
Agent 读取 CSV 前，先留下一份输入证据清单
用 14 份固定合成 CSV 构建可复跑的输入 manifest，保存源文件哈希、解析约定、逻辑记录和物理行范围，并阻断表头与字段数异常。
Agent 执行多步计划前，先检查依赖图
以双资料汇总为例，在执行工具前检查整份候选计划的依赖关系，用合成完成事件观察分支就绪与失败不放行；附完整 Python 标准库源码、固定输出、测试和三张原创图。
Agent 总结 Word 前，先确定哪一份正文
用受控 DOCX 比较 python-docx 段落文本、w:t 与 delText 提取的语义差异，保留修订位置并确认总结范围。附完整源码与测试。
Agent 总结邮件前，先分清正文、附件与附带旧邮件
用 Python 标准库解析五封受控邮件，理解 alternative 与 related 正文选择，保留附件祖先、嵌套邮件头和原始字节哈希。附完整生成器、检查器和固定预期测试。
给自己的 Agent 做评估
用 Python 标准库构建离线 Agent 评估管线，核对事实、证据、工具动作范围和预算。含完整 JSONL 生成器、用量归并器、26+71项离线测试与9张图，不涉及真实模型排名或账单核验。
从 0 手写一个最小 Agent
用 Python 标准库从零完成订单库存核对 Agent，学会模型决策、工具登记、schema 校验、观察反馈、停止条件和独立验收。含完整源码、19 项离线测试、7 张图与可选 Responses API 适配器。
交给专门 Agent 前，先把上下文裁到刚好够用
用原创合成客服工单实现单次跨 Agent 上下文投影，保留任务、证据与未决问题，验证工具项和普通消息双通道遗漏；附完整代码、37 项本地测试和 3 张原创图。
Agent 总结网页前，先保住正文里的限制与披露
用合法取得的 HTML 快照生成可复核正文候选，演示明确广告剔除、tail 保留、原树 XPath、hidden 审阅与 29 项离线断言。
Agent 读取工具遇到重定向：在下一跳发送前检查授权
用 Python 3.12.14 与 HTTPX 0.28.1 的真实客户端、MockTransport 合成响应，验证精确 URL 授权、header 传播及下一跳发送前的检查。附完整源码、固定输入预期与 33 项输出。
Retry-After 要等六秒，剩余预算也只有六秒时怎么办
以 HTTPX MockTransport 和虚拟时钟复现 Retry-After 秒数、HTTP-date、共享预算、取消传播和迟到结果处理，附完整代码与独立预期。
混合检索的 RRF：把两份排名合成可解释的结果
用真实 SQLite FTS5 与明确的人工候选排名，逐项实现 RRF 融合，验证缺席、重复、过滤和窗口，附完整 Python、14 项测试与 3 张图。
给 Agent 接上可回查的本地资料检索
从六份原创合成资料建立可运行的 SQLite FTS5 索引，返回原文、行号与版本化来源，验证中文分词边界、冲突资料、更新、删除和不命中。含完整 Python 代码与十三项离线测试。
收到变更后 Agent 如何行动
从合成文档评论出发，验证事件回读、任务路由、授权范围、人工审核、幂等提交与取消监控。附 Python 标准库离线例子、32 项测试和六张流程图。
Agent 记忆：从记录到纠正与删除
用 Python 标准库和 SQLite 构建可审核的 Agent 事实记忆，区分上下文、任务进度与文档检索，验证版本纠正、TTL、软删除和租户隔离，附完整代码、24 项测试与七张图。
多 Agent 消息协作与重启恢复
用 Python 标准库和 SQLite 离线构建可恢复的多 Agent 消息队列，覆盖收件与完成确认、稳定回复 ID、outbox、租约竞争、重启补收、取消与有界重试，附完整测试和八张图。
Agent 接收 OCR 前，先保留原图、词框和未复核状态
用两张原创英文订单图片实际运行 Tesseract，保留原始 TSV、图像哈希与词框，检查高分误读，并为人工复核留下独立记录。含完整可运行源码。
Agent 读 PDF 前，先保住页码、双栏顺序和表格位置
用四页原创合成 PDF 实测物理页与标签、双栏阅读顺序、词框和表格单元格坐标，以及纯图页空提取。附完整生成器、提取器、10 项测试和三张原创图。
工具参数的 JSON Schema 通过了，为什么运行时仍要拒绝？
真实运行 Pydantic 2.13.4，以只读导出时间窗验证 strict 输入、跨字段约束和序列化，附20组输入、30项测试及完整源码。
Python 交给 Node 的引用位置，怎样避免截出半个 emoji
用真实 Python 与 Node 进程复现引用下标错位，以固定 20 条夹具验证 UTF-8 字节区间、源哈希和 Unicode 严格解码，并完成双向重算回验。
Python 交给 Node 的 JSON，怎样保住编号与整数合同
用四字段扁平协议验证 Python 与 Node 原生进程互通，保留长编号与数字写法，拒绝重复键，附完整源码、27 条原始夹具及双向回归。
从检索排名到 Recall 和 MRR：写一个口径固定的离线评分器
用六份虚构文档、五条中文查询与三十个明确标签，离线实现 Recall@k 和 MRR@k，检查缺失排名、重复文档和未判断标签，附完整源码、预期结果与十八项测试。
给 Agent 的 SQLite 报表工具划定只读边界
用合成临时数据库验证 mode=ro 的边界，构建只接受业务参数的 SQLite 报表工具，并用 23 项测试检查表列权限、函数与执行预算。
流式 Agent 的进度显示，什么时候才能写完成
用原创 Python 事件 reducer 和 30 组离线夹具，区分文本片段、工具返回、运行终态与应用验收，覆盖重复、未知事件、跨 run 混流与取消竞争。
把一批自由文本变成可验收的结构化记录
用五条合成报修和41项离线测试，检查结构化结果的批次归属、来源ID、原文证据、拒绝与截断；附完整Python代码和3张原创SVG。
给 Agent 包装 CLI：为什么外层 try/catch 没接住 stdin EPIPE？
用 Node 标准库门控子进程复现 stdin EPIPE，保留退出码与 stderr，验证完整 UTF-8 输入，附四个完整文件、67 次隔离运行和两种错误修复负控。
同步工具超时后，后台线程为什么还在跑
用 Python 3.12 真实线程实验区分等待超时、worker 寿命和结果有效期，验证协作停止、资源关闭、专用池排队取消与旧结果拒绝。附完整标准库源码、独立预期、6 项测试和三张原创图。
给 Agent 工具加一份可撤销的单次审批
用 SQLite 实现只批准确切参数的 Agent 工具许可，验证期限、撤销、重启、重复消费与事务回滚，附完整源码、33项离线测试和3张原创图。
工具检查拦在了哪一步：把 Guardrail 和副作用排到同一条时间线上
以固定 Agents SDK v0.23.1 文档源码说明护栏时序，用原创 SQLite 离线账本验证输出拒绝、取消与异常后的效果，附完整源码、44 项测试和 3 张原创图。
排查 Agent 失败时，怎样留下不泄漏正文的追踪
用合成 trace 和 Python 标准库实现字段白名单投影、局部 ID 映射、异常与 URL 裁剪、整批失败复核，附完整源码、40项离线测试和3张原创SVG。
Agent 读 Excel 前，先分清公式、缓存和可见范围
用两份原创 XLSX 实测 openpyxl 对公式缓存、隐藏行、veryHidden 工作表、数字格式与日期系统的读取。完整生成器、检查器、11 项测试及三张原创图。
ZIP 附件交给 Agent 前，先列清单再选成员
Python 标准库 ZIP 附件选材教程：重复名称、路径规范化、Unicode extra、声明预算与流读限额，含完整离线代码、固定输出和三张原创图。