使用 Gemini API 进行函数调用


函数调用可让您更轻松地从 Google Cloud 控制台获取结构化数据输出 生成模型。然后,您可以使用这些输出来调用其他 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

设置函数调用

在本教程中,您将让模型与一个假设的货币进行交互 支持以下参数的 Exchange 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的体验