先说背景：为什么这件事值得记一笔
团队里想把大模型接进业务，第一个被问到的问题几乎都是"它能不能查最新的数据"。训练数据有截止日期，问它今天的事，它要么拒答，要么拿旧知识硬答。我们内部工具第一周就撞上了：问当天天气，九秒回一句"我无法提供实时天气数据，因为我的知识库没有联网更新功能"，后面附三条让我们自己去查的建议。
常见的补法是自己在应用层接一套检索：选检索服务、写调用、把结果拼进上下文、再处理多轮。这条路能走通，但每一环都是自己的代码，每一环都要维护，而且多轮检索的编排逻辑会长在应用里。我们内部粗估过这条路的账：选服务加写调用和重试是一周起步，之后检索服务每改一次接口都要跟着改一次，这部分成本不会出现在立项表里，但会一直出现在排期里。
阿里云百炼把这件事做成了模型侧的工具。命令行里多写一个参数，搜索和网页抓取由服务端执行，应用层不持有任何检索逻辑。我 10 月 27 号把这条链路完整跑了一遍，读数都留了痕，版本 2.5.0。
基线：不带工具时模型怎么答
bl text chat --message "今天上海天气怎么样" --timeout 120 --max-tokens 400
9.2 秒返回，内容是一句拒答加三条自查建议。这一步是留对照用的：后面所有差别都只来自联网工具那一个参数。
顺带一个英文语境的同形对照，更能说明问题：不带工具问"今天西雅图天气、并报出你所指的日期"，模型先说没有实时数据，然后报的日期是 2026 年 6 月 16 日，而那天实际是 10 月 27 日。加上工具后日期自己就对了。所以"不能联网"和"知道自己不能联网"是两回事，后者才是要解决的。
开启联网：一个参数
bl text chat --api responses --tool '{"type":"web_search"}' --message "今天上海天气怎么样" --timeout 120 --max-tokens 400
官方文档对开启方式的描述只有一句：通过 tools 参数添加 web_search 工具即可启用联网搜索。没有配置文件，没有要先启动的服务。
24.5 秒返回当天实况：多云到阴，气温约 15 到 20 度（实况最高 23.4 度、最低 17.7 度），北风小于 3 级，湿度约 70 到 80 成，空气质量良。表头日期模型自己写对：2026 年 10 月 27 日，周二。
网页抓取：第二个工具
--tool 可重复传。加 {"type":"web_extractor"} 后模型能打开网页读正文。我让它读官方文档的联网搜索页并把参数念回来，74 秒返回，它自称已打开并阅读该页，列出的四种搜索策略名称与默认值，我事后逐字对过文档，一致。
这里有一个架构上值得注意的点：网址、关键词、读取页数我都没有指定。检索轮次与抓取目标由模型自行决定，应用层只声明"允许使用哪些工具"。这把多轮检索的编排从应用代码里移了出去，也意味着应用侧不再需要维护"查几次、查什么"的循环逻辑。
可审计性：调用次数写在输出里
把输出换成 json，output 数组逐条给出类型。我那次共十条：四条思考、两次搜索调用、三次网页抓取调用、一条最终回答。usage 里的工具计数字段写着 web_search 两次、web_extractor 三次，与逐条计数一致。
对要进生产流程的团队，这一点比"模型说它搜了"重要得多：工具调用次数是可核对的字段，可以进监控和断言。思考摘要同样可读，第一条是"我没有实时天气数据，所以我应该去搜"，后面一条是"不同来源给的数据略有出入，国家气象中心说的是某个值"。它在对账，这个行为本身也是可以观察的。
进生产前要知道的三件事
一是延迟。我这几个读数在 17 秒到 127 秒之间，不联网的对照是 9 秒到 14 秒。多轮检索的问题更慢：我问"上个月新上架了哪些模型"，带 300 秒超时跑了 205 秒，且因为输出上限设 800，只拿到过程叙述没拿到结论。超时与输出上限都要按问题复杂度给足，同步接口要按这个量级设超时。
二是上下文体积。联网那次输入 22789 个 token（其中 10752 命中缓存），输出 1225 个，合计 24014。检索回来的网页正文全部进上下文，容量规划要按带检索的峰值算，不能按裸对话算。
三是策略与收费。官方文档把搜索策略分四档，turbo 为默认，agent 与 agent_max 两档标注"启用该策略时，每次调用额外收费"。命令行没有选策略的参数，我这些调用走的都是接口默认；多轮搜索与抓取是工具自身行为，不等于显式开了某档。数额以官方文档为准，采购评估时单独核。
另一条路
需要自己控制检索内容时，用 bl search web，只检索不总结，2.3 秒返回带标题、摘要、链接的结果列表；--count 可指定条数，不指定给五条（帮助文档写的默认十与实际不符，按五规划）。它是上限不是保证，冷僻查询要二十条可能只回三条，分页逻辑别假设能拿满。
想先看控制台，去阿里云百炼控制台。整条验证链路我没有创建任何云资源，也没有改动任何既有配置。
