Function calling 的工具 schema 要像 API 一样设计

工具 schema 设计 这件事在 2023 年开始越来越频繁地进入真实项目，但很多团队一开始只看到表面收益，没有先把边界收住。只要 字段定义模糊、可选项太多，模型会频繁给出半对半错的调用参数，问题就会很快从“一个小体验瑕疵”变成系统性的维护成本。

我现在更倾向的做法，是先把这类能力当成正式工程问题来看，而不是把它当成一个临时技巧。对我来说，最关键的一步通常是 让 schema 尽量明确、收敛，并且贴近业务真实约束，因为只有边界先明确，后面的优化、扩展和排查才不会一直漂。

真正容易被忽略的，往往不是功能能不能做出来，而是以下这些细节：

• 参数命名要直观，别让模型和人都要猜含义
• 必须字段和默认字段要分清，减少暧昧空间
• 工具描述不要写成长篇说明书，重点放在决策边界

这些细节看起来都不大，但它们决定了系统是在 demo 阶段“能跑”，还是进入业务以后依然稳定。越是和 AI、工作流、构建链路这类复杂能力相关，越不能靠感觉把事情糊过去。

小结

Function calling 看似是模型能力，实际很依赖 schema 质量。把 schema 设计得像 API 一样严谨，调用稳定性会提升很多。