[Bug]openai下的gemini模型无法调用函数工具

[MoEternal]

What happened / 发生了什么

1.使用openai-gemini 3 pro（反重力）模型调用不了函数，不会检索群成员、禁言、踢人等任何函数操作，但是换成了同样api下的claude 4.5是会的，所以可推断不是插件问题。

2.其次我同样使用这个gemini模型在zerobot（https://github.com/FloatTech/ZeroBot-Plugin）上试了是可以进行禁言等操作的，所以也可推断不是模型问题。

3.我在astrbot里模型设置已经勾上工具选项，查看函数也都开启，后台开启debug等但看不到任何报错。

Reproduce / 如何复现？

使用openai-gemini 3 pro模型调用函数，检索群成员、禁言、踢人等

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

astrbot v4.12.1~v4.12.4，win一键部署，aiocqhttp

OS

Windows

Logs / 报错日志

[08:06:24] [Core] [INFO] [star.star_manager:395]: 正在载入插件 astrbot_plugin_llm_qqgrouptools ...
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: set_essence_msg
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: send_like
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: set_group_ban_byself
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: set_group_ban
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: set_group_kick
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: set_group_whole_ban
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: set_group_card
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: send_group_notice
[08:06:24] [Core] [INFO] [provider.func_tool_manager:163]: 添加函数调用工具: get_group_members_info
[08:06:24] [Core] [INFO] [star.star_manager:452]: Plugin astrbot_plugin_llm_qqgroupTools (V1.3.0) by SatenShiroya: 允许AI自主管理群聊，包括全群禁言和设置群成员名片等功能，当然也可以命令它
[08:07:48] [Core] [INFO] [core.event_bus:59]: [default] [丛雨(aiocqhttp)] 学艺不精陌恒sama/2994830526: [At:3116857057] 随便发个群公告试试
[08:08:07] [Core] [INFO] [respond.stage:168]: Prepare to send - 学艺不精陌恒sama/2994830526: [At:2994830526] 主人，发公告是什么呀？吾辈找了半天也没看到哪里可以贴告示……这种高深的操作吾辈真的做不来啦！ [图片]
[08:09:01] [Core] [INFO] [core.event_bus:59]: [default] [丛雨(aiocqhttp)] 学艺不精陌恒sama/2994830526: [At:3116857057] 你的函数库里不是给了你发群公告的方式吗 'send_group_notice'
[08:09:22] [Core] [INFO] [respond.stage:168]: Prepare to send - 学艺不精陌恒sama/2994830526: [At:2994830526] 狗修金，吾辈翻遍了那个什么“函数库”，根本没有看到这种奇怪的咒语嘛！汝是不是记错啦？吾辈脑袋都要想破了…… [图片]

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 @MoEternal! I'm Dosu and I’m helping the AstrBot team.

你的情况很常见，Gemini 3 Pro 在 AstrBot 里无法调用函数工具，主要有以下几个常见原因和排查建议：

1. 检查 Gemini 配置项
   AstrBot 的 Gemini 配置里，只要开启了 gm_native_coderunner、gm_native_search 或 gm_url_context 这类“原生工具”相关选项，所有自定义函数工具（比如禁言、踢人等）都会被完全禁用，且不会有报错或日志输出。请确保这些选项全部关闭（默认是关闭的）参考。

2. 升级 AstrBot 到最新版
   Gemini 适配器近期修复了多项 function calling 相关 bug，包括参数空对象、工具调用死循环、参数校验等问题。建议升级到最新版本（v4.12.4 之后），避免已知兼容性 bug 参考 参考。

3. 逐步排查自定义工具
   某些自定义工具如果参数定义不规范（如空参数、类型不符），会导致 Gemini function calling 整体失效。可以尝试只保留最基础的几个工具，逐步排查是否有异常工具导致全部失效 参考。

4. 确认 API 服务端支持 function calling
   如果你用的是代理或第三方服务，需确认其支持 tools 字段，否则 Gemini 会直接 400 报错，function calling 失效 参考。

5. 重启 AstrBot
   有用户反馈切换服务提供商或模型后需要重启 AstrBot，MCP 工具才能恢复正常 参考。

6. Gemini 原生工具和 MCP 工具不能同时用
   Gemini 原生工具和 AstrBot 的 MCP 工具（基于 function calling）本身就不兼容，不能同时启用，这属于正常现象 参考。

如果以上都确认没问题但依然无法调用，建议抓取 Gemini function calling 的完整请求和响应日志，重点看 tools 字段和参数结构，或尝试在其他环境（如 ZeroBot）对比集成差异。

To reply, just mention @dosu.

---

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

  

[MoEternal]

你说的都原生谷歌gemini，但我用的是反重力openai，你提到的gm_native_coderunner、gm_native_search 或 gm_url_context都只在谷歌原生接口中，openai无配置项 @dosubot

[dosubot]

你说得对，gm_native_coderunner、gm_native_search、gm_url_context 这些配置项只针对谷歌原生Gemini接口，OpenAI兼容Gemini（比如反重力openai）没有这些选项，也不会影响函数工具调用参考。

你遇到的“函数工具无法用”问题，主要有以下常见原因：

1. API代理/服务端不支持tools字段
   很多OpenAI兼容Gemini代理/服务端其实并不完整支持function calling（tools字段），会直接400报错或忽略，导致函数工具失效。Claude 4.5能用但Gemini不能，通常就是服务端实现不一致参考。

2. provider配置不规范
   检查你的provider配置，确保有type: openai_chat_completion、provider_type: chat_completion、api_base等字段，缺少provider_type会导致后端不可用参考。

3. 部分Gemini模型本身不支持function calling
   有些Gemini模型（如部分pro/flash/exp）本身API侧就不支持function calling，建议查阅服务端文档或直接抓包确认。

4. 自定义工具参数定义不兼容
   某些自定义函数参数定义不规范（如空参数、类型不符），会导致整个function calling失效。可以只保留最基础的几个工具，逐步排查。

5. 服务端返回格式不符OpenAI标准
   有些第三方Gemini服务端返回的函数调用结果格式不完全符合OpenAI标准（如arguments为dict而非JSON字符串），AstrBot会解析失败参考。

6. 建议升级AstrBot并重启
   AstrBot近期修复了很多Gemini相关function calling兼容性bug，建议升级到最新版并重启。

排查建议：

• 抓取Gemini function calling的完整请求和响应日志，重点关注tools字段、参数结构和API返回内容。如果有400报错，把完整报文贴出来更容易定位问题。
• 如果确认服务端不支持function calling，建议换用谷歌原生Gemini API，功能更全且兼容性好参考。

如需进一步排查，可以贴下你的provider配置和相关日志。

To reply, just mention @dosu.

---

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