跳到文章正文
Gemini 实用教程

Gemini API怎么调用自定义函数?参数验证、call_id与结果回传

在Interactions声明只读练习函数,检查function_call再执行应用白名单;用f…

Gemini API怎么调用自定义函数?参数验证、call_id与结果回传

让Gemini输出函数名并不意味着函数已执行。自定义函数调用由模型给出结构化请求,应用验证后执行,再返回结果。本文用只读人工库存练习,不创建订单或操作真实设备,重点是调用身份和结果衔接。

第一步:定义只读函数边界

先明确输入类型、允许范围和返回口径。只接受练习SKU,不从模型参数拼接Shell或SQL。模型可能给出Schema合法但业务越权的参数,用户身份与资源权限仍由应用判断。

当前官方示例使用Google Gen AI SDK的Interactions接口,示例模型gemini-4-hydrogen需项目支持。不同API版本工具和回传结构不同,不能把旧generateContent代码直接混进本例。

第二步:声明并取得调用请求

工具描述说明用途,parameters给输入结构。auto行为不保证每轮必调用,应用应判断实际步骤;没有调用时不能从自然语言回答推断已经查询数据。下面不执行付费请求。

from google import genai
client = genai.Client()
tool = {"type": "function", "name": "lookup_demo_stock",
        "description": "只读查询练习SKU库存,不修改订单",
        "parameters": {"type": "object", "properties": {"sku": {"type": "string"}}, "required": ["sku"]}}
interaction = client.interactions.create(
    model="gemini-4-hydrogen", input="查询练习SKU DEMO-001的库存", tools=[tool]
)
for step in interaction.steps:
    if step.type == "function_call":
        print(step.name, step.arguments, step.id)

第三步:验证后才执行函数

核对工具名确实在应用白名单、sku为允许的练习值,再返回固定样本7,明确这不是实际仓库结果。未知工具、参数错误和业务服务失败分别处理,不用虚构成功值让流程继续。

函数可能并行或多次出现,记录每个调用ID,不按返回顺序随意配对。涉及真实写操作的扩展应先设计授权、幂等与人工批准,不能从用户问库存推断允许下单。

应用检查:工具名正确;参数类型正确;SKU在练习范围;用户有读取权限;返回值标明人工样本;调用次数有限;错误不伪装成功。

第四步:按协议返回对应结果

当前官方Interactions使用function_result、name、call_id和result回传,并可用previous_interaction_id关联前一次交互。call_id必须来自真实function_call步骤,不是自己编一个编号。

保持SDK当前要求的结果内容结构,不把工具结果写成新的用户愿望或模型最终回答。保留原始交互身份,应用断线后先核对已有动作状态,避免重复执行。

第五步:验收最后答案与循环终止

最后回答应针对DEMO-001并使用人工样本7,不应宣布订单已创建。若模型再次请求函数,按有上限循环处理,不把中间调用当成最终消息。

测试包括无调用、未知工具、非法SKU、服务失败和多调用关联。格式通过只是协议层,事实正确与业务权限是另外两层。完成标准是请求、执行和回传证据完整,任何一步未发生都如实标注,不凭一句“已查询”虚报完成。

官方资料

资料核对日期:2026年11月18日。

本文地址:https://www.163264.com/21719