Sejħa għall-funzjoni fl-API ta’ OpenAI

Is-sejħa għall-funzjoni tippermettilek tqabbad il-mudelli ta’ OpenAI ma’ għodod u sistemi esterni. Dan huwa utli għal ħafna skopijiet, bħall-għoti ta’ kapaċitajiet lill-assistenti tal-IA jew il-ħolqien ta’ integrazzjonijiet profondi bejn l-applikazzjonijiet tiegħek u l-LLMs.

Sir af aktar fil-gwida għall-iżviluppaturi dwar is-sejħa għall-funzjoni.

F’Ġunju 2024, nedejna l-outputs strutturati. Fuq mudelli u konfigurazzjonijiet ta’ talbiet appoġġjati, meta l-mudell joħroġ sejħa għall-funzjoni, l-issettjar ta’ strict: true fid-definizzjoni tal-funzjoni tiegħek jiżgura li l-argumenti ġġenerati jikkonformaw mal-iskemi pprovduti, dment li dawn jużaw is-subsett appoġġjat ta’ JSON Schema u jissodisfaw ir-rekwiżiti tal-modalità stretta. Talbiet bi skemi mhux appoġġjati jew mhux konformi jiġu miċħuda bi żball.

F’Ottubru 2024, nedejna l-karatteristika “Iġġenera Kwalunkwe Ħaġa”, li tippermetti lill-iżviluppaturi jiddeskrivu funzjoni, iwaħħluha direttament jew iwaħħlu l-kodiċi tagħhom u jiġġeneraw skemi valida tal-funzjoni. Sir af aktar dwar “Iġġenera Kwalunkwe Ħaġa” f’dan l-artiklu taċ-ċentru tal-għajnuna.

Kif nista’ nuża s-sejħa għall-funzjoni?

Is-sejħa għall-funzjoni hija utli għal għadd kbir ta’ każijiet ta’ użu, bħal:

• Li tippermetti lill-assistenti jiksbu d-dejta:

• Li tippermetti lill-assistenti jieħdu azzjonijiet:

• Li tippermetti lill-assistenti jwettqu komputazzjoni:

• Il-bini ta’ flussi tax-xogħol rikki:

• pipeline għall-estrazzjoni tad-dejta li jġib test mhux ipproċessat, imbagħad jikkonvertih f’dejta strutturata u jsalvah f’bażi tad-dejta.

Is-sejħa għall-funzjoni hija appoġġjata fl-API tar-Responses, li tgħaqqad kapaċitajiet li qabel kienu maqsuma bejn l-API tat-tlestija taċ-chats u l-API tal-Assistenti.

Kif nista’ nuża l-modalità JSON?

Meta l-modalità JSON tkun mixgħula, jiġi żgurat li l-output tal-mudell ikun JSON validu, ħlief f’xi każijiet marġinali li għandek tiskopri u timmaniġġja kif xieraq.

Biex titlob il-modalità JSON bl-API tat-tlestija taċ-chats, issettja response_format għal { "type": "json_object" } fuq mudelli appoġġjati. Bl-API tar-Responses, issettja text.format għal { "type": "json_object" }, pereżempju text: { "format": { "type": "json_object" } }, fejn applikabbli. Fi kwalunkwe API, il-modalità JSON taħdem biss meta jiġu ssodisfati l-prerekwiżiti tal-mudell/messaġġ/għodda (pereżempju, il-mudell jappoġġja json_object, il-konverżazzjoni tinkludi istruzzjonijiet biex tipproduċi JSON, u kwalunkwe restrizzjoni tal-għodda tkun kompatibbli). Mill-inqas messaġġ wieħed tat-talba jew messaġġ tal-input fil-kuntest effettiv tal-input għandu jkun fih json f’forma mhux sensittiva għall-ittri kbar/żgħar, bħal JSON, json, jew Json; inkella, l-API tirritorna żball. F’Responses, il-qasam tal-istruzzjonijiet tal-ogħla livell waħdu ma jissodisfax din il-validazzjoni. Meta tintuża sejħa għall-funzjoni fuq mudelli/mogħdijiet kompatibbli, ir-restrizzjonijiet JSON jiġu applikati awtomatikament għall-argumenti tas-sejħa tal-funzjoni; mudelli inkompatibbli jew kombinazzjonijiet ta’ għodda/format tar-rispons jistgħu jiġu miċħuda jew jistgħu ma jużawx kampjunar ristrett għal JSON.

Noti importanti:

• Meta tuża l-modalità JSON, dejjem trid tagħti istruzzjoni lill-mudell biex jipproduċi JSON permezz ta’ xi messaġġ fil-konverżazzjoni, pereżempju permezz tal-messaġġ tas-sistema tiegħek. Jekk ma tinkludix istruzzjoni espliċita biex tiġġenera JSON, il-mudell jista’ jiġġenera fluss bla tmiem ta’ spazji vojta u t-talba tista’ tibqa’ għaddejja sakemm tilħaq il-limitu tat-token. Biex ngħinuk ma tinsiex, il-modalità JSON tirrifjuta talbiet sakemm il-messaġġi tal-input jew l-istruzzjonijiet rilevanti ma jkunux fihom il-kelma json f’xi forma, mingħajr sensittività għall-ittri kbar/żgħar.

• Il-modalità JSON ma tiggarantixxix li l-output jaqbel ma’ xi skema speċifika, iżda biss li jkun validu u jiġi analizzat mingħajr żbalji. Għandek tuża outputs strutturati biex tiżgura li jaqbel mal-iskema tiegħek, jew jekk dan ma jkunx possibbli, għandek tuża librerija ta’ validazzjoni u potenzjalment tentattivi mill-ġdid biex tiżgura li l-output jaqbel mal-iskema mixtieqa tiegħek.

• L-applikazzjoni tiegħek trid tiskopri u timmaniġġja l-każijiet marġinali li jistgħu jwasslu biex l-output tal-mudell ma jkunx oġġett JSON komplut (ara hawn taħt)