函式呼叫可讓您更輕鬆地從生成式模型取得結構化資料輸出內容。接著，您可以使用這些輸出內容呼叫其他 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 設定，以便控制燈光的亮度和色溫值。