AI 知识库首页

Tool Schema 设计

工具、MCP 与 Agent 协议专题:用 1 个核心问题讲清原理、取舍与落地。

一句话定位

工具契约、注册发现、执行网关、MCP、A2A 与网络安全。 模型只负责提出调用;宿主负责发现、校验、授权、执行、重试、审计和返回结果。

核心原理与问题解析

Tool Schema 为什么重要?

它是模型与执行器的接口合同,限制参数类型、必填、枚举和结构,直接影响工具选择和参数正确率。Schema 合法仍需业务与权限校验。

继续想: description 与 schema 谁更重要?;Schema 版本如何兼容?

工程落地检查

  • Schema 清楚表达必填、枚举与互斥
  • 读写工具分权并标记副作用
  • call_id、幂等键和超时贯穿链路
  • 第三方工具输出一律视为不可信
  • 协议互通之外仍做认证、授权和审计

常见误区

  • 把 Function Calling 误解成模型直接执行
  • 把 MCP 当成安全边界
  • 为方便把全部工具和高权限一次暴露

对应面试题

U02 Tool Schema 为什么重要?

延伸资料

Model Context Protocol · A2A Protocol · OpenAI Function Calling