使用 Gemini API 进行函数调用


借助函数调用,您可以更轻松地从生成式模型获取结构化数据输出。然后,您可以使用这些输出来调用其他 API,并将相关响应数据返回给模型。换句话说,函数调用有助于 将生成模型连接到外部系统, 可提供最新、最准确的信息。

您可以为 Gemini 模型提供函数说明。这些是 以应用语言编写的函数(也就是说,它们 Cloud Functions)。模型可能会要求您调用一个函数并返回 帮助模型处理您的查询。

您可以 详细了解函数调用Google Cloud

准备工作

如果您还没有这样做,请完成 Vertex AI in Firebase SDK 入门指南。 请确保您已完成以下所有操作:

  1. 设置一个新的或现有的 Firebase 项目,包括使用 Blaze 定价方案并启用所需的 API。

  2. 将您的应用与 Firebase 相关联,包括注册应用和添加 Firebase 配置添加到您的应用。

  3. 添加 SDK,并在应用中初始化 Vertex AI 服务和生成式模型。

将应用连接到 Firebase、添加 SDK 并初始化 Vertex AI 服务和生成式模型后,您就可以调用 Gemini API 了。

设置函数调用

在本教程中,您将让模型与一个假设的货币兑换 API 进行交互,该 API 支持以下参数:

参数 类型 是否必需 说明
currencyFrom 字符串 换算币种
currencyTo 字符串 要转换到的币种

API 请求示例

{
  "currencyFrom": "USD",
  "currencyTo": "SEK"
}

API 响应示例

{
  "base": "USD",
  "rates": {"SEK": 10.99}
}

第 1 步:创建用于发出 API 请求的函数

如果您还没有创建该函数,请先创建一个 API 请求。

出于本教程中的演示目的,不要发送实际的 API 请求将返回硬编码值,格式与实际 API 将返回的内容。

第 2 步:创建函数声明

创建将传递给生成模型的函数声明 (本教程的下一步)。

在函数和参数说明中添加尽可能详细的信息。 生成模型使用这些信息来确定选择哪个函数 以及如何为函数调用中的形参提供值。

第 3 步:在模型初始化期间指定函数声明

指定在初始化生成模型时的函数声明,方法是 设置模型的 tools 参数:

了解如何选择适合您的用例和应用的 Gemini 模型和(可选)位置

第 4 步:生成函数调用

现在,您可以使用定义的函数向模型提问。

建议您通过聊天界面使用函数调用,因为 函数调用非常适合于聊天的多轮结构。

您还可以执行以下操作

试用 Gemini API 的其他功能

了解如何控制内容生成

您还可以使用 Vertex AI Studio 对提示和模型配置进行实验。

详细了解 Gemini 模型

了解适用于各种用例的模型及其配额和价格


就您使用 Vertex AI in Firebase 的体验提供反馈