搜索与 AI
Tool Metadata 是什么？
工具元数据 · Tool Metadata
Tool Metadata（工具元数据）是 AI 应用获取的工具定义信息，例如名称、功能描述、输入参数 Schema，以及可选的输出 Schema 与行为注解。这些信息说明工具如何使用，并不是工具的代码实现，也不能证明工具执行成功。
各字段分别回答什么问题
名称用来标识工具；Tool Description 说明功能、用途与使用条件；输入 Schema 定义参数的字段、类型与必填项；输出 Schema 可定义结构化结果的格式。不同协议与客户端支持的字段可能不同。
以 MCP 2025-11-25 规范为例，工具定义包含 name、description、inputSchema，并可提供 outputSchema 与 annotations。annotations 是描述行为的信息，不能取代服务器的权限验证。
能看到哪些字段，由应用程序决定
工具目录收录了完整定义，不代表模型每一轮都会收到全部内容。有些宿主先做候选召回，再加载部分工具；用于搜索的索引字段与模型最终看到的字段，也可能不同。
TSO 关注工具如何被找到与选用；TCC 则进一步对照任务、参数及返回结果的判读。元数据写得清楚，仍需用实际记录来验证行为。
参考资料
最近查核：