设计API给AI：默认值有害，错误是机会

Designing APIs for Agents

过去两年，我彻底转变了设计API的理念。以前我们为人类开发者设计API，追求极简和智能默认值，让用户50行代码就能跑起来。但现在，API的主要消费者是AI Agent。它们能瞬间读完所有文档，生成数千行代码。对人类友好的“智能默认值”和“容错机制”反而成了Agent的噩梦，导致幻觉和歧义。现在的设计原则是：默认值是坏的，必须显式；错误不是坏事，而是澄清误解的机会；拒绝模糊的字段名，用精确的事实代替感觉。Freestyle团队因此重构了SDK，去掉了所有抽象层，只提供最原始的事实和文档，让Agent能精准调用。

"错误是Agent寻找正确路径的最佳途径，但前提是这些错误必须足够精确。"