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