你写的 Tool Schema，模型根本看不懂

点击上方 前端Q，关注公众号

回复加群，加入前端Q技术交流群

上一篇讲了工具不稳定的 4 个原因和 4 层防护。这一篇聚焦其中最根本的一层：Schema 设计。

为什么说最根本？因为 schema 写得好不好，直接决定了模型在第一步就能不能正确理解你的工具。参数校验、重试、结果校验都是"出了错之后的补救"，而好的 schema 是"从源头减少出错"。

Anthropic 在工具文档里直接说了：description 的质量是影响工具表现的最重要因素（"by far the most important factor"）。

模型是怎么"看到"你的 Schema 的

在聊怎么设计之前，你需要先理解一个关键事实：模型看到的 schema 不是结构化数据，而是一段纯文本。

整个过程是这样的：