Pydantic AI项目中Gemini 2.5 Flash模型工具调用问题解析

在Pydantic AI项目中，开发者在使用Gemini 2.5 Flash模型时遇到了一个典型的工具调用参数结构问题。这个问题揭示了不同大语言模型对工具调用参数结构的差异性要求。

问题的核心在于工具调用参数的结构定义。当开发者尝试将原本在Anthropic/Claude模型上正常工作的代理迁移到Gemini Flash模型时，系统抛出了参数验证错误。错误信息显示Gemini模型无法识别多个参数字段，包括"created_after"、"created_before"、"tags"等。

经过深入分析，发现问题出在参数结构的层级定义上。在工具调用的JSON Schema定义中，参数属性被错误地放在了Schema的根级别，而不是按照规范放在"properties"字段下。这种结构差异导致了Gemini模型的解析失败。

这个问题具有典型意义，它展示了：

1. 不同大语言模型对工具调用接口的严格程度存在差异
2. JSON Schema定义必须严格遵守规范
3. 在模型迁移时需要特别注意参数结构的兼容性

解决方案相对简单但关键：需要将所有参数属性移动到Schema的"properties"字段下。这种调整虽然微小，但对于确保跨模型兼容性至关重要。

这个案例给开发者带来的启示是：

• 在定义工具调用接口时，必须严格遵循JSON Schema规范
• 不同模型提供商可能对Schema的验证严格程度不同
• 在模型迁移过程中，参数结构验证是需要重点关注的环节

通过这个问题的解决，Pydantic AI项目在支持多模型方面又向前迈进了一步，为开发者提供了更稳定的跨模型工具调用体验。