函式呼叫教學課程

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