Thirrja e funksionit e bën më të lehtë për ju marrjen e rezultateve të strukturuara të të dhënave nga modelet gjeneruese. Më pas mund t'i përdorni këto rezultate për të thirrur API-të e tjera dhe për të kthyer të dhënat përkatëse të përgjigjes në model. Me fjalë të tjera, thirrja e funksionit ju ndihmon të lidhni modelet gjeneruese me sistemet e jashtme në mënyrë që përmbajtja e krijuar të përfshijë informacionin më të përditësuar dhe të saktë.
Ju mund t'u jepni modeleve të Binjakëve përshkrime të funksioneve. Këto janë funksione që i shkruani në gjuhën e aplikacionit tuaj (d.m.th., ato nuk janë funksione të resë kompjuterike të Google). Modeli mund t'ju kërkojë të telefononi një funksion dhe të dërgoni rezultatin për të ndihmuar modelin të trajtojë pyetjen tuaj.
Nëse nuk e keni bërë tashmë, shikoni Hyrje në thirrjet funksionale për të mësuar më shumë.
Shembull API për kontrollin e ndriçimit
Imagjinoni që keni një sistem bazë të kontrollit të ndriçimit me një ndërfaqe programimi aplikacioni (API) dhe dëshironi të lejoni përdoruesit të kontrollojnë dritat përmes kërkesave të thjeshta me tekst. Mund të përdorni funksionin "Thirrja e funksionit" për të interpretuar kërkesat për ndryshimin e ndriçimit nga përdoruesit dhe për t'i përkthyer ato në thirrje API për të vendosur vlerat e ndriçimit. Ky sistem hipotetik i kontrollit të ndriçimit ju lejon të kontrolloni ndriçimin e dritës dhe temperaturën e ngjyrës, të përcaktuar si dy parametra të veçantë:
| Parametri | Lloji | E detyrueshme | Përshkrimi |
|---|---|---|---|
brightness | numri | po | Niveli i dritës nga 0 në 100. Zero është i fikur dhe 100 është ndriçimi i plotë. |
colorTemperature | varg | po | Temperatura e ngjyrës së pajisjes së dritës e cila mund të jetë daylight , cool ose warm . |
Për thjeshtësi, ky sistem imagjinar ndriçimi ka vetëm një dritë, kështu që përdoruesi nuk duhet të specifikojë një dhomë ose vendndodhje. Këtu është një shembull i kërkesës JSON që mund ta dërgoni në API të kontrollit të ndriçimit për të ndryshuar nivelin e dritës në 50% duke përdorur temperaturën e ngjyrës së dritës së ditës:
{
"brightness": "50",
"colorTemperature": "daylight"
}
Ky udhëzues ju tregon se si të konfiguroni një Thirrje Funksioni për Gemini API për të interpretuar kërkesat e përdoruesve për ndriçimin dhe për t'i hartuar ato në cilësimet e API për të kontrolluar ndriçimin e dritës dhe vlerat e temperaturës së ngjyrës.