Laga bilaabo Maarso 11, 2025, waxaan sii deynay qaybaha aasaasiga ah ee madalkeenna cusub ee wakiil. Faahfaahin, ka eeg dukumentiyada API-ga ee Responses API, Tools oo ay ku jiraan Web Search, File Search, iyo Computer Use, iyo Agents SDK oo leh Tracing.
Xusida function-ka waxay kuu oggolaanaysaa inaad noocyada OpenAI ku xirto qalab iyo nidaamyo dibadeed. Tani waxay waxtar u leedahay waxyaabo badan, sida in kaaliyayaasha AI lagu xoojiyo awood dheeraad ah, ama in la dhiso is-dhexgal qoto dheer oo u dhexeeya codsiyadaada iyo LLM (Qaabka Luuqadda Ballaaran).
Wax badan ka baro hagahayaga horumariyaha ee xusida function-ka.
Bishii Juun 2024, waxaan daahfurnay soo saaridyo habeysan. Markaad shiddo adigoo dhigaya strict: true qeexidda function-kaaga, soo saaridyo habeysan waxay dammaanad qaadaan in doodaha uu noocu u abuuro xusida function-ka ay si sax ah ugu dhigmaan JSON Schema-ga aad ku bixisay qeexidda function-ka.
Bishii Oktoobar 2024, waxaan daahfurnay muuqaalka “Soo saar Wax Kasta”, kaas oo horumariyayaasha u oggolaanaya inay function sharxaan, si toos ah u geliyaan ama ay koodhkooda geliyaan oo ay abuuraan bandhig-qorshe function oo sax ah. Wax badan oo ku saabsan “Soo saar Wax Kasta” ka baro maqaalka xarunta caawinta ee halkan
Sideen u isticmaali karaa xusida function-ka?
Xusida function-ka waxay waxtar u leedahay xaalado adeegsi oo badan, sida:
U suuragelinta kaaliyayaasha inay xog soo qaataan:
U suuragelinta kaaliyayaasha inay ficillo qaadaan:
U suuragelinta kaaliyayaasha inay xisaabin sameeyaan:
Dhisidda socod-shaqooyin hodan ah:
pipeline soo-saaris xog oo soo qaada qoraal cayriin, ka dibna u beddela xog habeysan oo ku kaydiya database.
Xusida function-ka waxaa lagu taageeraa API-ga Responses, kaas oo mideeya awoodihii hore loogu kala qaybiyey API-ga dhammeystirka wada-sheekeysiga iyo API-ga Assistants.
Sideen u isticmaali karaa habka JSON?
Marka habka JSON la shido, soo-saarka nooca waxaa la hubiyaa inuu yahay JSON sax ah, marka laga reebo xaalado gees ah oo ay tahay inaad ogaato oo si habboon u maareyso.
Si aad habka JSON uga codsato API-ga dhammeystirka wada-sheekeysiga, dhig response_format inuu noqdo { "type": "json_object" } noocyada la taageero. API-ga Responses, dhig text.format inuu noqdo { "type": "json_object" }, tusaale ahaan text: { "format": { "type": "json_object" } }, halka ay khusayso. Labada API midkood, habka JSON wuxuu shaqeeyaa oo keliya marka shuruudaha nooca/farriinta/qalabka la buuxiyo (tusaale ahaan, noocu taageero json_object, wada-sheekeysigu ku jiro tilmaamo lagu soo saaro JSON, iyo xannibaadaha qalabku is waafaqaan). Ugu yaraan hal farriin codsi ama farriin gelin oo ku jirta macnaha gelinta ee shaqaynaya waa inay ku jirtaa json qaab aan kala saarayn xarfo waaweyn iyo yaryar, sida JSON, json, ama Json; haddii kale, API-gu wuxuu soo celinayaa khalad. Responses dhexdeeda, field-ka tilmaamaha heerka-sare keligii ma buuxiyo xaqiijintan. Marka xusida function-ka lagu isticmaalo noocyo/waddooyin ku habboon, xannibaadaha JSON si toos ah ayaa loogu dabaqaa doodaha xusida function-ka; noocyo aan ku habboonayn ama isku-darrooyinka qalab/qaab-jawaab ayaa la diidi karaa ama ma isticmaali karaan muunad-qaadis JSON ku xaddidan.
Qoraallo muhiim ah:
Markaad isticmaalayso habka JSON, waa inaad had iyo jeer nooca ku amartaa inuu soo saaro JSON adigoo adeegsanaya farriin ka mid ah wada-sheekeysiga, tusaale ahaan farriintaada nidaamka. Haddii aadan ku darin tilmaam cad oo lagu abuurayo JSON, noocu wuxuu dhalin karaa qulqul aan dhammaanayn oo bannaan, codsiguna wuu sii socon karaa ilaa uu gaaro xadka token-ka. Si lagaa caawiyo inaadan illoobin, habka JSON wuxuu diidaa codsiyada haddii farriimaha gelinta ama tilmaamaha khuseeya aysan ku jirin erayga
jsonqaab kasta, iyadoo aan la kala saarayn xarfo waaweyn iyo yaryar.Habka JSON ma dammaanad qaadayo in soo-saarku u dhigmo bandhig-qorshe gaar ah; wuxuu dammaanad qaadaa oo keliya inuu sax yahay oo si khalad la’aan ah loo parse-gareyn karo. Waa inaad isticmaashaa soo saaridyo habeysan si aad u hubiso inuu u dhigmo bandhig-qorshahaaga, ama haddii taasi suurtagal ahayn, waa inaad isticmaashaa maktabad xaqiijin iyo suurtagal ahaan isku-dayo celis ah si aad u hubiso in soo-saarku u dhigmo bandhig-qorshaha aad rabto.
Codsigaagu waa inuu ogaadaa oo maareeyaa xaaladaha geeska ah ee keeni kara in soo-saarka noocu uusan noqon shay JSON oo dhammeystiran (hoos eeg)
