章节摘要:本章是全书动手量最大的一章。从装环境、配密钥开始,一步步搭出基本智能体,再给它加工具(能联网)、挂知识库(会查资料)、组团队(能分工),最后串起高级功能实战。学完本章,你能独立交付一个"带工具 + 带知识库"的可用智能体。
阅读完本章,你应当能够:
一句话记住本章:构建智能体是"叠积木"——先搭出会说话的 Agent,再一块块加工具、知识、协作能力,每加一块就跑一次验证。

安装 Agno、配置 API 密钥、验证环境,跑通第一个智能体。
Agent 的核心参数、角色设定与结构化输出,做出"会按你的规矩说话"的智能体。
工具是什么、怎么挂载,让智能体从"会说"变成"会做"。
向量库、知识导入、RAG 问答,让智能体回答它没学过的内容。
Team 的构建、成员分工与协作模式,处理单智能体搞不定的复杂任务。
流式输出、会话持久化、结构化响应等能力综合实战。
环境(2.1) → 说话(2.2) → 动手(2.3) → 有知识(2.4) → 组队(2.5) → 综合(2.6) 地基 骨架 手脚 外脑 组织 验收
六节是严格的递进关系,每节在前一节成果上加一块能力。跟着顺序做,每一步都有可运行的验证点。
| 小节 | 动手任务 | 完成标志 |
|---|---|---|
| 2.1 环境搭建 | 装好框架与依赖,跑通最小问答 | 一次成功往返 |
| 2.2 基本智能体 | 建成 Level 0 与 Level 1 各一个 | 工具调用可见 |
| 2.3 工具智能体 | 复现搜索与金融两类问答 | 结果带来源 |
| 2.4 知识库智能体 | 用一份 PDF 建库并问答 | ingest 只跑一次 |
| 2.5 协作团队 | 组一个双成员团队 | 队长正确分流 |
| 2.6 高级功能 | 验证记忆与结构化输出 | 两轮对话记住名字 |
强烈建议。六节是一条施工线:环境、裸智能体、工具、知识库、团队、高级功能,每一节都以前一节的成果为起点。跳到 2.5 的人几乎都会回来补 2.4。
统计意义上的答案是 2.4:ingest 的耗时、切块的粒度、检索的质量,三个环节都可能有意外。预留充足时间,并按小节的排错表逐项对照。
一条完整的智能体生产线:从零开始,搭出能联网、能查私有文档、能分工协作的智能体系统。第 3 章的进阶特性,都是在这条生产线上做深加工。
教学上有意把本章做成纯施工:概念留到第 1 章讲透,进阶留到第 3 章展开,本章只解决"从想法到能跑的系统"。这个安排源于一个观察:智能体学习最大的流失点在"读完理论仍写不出第一个能用的东西"。连续六个动手任务层层递进,每个任务都能在一个坐姿内完成并看到产出,用即时反馈对冲学习曲线的挫败感。
施工中养成的小习惯——每完成一节就做一处自己的改动——比任务本身更重要。照抄得到的是代码,改动逼出来的是理解:把金融工具换成搜索工具会发生什么?指令改成英文效果如何?这些一分钟的小实验,才是把教程知识转化为个人能力的真正通道。
每节的排错表与常见问题就是为卡住的时刻准备的。仍无解时,退回上一节的最小可用版本(比如知识库出错就退回工具智能体),确认基础链路健康再逐项加回配置——二分定位法在智能体开发里同样好使。记住卡住是常态而非事故,每个报错都是框架在向你解释它自己的运行方式,读懂一次,受用一路。
还有一句话写给完美主义者:六个任务不必做到满分才进下一章,每节"能跑加一处自己的改动"就够。深度是在后面章节回炉时自然长出来的,施工阶段卡在某一节追求完美,反而会耗尽宝贵的行动能量。完成优于完美,尤其是在学手艺这件事上。
三条标志帮你确认本章真正毕业:其一,不看教程能从空目录搭出带工具的智能体;其二,能向别人解释 ingest 为什么只跑一次、记忆与会话的区别;其三,你的评估意识已经萌芽——改任何配置前会先想"我拿什么验证改对了"。三条齐了,第 3 章的进阶内容对你就是水到渠成的展开,而不是新的负担。