·tian
你在没告诉智能体的情况下修改了工具 Schema
重命名一个字段对你的后端来说只是常规的 API 变更，但对于调用该工具的 LLM 而言，这却是一个无声的破坏性变更。本文探讨如何将工具 Schema 视为拥有两个消费者的版本化契约。
insider
ai-agents
function-calling
api-design
+1·tian
下线一个 Planner 已产生依赖的 Agent 工具
从你的 Agent 工具目录中移除一个函数不仅仅是语法上的更改，更是一次行为迁移。这种阶段式下线模式可以防止回退幻觉和隐性回归。
insider
agents
tool-use
deprecation
+2·tian
参数幻觉是漂移信号，而非模型 Bug
当模型虚构参数值时，成本最低的假设并不是“模型失败了”，而是“你提供给模型的描述与连接另一端的 API 不再匹配”。
llm-tools
agents
function-calling
observability
+1·tian
工具 Schema 是提示词，而非 API 合约
从 OpenAPI 规范自动生成的 LLM 工具 Schema，本质上是将你的 API 文档作为提示词发布 —— 而你的智能体将为此付出代价，在测试中难以察觉的误用会频频发生。
insider
llm-tools
agents
function-calling
+2·tian
你的工具描述是提示词，而非 API 文档
工具规范文本是模型在决定何时调用之前读取的提示词。请像对待提示词一样对待它——提供具体的用例、反面示例、同类工具辨析——而不是像对待 OpenAPI 文档那样。
ai-engineering
tool-use
function-calling
prompt-engineering
+1·tian
工具清单的谎言：当你的 Agent 信任一个后端已不再遵循的 Schema 时
生产环境 Agent 中最危险的 Bug 不是那些会报错的，而是工具描述承诺了一个后端在两个 Sprint 前就重命名的字段，而模型却仍在按照一切未曾改变的样子进行推理。
ai-agents
tool-use
function-calling
reliability
+1·tian
工具文档字符串考古学：描述字段是你杠杆率最高的提示词
工具定义看起来像 API 文档，但其本质是自然语言提示词。请将描述字段视为生产级别的提示词资产 —— 并添加相应的 Lint 规则来捕捉那些无声的回归风险。
insider
tool-use
function-calling
prompt-engineering
+2·tian
为智能体编写工具：ACI 与 API 同等重要
你如何为 AI 智能体设计工具 —— 包括 Schema、描述、返回值和错误信息 —— 直接决定了智能体的可靠性。本指南将教你如何像对待任何生产级 API 一样严肃地对待 “智能体-计算机接口” (ACI)。
ai-agents
tool-design
llm-engineering
function-calling
·tian
生产环境中的工具使用：真正有效的函数调用模式
大多数 LLM 代理失败的原因可追溯到工具 Schema 规范不足，而非模型能力问题。本实践指南涵盖了生产环境函数调用的 Schema 设计、错误处理、并行调用和安全性。
llm
agents
function-calling
production
+1