←AI 实践笔记

Lesson 03 · 模型 / 代码 / 文字

这个行为
是谁定的

分身做了一件事——对的或错的。先别问「怎么改」,先问「这是谁定的」。 答错这一步,改的地方就会错。这一课练的就是这一步。

先回忆一下(两周前的)

TOOLS 那份声明,和 run_bash 那个函数,靠什么连在一起?

只靠名字。声明里 "name": "bash",回来的块里 block.name == "bash", 你的代码拿这个名字去查该调哪个函数。声明和实现在代码层面零联系。 忘了的话回 第 1 课 看那张四条报文的图。

一次回复里,有两个干活的和一条接缝

代码 你的 26,000 行 循环、执行、准入 回填、超时、去重 确定的: 同样输入同样输出 错了 → 能复现 文字 唯一的接缝 系统提示词 工具描述、参数描述 工具结果 模型读到的全部 改它 = 改行为 模型 DeepSeek,云端 调不调、调哪个 参数填什么、说什么 概率的: 时对时错 你改不了它本身

代码和模型互相碰不到。代码把文字发过去,模型读文字、填表、回文字,代码再拿文字去干活。 所以任何一个行为,追到底只会落在三处之一。

能稳定复现的

去代码里找。同一句话发十次都一样错,那不是模型在犹豫,是某行代码在执行它写好的规则。

时对时错的

去文字里找。模型本身你改不了,你能改的只有它读到的东西——哪句话没写、哪句话被另一句压住了。

第三种:文字没覆盖到、模型自己拿的主意。这种要先判断该不该由它拿主意——该,就不动;不该,就补一句文字把它按住。 这也是 ADR-0009 删掉 1300 行意图分类器的理由:模型本来就会选,用规则再造一个更弱的选择层,是把第三种硬改成第一种。

练:下面每件事,是谁定的

全是你分身里真实发生过或代码里写死的事。选完看解释,解释里有文件位置。

一轮问了三个城市,只查了两个,第三个回「一次问的城市太多了,这个没查」。

deepseek_transport.py _answer_tool_calls():len(answered) >= MAX_CITIES_PER_TURN。模型提了三个请求,第三个是你的代码拒的。每次都会这样,能复现。

有人没提城市,它填了「杭州」。

weather.py:165 参数描述:「没有提到城市时用「杭州」」。这句话去掉,模型会空着或者自己编一个——weather.py:148 注释里写着原型 7/7 传对城市靠的就是它。

天气接口超时了,群里收到的是「查询失败」,而不是分身沉默或崩溃。

weather.py look_up() 的 docstring 第一句:「**不抛异常。**」接口要求每个 tool_call 都有一条对应结果,抛出去整轮就废了。这是你代码里的兜底,跟模型无关。

有人在群里叹了句「这鬼天气」,它没查天气,直接接了句话。

工具描述列的触发场景是「冷热、下雨、穿什么、带伞、出门」,一句感叹不在里面也不在外面——文字没覆盖到,是模型自己判断这不是在问天气。该不该由它判断?多半该。不该的话,补一句文字,不是加规则。

查完天气后,模型又想再调一次工具,被当成无效重试拒了。

_ask_until_usable(..., allow_tool_calls=False)。模型想继续,是你的代码把 while True 按成了一次。这是对照地图里那格「租的」的具体位置。

去掉 TOOL_HINT 那句话之后,七句该查天气的漏了三句。

weather.py:63:「这句话是承重的,不是文档。」代码一行没动,模型也没换,只少了一句话,行为就变了。这是你自己测出来的数据——文字定的行为,最干净的证据。

顺手把 Claude Code 也放进同一张表

代码文字模型
Claude Code本机那个 189 MB 的 claude.exe系统提示词 + 几十条工具描述Claude,云端
你的分身26,000 行 Pythonconversation.py 的提示词 + weather.py 的描述DeepSeek,云端

同一个结构。所以你在 Claude Code 上看到的任何行为,也可以用同一个问题拆:这是它的代码、它的文字、还是模型?

下一步

读这一份: Anthropic 官方 · 工具定义的最佳实践。 很短。它讲的是「文字」这一格该怎么写——你会发现 weather.py 那段描述已经照着做了。

练一次真的: 下次分身在群里做了件让你皱眉的事,先别问我「怎么改」。先按这一课的两条规则自己判一遍是谁定的, 然后把你的判断和理由发给我,我来对。判对了,改的地方就对了一半。