适合场景
- 根据用户问题调用后端函数
- 查询订单、库存、日程或知识库
- 多步骤 Agent 工作流
- 让模型输出结构化参数,而不是自由文本
调用接口
多数支持工具调用的模型使用 文本对话模型 的同一接口:tools 和 tool_choice。模型是否支持这些字段,以模型广场能力标签为准。
示例结构
模型差异
调试建议
- 先让模型只输出 JSON,确认结构化能力,再接入真实工具。
- 函数参数 schema 保持简短明确,避免嵌套过深。
- 如果模型没有调用工具,尝试使用
tool_choice强制指定。 - 如果返回参数不符合预期,缩小 enum、增加 description、减少可选字段。
- 生产环境必须在服务端校验工具参数,不能直接信任模型输出。
相关文档
文本对话
工具调用基于对话消息和模型响应。
错误排查
处理参数不兼容、模型不可用、限流和超时。
