函数调用可让您更轻松地从生成模型获取结构化数据输出。然后,您可以使用这些输出来调用其他 API,并将相关响应数据返回给模型。换句话说,函数调用可帮助您将生成模型连接到外部系统,以便生成的内容包含最新、最准确的信息。
您可以向 Gemini 模型提供函数说明。这些函数是采用应用语言编写的函数(也就是说,它们不是 Cloud Functions 函数)。模型可能会要求您调用函数并发回结果,以帮助模型处理您的查询。
您可以在 Google Cloud 文档中详细了解函数调用。
准备工作
完成 Vertex AI for Firebase SDK 入门指南(如果尚未完成)。请确保您已完成以下所有操作:
设置新的或现有的 Firebase 项目,包括使用 Blaze 定价方案以及启用所需的 API。
将您的应用与 Firebase 相关联,包括注册应用以及将 Firebase 配置添加到应用。
添加 SDK 并在您的应用中初始化 Vertex AI 服务和生成模型。
将应用关联到 Firebase、添加 SDK 并初始化 Vertex AI 服务和生成模型后,就可以调用 Gemini API 了。
设置函数调用
在本教程中,您将让模型与一个支持以下参数的假设性货币兑换 API 进行交互:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
currencyFrom |
string | 是 | 换算币种 |
currencyTo |
string | 是 | 要换算成的币种 |
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 for Firebase 使用体验提供反馈