超超哥AI云计算超哥讲AI 出品

社群入口

AI 超哥 Codex 副业群

扫码加入群聊,一起交流 AI、Codex 与副业实践。

原图注明二维码于10月20日前有效;若提示过期或无法入群,请等待更新二维码。

AI 超哥 Codex 副业群入群二维码在新窗口打开原图

工具契约与参数设计

工具调用、MCP 与业务操作集成#FDE#第十五阶段#工具调用、MCP 与业务操作集成#工具契约与参数设计约 419 字 · 1 分钟阅读
追问显示
点击任意追问卡片可收起 / 展开

如何为“查询工单”设计清晰的工具名称和描述?

追问 适用场景、返回范围和限制应怎样说明?

工具参数 Schema 应约束哪些内容?

追问 类型、必填、枚举、范围和额外字段怎样控制?

何时应将一个工具拆成读操作与写操作?

追问 授权、测试和用户确认如何因此更清晰?

工具参数中的业务 ID 如何验证?

追问 存在性、租户归属和当前状态需要哪些查询?

模型可以提供用户身份或租户参数吗?

追问 可信身份应从哪一层获得,模型字段能否覆盖?

工具默认值应如何设计?

追问 日期范围、分页和写入范围哪些不应采用危险默认?

如何避免“执行任意 SQL”或“访问任意 URL”工具权限过宽?

追问 业务专用参数、白名单与资源边界如何替代?

工具返回值如何设计以便程序和模型共同使用?

追问 状态、数据、错误码和可重试标记怎样区分?

工具输出中的敏感字段如何控制?

追问 返回给模型的内容是否需要比业务 API 更少?

工具契约升级时如何保持消费者兼容?

追问 增加字段、调整枚举和修改语义各需什么迁移策略?