波仔
🐦 第1章 智能体概述
📄 一句话概括

入局有三条路：在平台上拖、调接口写代码、做成给别人用的产品。三条路的门槛差一个数量级， 天花板也差一个数量级。 教材走的是第一条，所以全书十五章都在教你点哪儿。 但第一条有天花板，知道天花板在哪，才知道什么时候该换路。

📝 本章和前面几章的关系

前面三节讲的是「是什么、为什么、能干什么」，这一节讲「怎么开始」。 这一节也是全书的读法说明：哪些章要精读，哪些章可以当手册查。 如果你只是想给自己做个工具，读完这一节就可以直接跳到第 2 章动手。

一、三条路，先看门槛

第一条，在平台上拖。 要会的是打字和一点逻辑感。半天能出第一个能用的东西。 扣子、Coze、Dify 都是这条路，教材用的扣子。 第二条，调接口写代码。 要会一门语言。两周能出第一个能用的。 好处是想改哪层改哪层，坏处是每一层都得自己搭。 第三条，做成给别人用的产品。 要会开发，还要会运营：计费、权限、客服、合规。 三个月起步，还得有人一起干。

这三条不是高低之分，是三种活。第一条做的是「工具」，第二条做的是「系统」，第三条做的是「生意」。

二、第一条路的天花板

平台不给你改的那一层，你再会写代码也伸不进去。具体是三层。 模型调用那一层。 平台用什么模型、怎么拼提示词、上下文怎么截断，多半是黑盒。 你能选模型，但改不了它怎么把你的输入送进去。 运行环境那一层。 想装个冷门依赖、想连内网数据库、想跑超过一分钟的任务，平台不一定允许。

数据出口那一层。 数据存在平台上，导出、迁移、删除的规则得按平台的来。 这一条在 to B 项目里经常是决定性的。 所以选路之前先问一句：这个项目最终要交给谁、数据能不能放在别人机器上。问完再选， 比先做后搬省事得多。

三、一个最小骨架

不管走哪条路，底下那个骨架是一样的。演示里三十行不到，做了三件事。 一张工具表：名字对上一个函数。一个「还差什么」的判断：缺天气就先查，缺建议就再算。 一个「齐了就停」的条件。 真机上「还差什么」是模型判断的，这里换成了两个 if。 换掉的只是判断那一步，工具、循环、停止条件一样不少。

能把这三十行讲清楚，后面九章的案例你就都能读懂了——它们只是节点更多、工具更贵、提示词更长。 反过来说，讲不清这三十行，抄再多案例也只是抄。换个题材就抓瞎。

四、这本书怎么读

第 1 到 3 章是概念和零件：什么是 Agent、平台有什么、插件和卡片怎么用。要精读。 第 4 到 6 章是三大件：工作流、知识库、提示词。 要精读，而且要做笔记。后面九个案例全是这三样换个组合。 第 7 章是数据库，第 8 到 16 章是九个案例。可以当手册查。

读案例有个窍门：别看它做了什么题材，看它把一件事拆成了几步、每步交给谁。题材会过时，拆法不会。 九个案例拆完你会发现，最常出现的组合只有四个：开始 → 大模型 → 结束；开始 → 插件 → 大模型 → 结束； 开始 → 知识库 → 大模型 → 结束；开始 → 意图识别 → 分岔 → 合流 → 结束。 把这四个背下来，再看新需求，你脑子里会自动浮出一张图。这就是本书真正要教的东西。

五、动手 Demo：三条路与三十行骨架

先列三条路的门槛与天花板，再看一个真能跑的最小 Agent：查天气，决定穿什么。

TOOLS = {'查天气': get_weather, '给建议': pick_clothes}

state = {}
for turn in range(1, 5):
    if 'temp' not in state:                 # 还差天气
        state.update(TOOLS['查天气']())
    elif 'advice' not in state:             # 还差建议
        state['advice'] = TOOLS['给建议'](state)
    else:                                   # 齐了
        break

