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