[Bug]Gemini 模型工具声明阶段报 400 错误：Unknown name "examples" at function_declarations

[konodiodaaaaa1]

What happened / 发生了什么

在使用 openai_chat_completion 提供商（通过中转 API）调用 Gemini 模型（如 gemini-3.1-pro-preview）时，如果启用的插件在注册工具时带有 examples 字段（例如 claude_code、hapi_coding 等插件），大模型会直接抛出 400 错误并拒绝响应。
之前的 PR #7386 和 #7134 完美修复了 Gemini 工具返回阶段的格式校验问题，但遗漏了在工具声明阶段 (Function Declarations) 的校验。
由于 OpenAI 和 DeepSeek 的接口比较宽容，会自动忽略多余的 examples 字段，但 Gemini 的 OpenAPI Schema 校验极度严格，遇到不认识的字段直接拒收。目前 AstrBot 官方生态内的插件普遍带有 examples，导致配置 Gemini 后大面积无法使用工具。

Reproduce / 如何复现？

配置大模型为 gemini-3.1-pro-preview（走 OpenAI 格式转接）。开启并配置任意注册工具时带有 examples 字段的插件（如 claude_code）。框架向 API 提交携带该工具的 payload，立刻触发 400 报错崩溃。

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

Astrbot版本：4.23.1
部署方式：Windows Launcher
提供商：OpenAl Compatible

OS

Windows

Logs / 报错日志

[13:30:21.036] [Core] [WARN] [v4.23.1] [runners.tool_loop_agent_runner:350]: Chat Model jeniya/gemini-3-flash-preview request error: Error code: 429 - {'error': {'message': 'Invalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[38]..properties[0].value': Cannot find field.\nInvalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[39]..properties[0].value': Cannot find field.\nInvalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[40]..properties[0].value': Cannot find field.\nInvalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[40]..properties[1].value': Cannot find field.\nInvalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[41]..properties[0].value': Cannot find field.\nInvalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[42]..properties[0].value': Cannot find field.\nInvalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[44]..properties[0].value': Cannot find field.\nInvalid JSON payload received. Unknown name "examples" at 'tools[0].function_declarations[47]..properties[0].value': Cannot find field. (request id: 20260415133004251996465A32XL8KX)', 'type': 'upstream_error', 'param': '', 'code': '400'}}

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

Hi @konodiodaaaaa1! I'm Dosu and I’m helping the AstrBot team.

问题定位得很准确。根因是：当通过 OpenAI Compatible 提供商转发请求到 Gemini 后端时，工具 schema 走的是 openai_schema() 路径，不会经过 google_schema() 的字段白名单过滤 [1]。

具体来说：

• 原生 Gemini 提供商使用 google_schema()，其中有严格的字段白名单（只保留 title, description, enum, minimum, maximum 等），examples 等多余字段会被隐式过滤掉 [1]。
• OpenAI Compatible 提供商使用 openai_schema()，会直接透传完整的 tool.parameters，不做字段过滤 [2]。虽然代码中已有检测模型名含 "gemini" 的逻辑来设置 omit_empty_param_field = True，但这只处理了空参数字段的问题，没有做完整的 schema 清洗 [3]。

修复方向建议： 在 OpenAI Compatible 提供商检测到模型名包含 "gemini" 时，对 function declarations 的 parameters 也应用类似 google_schema() 的字段过滤逻辑（递归移除 examples、additionalProperties、default 等 Gemini 不认识的字段）。

这和之前的 issue #5053 中 additionalProperties 导致的 400 错误是同一类问题 [4]。期待你的 PR！

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}