借助函数调用，您可以更轻松地从生成式模型获取结构化数据输出。然后，您可以使用这些输出来调用其他 API，并将相关响应数据返回给模型。换句话说，函数调用可帮助您将生成式模型连接到外部系统，以便生成的内容包含最新、最准确的信息。
您可以为 Gemini 模型提供函数说明。这些函数是使用应用所用语言编写的（即它们不是 Google Cloud Functions 函数）。模型可能会要求您调用函数并发回结果，以帮助模型处理您的查询。
如果您尚未了解，请参阅函数调用简介了解详情。
用于照明控制的 API 示例
假设您有一个带有应用编程接口 (API) 的基本照明控制系统，并且希望允许用户通过简单的文本请求控制灯具。您可以使用函数调用功能来解读用户发来的照明更改请求，并将其转换为 API 调用以设置照明值。通过这个假想的照明控制系统，您可以控制灯的亮度和色温，这两个参数定义如下：
| 参数 | 类型 | 是否必需 | 说明 |
|---|---|---|---|
brightness |
数值 | 是 | 亮度级别，介于 0 到 100 之间。0 表示关闭，100 表示全亮度。 |
colorTemperature |
字符串 | 是 | 灯具的色温，可以是 daylight、cool 或 warm。 |
为简单起见，这个虚构的照明系统只有一个灯，因此用户无需指定房间或位置。以下是一个 JSON 请求示例，您可以将其发送到照明控制 API，以使用日光色温将亮度更改为 50%：
{
"brightness": "50",
"colorTemperature": "daylight"
}
本教程介绍了如何为 Gemini API 设置函数调用，以解读用户的照明请求并将其映射到 API 设置，从而控制灯具的亮度和色温值。