实跑输出：

--------------------------------------------------------------------
三条入局路与一个最小骨架
--------------------------------------------------------------------


  ① 三条路，门槛与天花板
  --------------------------------------------------------------------

| 路 | 要会什么 | 第一个能用的 | 能改多深 | 出问题找谁 |
|---|---|---|---|---|
| 在平台上拖 | 会打字 | 半天 | 到平台的边界为止 | 平台 |
| 调接口写代码 | 会一门语言 | 两周 | 想改哪层改哪层 | 自己 |
| 做成给别人用的产品 | 会开发 + 会运营 | 三个月起 | 取决于团队 | 自己 + 客户 |

  这三条不是高低之分，是三种活。教材选的是第一条，所以全书大部分章节都在拖和点。
  但第一条也有天花板：平台不给你改的那一层，你再会写代码也伸不进去。

  ② 三十行的最小 Agent：查天气，决定穿什么
  --------------------------------------------------------------------

| 轮 | 动作 | 结果 |
|---:|---|---|
| 1 | 查天气 | 气温 9 度，有雨 |
| 2 | 给建议 | 厚外套 + 带伞 |
| 3 | 停 | 目标达成：厚外套 + 带伞 |

  整段只有三件事：一张工具表、一个「还差什么」的判断、一个「够了就停」的条件。
  真机上「还差什么」是模型判断的，这里换成了两个 if——
  换掉的只是判断那一步，工具、循环、停止条件一样不少。
  ! 把这三件事写出来，你已经能读懂全书九章的案例：它们只是节点更多、工具更贵。

①三条路那一行里，「能改多深」这一列才是选路的真正依据。如果你永远只做自用工具，第一条就够； 如果要交给客户，第三层（数据出口）早晚会卡你。 ②注意「出问题找谁」这一列：第一条找平台，第二三条找自己。 这也是很多团队做了三个月才发现的事——平台一改接口，你的东西就得跟着改。 ③三十行那一段只有三件事：工具表、判断、停止条件。 没有模型、没有提示词，照样是个 Agent——因为它确实在「朝目标自己决定下一步」。 ④真机上那个 if 换成模型之后，代码更短，行为更不确定。 这就是引入模型的代价：灵活度上去了，可预测性下来了。 ⑤最后那句「只是节点更多、工具更贵」不是安慰。第 8 到 16 章那九个案例，骨架跟这三十行一模一样。

30 秒实验

  1. 给你手上这件事选一条路，写下选择理由里最硬的那一条（通常是数据能不能出门）。
  2. 把三十行骨架里的「查天气」换成你行业里的一个查询，跑通它。
  3. 把你读到过的一个案例拆成「几步、每步交给谁」，看能不能归到那四个常见组合里。

常见误区

  1. 「先做出来再想交给谁。」交付对象决定了选哪条路，选完再改，等于重做。
  2. 「平台做的东西不算真本事。」工具就是工具。 半天做出来解决同事一周的重复劳动，比写一个月代码没人用强。
  3. 「案例照着抄就行。」抄的是节点位置，学不到的是「为什么这里要拆成两步」。换个题材就露馅。
自测三问（点开对答案） 1. 三条路里，选哪条的第一判据是什么？ —— 数据能不能放在别人机器上、最终交给谁。这一条通常一票决定。 2. 平台这条路的三层天花板是哪三层？ —— 模型调用层、运行环境层、数据出口层。to B 项目最常被第三层卡住。 3. 九个案例里最常见的工作流组合有哪四个？ —— 直连大模型、插件加大模型、知识库加大模型、意图识别分岔再合流。

路线选完，该动手了。 下一章进扣子平台：它把哪几样东西摆在一张桌子上，以及一个完全不懂编程的人， 怎么在半天里做出第一个能发到公众号的智能体。

相关笔记