第4章 武器库：功能特性详解
文档摘要
第 4 章 · 武器库：功能特性详解 本章要回答的三个问题：开箱自带的动作集能覆盖哪些操作，边界在哪里？怎么把"页面上的信息"变成"带字段约束的结构化数据"，而不是一堆要人整理的碎文本？内置动作不够用的时候，怎么给智能体注册自己的武器，顺便把危险操作拦在人工闸门后面？ 为什么会有这一章 第 3 章立好了坐标系：观察、决策、动作、复核。本章把武器一件件摆上桌，每件都标明它作用于哪一拍。为什么不按"API 列表"的顺序讲？因为武器离了战役没有意义——你不需要背出全部方法名，你需要知道打哪类仗该领哪件武器。基础动作集是日常巡逻用的制式装备；结构化提取是观察拍的高级形态，把"看见"升级成"记录在案"；自定义动作是军械库的扩容权，也是给复核拍加程序化闸门的入口。
第 4 章 · 武器库：功能特性详解
本章要回答的三个问题：开箱自带的动作集能覆盖哪些操作，边界在哪里？怎么把"页面上的信息"变成"带字段约束的结构化数据"，而不是一堆要人整理的碎文本？内置动作不够用的时候，怎么给智能体注册自己的武器，顺便把危险操作拦在人工闸门后面？
为什么会有这一章
第 3 章立好了坐标系：观察、决策、动作、复核。本章把武器一件件摆上桌，每件都标明它作用于哪一拍。为什么不按"API 列表"的顺序讲？因为武器离了战役没有意义——你不需要背出全部方法名，你需要知道打哪类仗该领哪件武器。基础动作集是日常巡逻用的制式装备；结构化提取是观察拍的高级形态，把"看见"升级成"记录在案"；自定义动作是军械库的扩容权，也是给复核拍加程序化闸门的入口。
先泼一点冷水建立预期：武器库这一章最容易被读成"功能大全"。请克制住收藏夹式读法——每节末尾的取舍段才是重点：什么时候用、什么时候别用、代价是什么。命令台的纪律从来不是装备越多越好，而是每件装备知道自己的适用射程。
命令台第四课：领装备先问射程，再问威力。
读完能解决什么
- 拿到一类页面操作，能立刻说出它属于哪件内置武器，以及参数怎么给才不容易被模型理解偏；
- 把一个"从页面拿数据"的需求写成 Pydantic 字段模型，让智能体直接产出可入库的 JSON，并处理翻页续取；
- 为业务专属操作（查询内部接口、格式校验、高危确认）注册自定义动作，知道安全边界画在哪；
- 面对"内置加自定义都覆盖不了"的场景，能给出组合方案而不是硬塞一个别扭的实现。
各节怎么分工
| 节号 | 回答哪个问题 | 关键产出 |
|---|---|---|
| 4.1 基础动作集 | 制式装备有哪些、怎么喂参数 | 动作分类图、任务单写法对照、参数表 |
| 4.2 数据提取与结构化输出 | 碎文本怎么变结构化数据 | Pydantic 模板、提取代码、翻页续取 |
| 4.3 自定义动作与扩展 | 武器不够用怎么办 | 注册代码、参数模型、危险闸门示例 |
三节由浅入深也是由"纯用"到"改造"：4.1 只当使用者，4.2 开始写数据模型，4.3 直接给军械库添货。读完本章，你在第 5 章的三个战役里会把三节的东西全部用一遍。
先决条件
- 第 2 章环境可用，第 3 章的"拍"的坐标系在脑子里挂着——各节会直接引用"观察拍""决策空间"这些词；
- 4.2 需要一点 Pydantic 常识（会定义字段类型即可，不需要深入）；
- 4.3 需要能读懂普通 Python 函数定义，装饰器语法会现场解释。
三件武器的组合逻辑
单件武器各有射程，组合起来才有战役。常见的三种组合值得预演：提取加拆解（4.2 的字段合同配上 3.3 的粒度拆解），解决多页多品的批量取证；动作加闸门（4.1 的基础动作配上 4.3 的人工确认），解决流程类任务的最后一厘米；裁剪加点名（收窄动作空间加任务单里点名装备），对付模型滥用武器的走火场景。第 5 章的三场实战正好各占一种组合——比价役是第一种，助手役是第二种，巡检役三种都用。读武器章时带着这张组合表，到第 5 章你会处处见到熟人。
往下走到哪
武器领完就上战场。第 5 章三个完整战役——电商比价聚合、在线服务助手、页面巡检监控——每一个都是本章某几件武器的主场。届时你会看到"武器组合"的写法：一个任务里提取与动作交替出现、自定义闸门卡在敏感步骤前面。如果读完本章感觉哪件武器"知道存在但不会用"，直接翻到第 5 章对应战役看它的实战形态，往往一点就通。