Panggilan fungsi mempermudah Anda mendapatkan output data terstruktur dari model generatif. Kemudian, Anda dapat menggunakan output ini untuk memanggil API lain dan menampilkan data respons yang relevan ke model. Dengan kata lain, panggilan fungsi membantu Anda menghubungkan model generatif ke sistem eksternal sehingga konten yang dihasilkan menyertakan informasi terbaru dan akurat.
Anda dapat memberikan deskripsi fungsi ke model Gemini. Ini adalah fungsi yang Anda tulis dalam bahasa aplikasi (yaitu, bukan Google Cloud Functions). Model mungkin meminta Anda untuk memanggil fungsi dan mengirim kembali hasilnya untuk membantu model menangani kueri Anda.
Jika belum, lihat Pengantar panggilan fungsi untuk mempelajari lebih lanjut.
Contoh API untuk kontrol pencahayaan
Bayangkan Anda memiliki sistem kontrol pencahayaan dasar dengan antarmuka pemrograman aplikasi (API) dan ingin mengizinkan pengguna mengontrol lampu melalui permintaan teks sederhana. Anda dapat menggunakan fitur Panggilan Fungsi untuk menafsirkan permintaan perubahan pencahayaan dari pengguna dan menerjemahkannya menjadi panggilan API untuk menetapkan nilai pencahayaan. Sistem kontrol pencahayaan hipotetis ini memungkinkan Anda mengontrol kecerahan lampu dan suhu warnanya, yang ditentukan sebagai dua parameter terpisah:
| Parameter | Jenis | Wajib diisi | Deskripsi |
|---|---|---|---|
brightness |
angka | ya | Tingkat cahaya dari 0 hingga 100. Nol adalah nonaktif dan 100 adalah kecerahan penuh. |
colorTemperature |
string | ya | Suhu warna perlengkapan lampu yang dapat berupa daylight, cool, atau warm. |
Untuk memudahkan, sistem pencahayaan imajiner ini hanya memiliki satu lampu, sehingga pengguna tidak perlu menentukan ruangan atau lokasi. Berikut adalah contoh permintaan JSON yang dapat Anda kirim ke API kontrol pencahayaan untuk mengubah tingkat cahaya menjadi 50% menggunakan suhu warna cahaya siang:
{
"brightness": "50",
"colorTemperature": "daylight"
}
Tutorial ini menunjukkan cara menyiapkan Panggilan Fungsi untuk Gemini API guna menafsirkan permintaan pencahayaan pengguna dan memetakan ke setelan API untuk mengontrol nilai kecerahan dan suhu warna lampu.