Lesson 03 · 模型 / 代码 / 文字
分身做了一件事——对的或错的。先别问「怎么改」,先问「这是谁定的」。 答错这一步,改的地方就会错。这一课练的就是这一步。
TOOLS 那份声明,和 run_bash 那个函数,靠什么连在一起?
只靠名字。声明里 "name": "bash",回来的块里 block.name == "bash",
你的代码拿这个名字去查该调哪个函数。声明和实现在代码层面零联系。
忘了的话回 第 1 课 看那张四条报文的图。
代码和模型互相碰不到。代码把文字发过去,模型读文字、填表、回文字,代码再拿文字去干活。 所以任何一个行为,追到底只会落在三处之一。
去代码里找。同一句话发十次都一样错,那不是模型在犹豫,是某行代码在执行它写好的规则。
去文字里找。模型本身你改不了,你能改的只有它读到的东西——哪句话没写、哪句话被另一句压住了。
第三种:文字没覆盖到、模型自己拿的主意。这种要先判断该不该由它拿主意——该,就不动;不该,就补一句文字把它按住。 这也是 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 | 本机那个 189 MB 的 claude.exe | 系统提示词 + 几十条工具描述 | Claude,云端 |
| 你的分身 | 26,000 行 Python | conversation.py 的提示词 + weather.py 的描述 | DeepSeek,云端 |
同一个结构。所以你在 Claude Code 上看到的任何行为,也可以用同一个问题拆:这是它的代码、它的文字、还是模型?
读这一份:
Anthropic 官方 · 工具定义的最佳实践。
很短。它讲的是「文字」这一格该怎么写——你会发现 weather.py 那段描述已经照着做了。
练一次真的: 下次分身在群里做了件让你皱眉的事,先别问我「怎么改」。先按这一课的两条规则自己判一遍是谁定的, 然后把你的判断和理由发给我,我来对。判对了,改的地方就对了一半。