要让Gemini自动执行函数,必须完成工具声明、提示引导、响应解析与结果回填四环节;缺一不可,否则function_call字段为空。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Gemini在对话中自动执行你写好的函数,比如查库存、发邮件或写数据库,必须完成工具声明、提示引导、响应解析与结果回填四个环节,缺一不可;否则function_call字段始终为空。
第一步:用JSON Schema把函数“告诉”模型
在初始化模型时,把函数定义以严格符合OpenAPI 3.0规范的字典形式传入tools参数。每个函数必须包含name(仅小写字母/数字/下划线)、description(一句话说清用途)、parameters(object类型,每个参数标注type和description)。
例如定义一个发工单函数:
```json
{"name": "create_ticket", "description": "创建IT支持工单", "parameters": {"type": "object", "properties": {"summary": {"type": "string", "description": "问题简述"}, "category": {"type": "string", "description": "类别,取值为网络故障/软件问题/硬件报修"}, "urgency": {"type": "string", "description": "紧急程度,取值为高/中/低"}}, "required": ["summary", "category"]}
```
【缺失required字段会导致模型拒绝生成function_call】。哪怕用户明确说了“打印机连不上,很急”,只要"category"没列在required里,模型就只返回自然语言解释,绝不会调用函数。
第二步:让提示词自带“动作指令”
方法一:用强动词开头,如“查北京今天气温”“订两张6月15日上海到杭州的高铁票”。模型只对含明确动作意图的句子启动工具决策流程。
方法二:嵌入具体实体与时间锚点,例如“2026年6月4日14:30在腾讯会议创建技术评审会,参会人张三、李四”。模糊表述如“找个时间开会”无法激活调用。
方法三:避免试探性语气。不要写“能不能帮我查一下天气?”,直接写“查一下深圳当前天气”。模型不识别疑问句式中的调用请求,会当成普通问答处理。
第三步:安全提取并执行function_call
第一步:检查response.candidates[0].content.parts[0].function_call是否存在且非None。若为空,说明模型判断无需调用工具,直接取.text即可。
第二步:提取function_call.name,与本地已注册工具名做精确字符串匹配——【大小写、下划线、拼写错一位都会导致工具执行失败】(截至2026年6月10日)。
第三步:校验参数类型是否匹配。比如函数要求"urgency"是字符串,但模型传了布尔值True,必须拦截并报错,不能强行转类型。
第四步:执行本地函数后,将结果封装为ToolResponse,再喂给模型生成最终回答。











