结构化输出与 Function Calling
Lv2 支线课。接着《Prompt 工程》的留言分拣助手往下做:把「a|b|c」换成 JSON,用代码校验它,再让模型调用你写的函数,把待办直接记进系统。
《Prompt 工程》的分拣助手用的是手写格式:每行「编号|类别|理由|回复」。它能用,但有几个绕不过去的坎:回复里一出现竖线就切错列;字段一多,一行挤成六栏;程序拿到的只是一串字,还得自己拆、自己查对不对。
这门课把它换成程序真正好用的形式。还是同一套测试留言,再加一条专门捣乱的:「Markdown 表格里想写一个竖线 | 怎么办?」。每一步都用 DeepSeek 真实跑,数字和输出都是实测。
🧩 这门课解决什么问题
| 卡在哪 | 这门课怎么解 |
|---|---|
| 切错列 「回复里有个 |,整行就乱了」 | 第 1 章:换成 JSON,内容里有什么符号都不怕 |
| 形状乱 「说了要 JSON,每次给的字段都不一样」 | 第 2 章:JSON 模式只保证「是 JSON」,字段要你约定 |
| 不敢信 「它说的类别会不会不在清单里?」 | 第 3 章:用 Pydantic 校验,不合格把报错发回去让它改 |
| 还得拆 「输出一大段,程序还得自己解析成待办」 | 第 4 章:Function Calling,让它直接调用你的函数 |
🗺️ 学习路线图
| 阶段 | 学到哪一步 |
|---|---|
| 📗 拿得到 第 1 ~ 2 章 | 输出改成 JSON;分清 JSON 模式管什么、不管什么 |
| 📘 信得过 第 3 ~ 4 章 | 用代码校验每一个字段;让模型调用函数,查资料或记待办 |
| 📕 接得上 第 5 章 | 分拣助手 JSON 版:处理单加一份程序能直接用的待办 JSON |
📚 章节导航
| # | 章节 | 难度 | 预计阅读 | 分拣助手新增的能力 |
|---|---|---|---|---|
| 1 | 手写格式撑不住了 | ⭐ | 10 min | 回复里有竖线也不会切错列 |
| 2 | JSON 模式管什么、不管什么 | ⭐⭐ | 10 min | 每次都是同一个形状、同一套字段名 |
| 3 | 别直接信它给的 JSON | ⭐⭐ | 12 min | 类别不在清单里、少了字段,程序当场拦下 |
| 4 | Function Calling:让它调用你的函数 | ⭐⭐⭐ | 12 min | 纠错直接建成核对任务,建议直接记进选题池 |
| 5 | 综合实战:分拣助手 JSON 版 | ⭐⭐⭐ | 15 min | 一个脚本跑完三步,输出处理单和待办 JSON |
🎯 适合人群
| 你是 | 从哪开始 | 建议 |
|---|---|---|
| 学完《Prompt 工程》和《大模型 API 调用》 | 第 1 章 | 按顺序读,代码都能直接跑 |
| 只想知道 Function Calling 是什么 | 先读《AI Agent 科普》第 2 章,再看本课第 4 章 | 前者讲原理,后者讲怎么写 |
| 已经在用 JSON 输出,偶尔出错 | 第 2、3 章 | 字段约定和校验,是最常见的两个漏洞 |
前置知识:《大模型 API 调用》第 1~3 章(会用 Python 调 DeepSeek);《Prompt 工程》第 1~7 章(知道分拣助手是什么)。本课全程写代码,没有网页版的做法。
📂 目录结构
function-calling/
├── README.md # 本页
├── chapters/ # 5 个章节
│ ├── 01-why-json.md
│ ├── ...
│ └── 05-sorter-json.md
└── images/ # 配图(SVG)💡 提示:用到的测试留言、标准答案、常见问题清单,都和《Prompt 工程》一样,在那门课的第 1、7 章里可以复制。