函式呼叫可讓您輕鬆取得結構化資料輸出內容 生成式模型接著，您可以使用這些輸出內容呼叫其他 API，並將相關回應資料傳回模型。換句話說，函式呼叫有助於 必須連結生成式模型與外部系統 內含最新且準確的資訊。
您可以為 Gemini 模型提供函式說明。這些函式是使用應用程式語言編寫的函式 (也就是說，它們不是 Google Cloud Functions)。模型可能會要求您呼叫函式，然後傳回 以便模型處理查詢
如果您還不瞭解 函式呼叫簡介： 詳情
照明控制 API 範例
假設您有一個基本的照明控制系統 搭配應用程式設計 介面 (API)，並希望使用者能透過簡單的 文字要求您可以使用函式呼叫功能，解讀使用者提出的燈光變更要求，並將這些要求轉譯為 API 呼叫，以便設定燈光值。這個假設的照明控制系統可讓您控制燈光的亮度和色溫，這兩個參數分別定義如下：
| 參數 | 類型 | 必要 | 說明 |
|---|---|---|---|
brightness |
數字 | 是 | 光線強度從 0 到 100。零關閉，100 為全彩。 |
colorTemperature |
字串 | 是 | 燈具的色溫，可能是 daylight、cool 或 warm。 |
為簡化說明，這個假想的照明系統只有一盞燈，因此使用者不必指定房間或位置。以下是您可以傳送至照明控制 API 的 JSON 要求範例，藉此使用日光色溫將燈光亮度變更為 50%：
{
"brightness": "50",
"colorTemperature": "daylight"
}
本教學課程將說明如何設定函式呼叫，供 Gemini API 執行下列操作： 解讀使用者的光源要求並對應至 API 設定， 亮度和色溫值。