OpenAI
Boggan si mashiin ah ayaa loo turjumay. Eeg maqaalka asalka ah ee Ingiriisiga ahaa.

Xusida function-ka ee OpenAI API

Waa maxay xusida function-ka, sideese uga shaqaysaa OpenAI API?

La cusboonaysiiyay: 21 hours ago

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 xidho qalab iyo nidaamyo dibadeed. Tani waxyaabo badan ayay faa'iido u leedahay, sida in kaaliyeyaasha AI-ga lagu xoojiyo awoodo dheeraad ah ama in barnaamijyadaada iyo LLM-yada si qoto dheer la isugu xidho.

Wax badan ka ogow hagahayaga horumariyeyaasha ee xusida function-ka.

Bishii Juun 2024, waxaan soo saarnay soo saaridyo habeysan. Noocyada iyo habaynnada codsiga ee la taageero, marka noocu soo saaro xusida function-ka, dejinta strict: true ee qeexidda function-kaaga waxay xaqiijinaysaa in doodaha la sameeyey ay waafaqaan bandhig-qorshaha la bixiyey, haddii bandhig-qorshuhu adeegsado qaybta la taageero ee JSON Schema oo uu buuxiyo shuruudaha habka adag. Codsiyada leh bandhig-qorshe aan la taageerin ama aan waafaqsanayn waa la diidaa, khaladna waa la soo celiyaa.

Bishii Oktoobar 2024, waxaan soo saarnay sifada 'Wax kasta samee', taas oo horumariyeyaasha u oggolaanaysa inay sharraxaan function, si toos ah ugu dhejiyaan sharraxaaddaas ama koodhkooda, dabadeedna sameeyaan bandhig-qorshe function oo sax ah. Wax badan oo ku saabsan 'Wax kasta samee' ka akhri maqaalkan xarunta caawimada

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 json qaab 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)

Maqaalkani faa'iido ma kuu lahaa?