関数呼び出しを使用すると、生成モデルから構造化データの出力を簡単に取得できます。これらの出力を使用して他の API を呼び出し、関連するレスポンス データをモデルに返すことができます。つまり、関数呼び出しにより、生成モデルを外部システムに接続して、生成されたコンテンツに最新かつ正確な情報を含めることができます。
Gemini モデルに関数の説明を指定できます。これらは、アプリの言語で記述する関数です（Google Cloud Functions ではありません）。モデルがクエリの処理に役立つ関数を呼び出して結果を返すよう求める場合があります。
まだ確認していない場合は、関数呼び出しの概要で詳細を確認してください。
照明制御の API の例
アプリケーション プログラミング インターフェース（API）を備えた基本的な照明制御システムがあり、ユーザーが簡単なテキスト リクエストで照明を制御できるようにしたいとします。関数呼び出し機能を使用すると、ユーザーからの照明変更リクエストを解釈し、API 呼び出しに変換して照明値を設定できます。この架空の照明制御システムでは、ライトの明るさと色温度を 2 つの個別のパラメータとして制御できます。
| パラメータ | タイプ | 必須 / 省略可 | 説明 |
|---|---|---|---|
brightness |
数値 | あり | 明るさレベル（0 ～ 100）。0 はオフ、100 は最大の明るさです。 |
colorTemperature |
文字列 | あり | 照明器具の色温度（daylight、cool、warm のいずれか）。 |
わかりやすくするために、この架空の照明システムにはライトが 1 つしかなく、ユーザーは部屋や場所を指定する必要はありません。照明制御 API に送信して、昼光色温度を使用して照明レベルを 50% に変更する JSON リクエストの例を次に示します。
{
"brightness": "50",
"colorTemperature": "daylight"
}
このチュートリアルでは、Gemini API の関数呼び出しを設定して、ユーザーの照明リクエストを解釈し、API 設定にマッピングして、照明の明るさと色温度の値を制御する方法について説明します。