La chiamata di funzione semplifica l'ottenimento di output di dati strutturati da e modelli generativi. Puoi quindi utilizzare questi output per chiamare altre API e restituire i dati di risposta pertinenti al modello. In altre parole, la chiamata di funzione colleghi modelli generativi a sistemi esterni in modo che i contenuti generati includa le informazioni più aggiornate e accurate.
Puoi fornire ai modelli Gemini descrizioni delle funzioni. Si tratta di di funzioni che scrivi nella lingua della tua app (ovvero, Google Cloud Functions). Il modello potrebbe chiederti di richiamare una funzione e restituirla il risultato per aiutare il modello a gestire la query.
Se non l'hai già fatto, consulta il Introduzione alle chiamate di funzione per imparare altro ancora.
API di esempio per il controllo dell'illuminazione
Immagina di avere un sistema di base per il controllo dell'illuminazione con una programmazione di un'applicazione (API) e vuoi consentire agli utenti di controllare le luci tramite semplici richieste di testo. Puoi utilizzare la funzionalità di chiamata di funzione per interpretare l'illuminazione modificare le richieste degli utenti e tradurle in chiamate API per e i relativi valori. Questo ipotetico sistema di controllo dell'illuminazione ti consente di controllare luminosità della luce e la relativa temperatura di colore, definita come due parametri:
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
brightness |
numero | sì | Livello di luce da 0 a 100. Lo zero è disattivato e 100 è piena luminosità. |
colorTemperature |
stringa | sì | Temperatura di colore del dispositivo di illuminazione che può essere daylight, cool o warm. |
Per semplicità, questo sistema di illuminazione immaginario ha una sola illuminazione, quindi l'utente non richiede di specificare una stanza o un luogo. Ecco un esempio di richiesta JSON puoi inviare all'API di controllo della luce per impostare il livello della luce al 50% utilizzando la temperatura di colore della luce diurna:
{
"brightness": "50",
"colorTemperature": "daylight"
}
Questo tutorial mostra come configurare una chiamata di funzione per l'API Gemini interpretare le richieste di illuminazione degli utenti e mapparle alle impostazioni API per controllare i valori di luminosità e temperatura di colore della luce.