agent-book-code Agent工作流

简介

关于本书

本书是一本从零开始构建 AI 智能体的实战教材。不依赖任何高层 Agent 框架，完全基于原始 LLM API，带领读者一步一步手写出一个具备工具调用、上下文管理、权限控制、可观测性的 AI 编程助手FunHarness。

它不是一本只展示 API 调用片段的教程，也不是一本只讲概念的 Agent 读物。本书更像一条可运行、可拆解、可复现的工程路线：先从一次最小 LLM 调用开始，理解消息、流式输出和函数调用；再逐步加入 Agent Loop、工具系统、上下文管理、记忆、权限、Hooks、多 Agent 协作与可观测性；最后把这些能力沉淀进一个完整的 mini 产品。

这也是本书与普通示例代码最大的区别：读者不是“看完一个项目”，而是跟着项目的演进过程，亲手把一个类 “Claw” AI Agent 搭出来。每一章都有对应的中间版本，每一次新增能力都能被运行、对比和修改。到最后，FunHarness 不只是代码仓库里的产物，而是读者理解 Agent 工程化之后的第一个实战作品。

[!tip] 本书的核心信念：理解 > 使用。 真正掌握 Agent 原理的最佳方式，是亲手把每一层抽象从零实现一遍。

功能更新

[!NOTE] - 2026-06-17 —— 新增学习实验室 (Study Lab) 功能 - 智能阅读与图谱双向联动：导入本地 PDF/MD/TXT 或网页快照，智能解析并生成交互式概念图谱，支持图谱与阅读文本双向绑定高亮。 - 四大核心主动学习工具：集成文档导师多轮追问、主动回忆闪卡、多维单选测验（Quiz）、费曼法对话（AI 扮演 8 岁学生启发式追问）。 - 概念动态交互可视化 (Visualizer)：将抽象概念/公式自动设计渲染为可交互组件，内置独立沙盒与错误自我修复。 - 掌握度与学习证据：多轴向追踪并记录每次学练证据，动态评估并展示各概念的掌握情况。 - 2026-06-07 —— 新增多智能体群聊功能 - Agent Groups 多智能体群聊：支持创建 Agent 角色与群组，通过 @成员 / @all 分派任务，不同成员可并行协作，并独立保存会话、运行记录和交付物。 - 工作区体验优化：改进文件树、代码预览和 Diff 展示，浏览与检查 Agent 生成内容更加直观。 - Skills 与 Web 工具增强：完善 Skills 的搜索、添加、删除和按 Agent 配置能力，同时提升 web_fetch 的网页内容提取质量。 - 稳定性修复：加强运行时工具与权限控制，修复消息处理、团队任务分派及部分工具调用问题。 - 2026-05-28 —— 新增Skills管理&web工具增强： - GUI Skills 管理：左侧导航栏「Skills」面板新增完整的 Skill 管理功能，支持搜索、添加和删除 Skills，方便在 GUI 中直接管理 Agent 技能目录，无需手动操作文件系统。 - web_fetch 工具改进：优化网页抓取工具的内容提取能力，提升 HTML 解析质量与稳定性。 - 2026-05-23 —— 新增 Swarm 多智能体协作系统： - 全新 swarm/ 模块，支持静态 DAG 任务编排 + 共享黑板（Blackboard）：多个 Agent 角色按依赖关系自动分层并发执行，Worker 之间通过黑板发布和读取共享发现，实现跨任务知识传递。 - 内置 9 套 YAML Preset 协作模板（研究、代码审查、辩论、数据分析等）一键启动；同时支持自适应组队、辩论模式、渐进式精化等高级编排，以及质量审计自动重试、动态子任务派生和跨轮学习记忆。 - FunHarness Studio 可视化：GUI 新增 Swarm 面板，以交互式 DAG 拓扑图展示任务节点状态、Agent 活动气泡、黑板消息弹窗和实时进度条；所有状态持久化到 .funharness/swarm/ 目录，可随时断点恢复或离线审查。 - 2026-05-19 —— 新增桌面宠物功能： - 左侧导航栏新增「宠物」面板，可从 Petdex 社区精选图鉴 添加像素宠物，也可上传自定义 Sprite Sheet。 - 宠物以动画形式悬浮在界面角落，根据 Agent 运行状态（启动、思考、工具调用、完成、失败、审批等）自动切换动作。 - 支持显示开关、位置（左下 / 右下）、大小（小 / 中 / 大）等偏好设置，配置持久化到工作目录 pets/ 文件夹。 - 2026-05-16 —— 新增 QQ 机器人 & 微信机器人通道： - 新增 QQ 机器人通道（基于 qqbot-agent-sdk，WebSocket 网关，支持 C2C、文件收发）。 - 新增微信机器人通道（基于 openclaw-weixin 协议，扫码登录 + getUpdates 长轮询，文本消息收发）。 - FunHarness 现已支持 飞书 / QQ / 微信 五种输入通道，共享同一套 Agent Core。 - 2026-05-06 —— TUI 能力补齐与修复： - TUI 新增附件管理、慢命令后台执行、Skills/附件专用展示；修复工具结果回调、流式元数据、Skills frontmatter 与 Web Search 展示等问题。 - 2026-05-05 —— FunHarness Studio GUI 已上线： - 提供 Electron + FastAPI 本地桌面 GUI，支持会话、工作区、附件、模型配置、Agent 面板与可观测性面板。 - 2026-04-29 —— 补充Agent Teams： - 本次更新补齐了 FunHarness 的 Agent Teams / SubAgent、持久任务系统、后台运行时与定时调度 能力，让它从单一对话助手升级为可以分工、排期、后台执行的 mini Agent 工作台。

新增功能保持 mini 项目的实现风格：核心状态都落在 .funharness/ 下，命令行、TUI 与工具调用共享同一套能力，方便学习、调试和继续裁剪扩展。

---

核心功能

---