Laga bilaabo nooc ilaa wakiil: Ku qalabaynta Responses API deegaan kombiyuutar

Waxaan hadda ku jirnaa isbeddel ka imanaya isticmaalka noocyada, kuwaas oo ku fiican hawlo gaar ah, una gudbaya isticmaalka wakiillo awood u leh inay maareeyaan socod-shaqooyin adag. Adigoo noocyada siinaya weydiin, waxaad heli kartaa oo keliya caqli lagu tababaray. Hase yeeshee, siinta nooca deegaan kombiyuutar waxay suurtagelin kartaa adeegsi aad uga ballaaran, sida socodsiinta adeegyo, ka codsashada xog API-yo, ama soo saarista wax-soo-saar waxtar badan leh sida xaashiyo-xisaabeed ama warbixinno.

Dhowr dhibaato oo wax-ku-ool ah ayaa soo baxa marka aad isku daydo inaad dhisto wakiillo: halka la dhigayo faylasha ku-meelgaarka ah, sida looga fogaado ku dhejinta jadwallo waaweyn weydiin gudaheeda, sida socod-shaqada loo siiyo marin shabakad iyada oo aan dhibaato amni la abuurin, iyo sida loo maareeyo waqtigu-dhammaadka iyo isku-dayga mar kale adigoon nidaam socod-shaqo adigu dhisan.

Halkii horumariyeyaasha looga tegi lahaa inay dhistaan deegaannadooda fulineed, waxaan dhisnay qaybaha lagama maarmaanka ah si loogu qalabeeyo Responses API⁠(ku furmaa daaqad cusub) deegaan kombiyuutar oo si lagu kalsoonaan karo u fulin kara hawlo dunida-dhabta ah.

Responses API-ga OpenAI, oo ay weheliyaan shell tool-ka iyo goob shaqo oo weel la martigeliyey, waxaa loo naqshadeeyey inay wax ka qabtaan dhibaatooyinkan wax-ku-oolka ah. Noocku wuxuu soo jeediyaa tillaabooyin iyo amarro; madalkuna waxay ku socodsiisaa deegaan go'doonsan oo leh nidaam faylal oo loogu talagalay gelinnada iyo soo-saarrada, kaydin habaysan oo ikhtiyaari ah (sida SQLite), iyo marin shabakad oo xaddidan.

Qoraalkan, waxaan faahfaahin doonnaa sida aan ugu dhisnay deegaan kombiyuutar wakiillo, waxaana wadaagi doonnaa casharro hore oo ku saabsan sida loogu isticmaalo socod-shaqooyin wax-soo-saar ah oo ka dheereeya, la soo celin karo, kana ammaan badan.

Socod-shaqo wakiil oo wanaagsan wuxuu ka bilaabmaa wareeg fulin oo adag: noocku wuxuu soo jeediyaa fal sida akhrinta faylal ama xog ku soo qaadashada API, madalkuna way socodsiisaa, natiijaduna waxay quudisaa tallaabada xigta. Waxaan ku bilaabi doonnaa shell tool-ka—habka ugu fudud ee lagu arki karo wareeggan isagoo shaqaynaya—kadibna waxaan ka hadli doonnaa goobta shaqo ee weelka, isku xidhka shabakadda, xirfadaha dib loo isticmaali karo, iyo isku-koobidda macnaha guud.

Si loo fahmo shell tool-ka, marka hore waa faa'iido in la fahmo sida nooc luuqadeed u adeegsado qalab guud ahaan: si uu u qabto waxyaabo ay ka mid yihiin wicitaanka hawl ama la falgalka kombiyuutar. Inta lagu jiro tababarka, nooc ayaa la tusaa tusaalooyin muujinaya sida qalabka loo adeegsado iyo saamaynta ka dhalata, tallaabo tallaabo. Tani waxay ka caawisaa nooca inuu barto goorta la isticmaalayo qalab iyo sida loo isticmaalo. Marka aan nidhaahno “adeegsiga qalab”, waxaan ula jeednaa in noocku dhab ahaantii uu soo jeediyo oo keliya wicitaan qalab. Isagu kaligiis ma fulin karo wicitaankaas.

Shell tool-ku wuxuu ka dhigaa nooca mid aad uga awood badan: wuxuu la falgalaa kombiyuutar isagoo adeegsanaya khadka amarada si uu u fuliyo hawlo kala duwan oo ballaaran, laga bilaabo raadinta qoraal ilaa dirista codsiyo API oo ku socda kombiyuutarkaaga. Iyada oo lagu dhisay qalabkii caanka ahaa ee Unix, shell tool-keennu wuxuu qaban karaa wax kasta oo aad filan lahayd, iyadoo qalabyo sida grep, curl, iyo awk ay diyaar yihiin markiiba.

Marka loo eego code interpreter-keenna jira, kaas oo kaliya fuliya Python, shell tool-ku wuxuu suurtageliyaa adeegsi aad uga ballaaran, sida socodsiinta barnaamijyada Go ama Java ama bilaabista server NodeJS ah. Dabacsanaantani waxay u saamaxdaa noocka inuu fuliyo hawlo wakiilnimo oo adag.

Kaligiis, nooc wuxuu soo jeedin karaa oo keliya amarro shell ah, balse sidee baa amaradan loo fuliyaa? Waxaan u baahanahay isku-dubbaride si uu u helo wax-soo-saarka nooca, u kiciyo qalabka, uguna celiyo jawaabta qalabka nooca wareeg ahaan, ilaa hawshu ka dhammaato.

Responses API waa sida horumariyayaashu ula falgalaan noocyada OpenAI. Marka lala isticmaalo qalab gaar loo sameeyey, Responses API waxay xakamaynta dib ugu celisaa macmiilka, macmiilkuna wuxuu u baahan yahay harness u gaar ah oo qalabka ku socodsiinaya. Hase yeeshee, API-gani waxa kale oo uu si toos ah u isku-dubbaridi karaa nooca iyo qalabka la martigeliyey.

Marka Responses API hesho weydiin, waxay isu geysaa macnaha guud ee nooca: weydiinta isticmaalaha, xaaladdii wada hadalka ee hore, iyo tilmaamaha qalabka. Si fulinta shell-ku u shaqayso, weydiintu waa inay xustaa isticmaalka shell tool-ka iyo nooca la doortay waa inuu u tababaran yahay inuu soo jeediyo amarro shell ah—noocyada GPT‑5.2 iyo wixii ka dambeeya waa loo tababaray arrintan. Macnaha guud oo dhan marka la helo, noocku wuxuu go'aamiyaa tallaabada xigta. Haddii uu doorto fulinta shell, wuxuu ku celiyaa hal ama in ka badan oo amarro shell ah adeegga Responses API. Adeegga API-gu wuxuu amaradaas u gudbiyaa wakhti-socodka weelka, dibna u soo qulquliyaa wax-soo-saarka shell-ka, wuxuuna ku quudiyaa nooca macnaha guud ee codsiga xiga. Noocku markaas wuu eegi karaa natiijooyinka, soo saari karaa amarro daba-gal ah, ama bixin karaa jawaab kama dambays ah. Responses API waxay ku celcelisaa wareeggan ilaa noocku soo celiyo dhammaystir aan lahayn amarro shell oo dheeraad ah.

Marka Responses API fuliso amar shell ah, waxay ilaalisaa isku xidh qulqulaya oo ay la leedahay adeegga weelka. Marka wax-soo-saar la soo saaro, API-gu wuxuu ugu gudbiyaa nooca ku dhowaad waqtiga-dhabta ah si noocku u go'aansado inuu sugo wax-soo-saar dheeraad ah, socodsiiyo amar kale, ama u gudbo jawaab kama dambays ah.

Noocku wuxuu soo jeedin karaa amarro shell oo badan hal tallaabo gudaheed, Responses API-na waxay si isku mar ah ugu fulin kartaa kulammo weel oo kala gooni ah. Kulan kastaa si madax-bannaan buu u soo qulquliyaa wax-soo-saarka, API-guna wuxuu qulqulladaas isugu daraa wax-soo-saarro qalab oo habaysan oo noqda macnaha guud. Si kale haddii loo dhigo, wareegga wakiilku wuxuu barbar socodsiin karaa shaqada, sida raadinta faylal, soo qaadashada xog, iyo xaqiijinta natiijooyinka ku-meelgaarka ah.

Marka amarku ku lug leeyahay hawlgallo faylal ama farsamaynta xogta, wax-soo-saarka shell-ku wuxuu noqon karaa mid aad u weyn oo cuna miisaaniyadda macnaha guud isaga oo aan ku darin calaamado faa'iido leh. Si tan loo xakameeyo, noocku wuxuu qeexaa xad wax-soo-saar amar kasta. Responses API ayaa dhaqangelisa xadkaas waxayna soo celisaa natiijo xadidan oo ilaalinaysa bilowga iyo dhammaadka wax-soo-saarka, iyadoo calaamadaynaysa waxa la reebay. Tusaale ahaan, waxaad ku xaddidi kartaa wax-soo-saarka 1,000 xaraf, iyadoo la ilaalinayo bilowga iyo dhammaadka:

qoraal bilowga yaal ... 1000 xaraf oo la jaray ... qoraal dhammaadka yaal

Marka la isku daro, fulinta isku mar ah iyo wax-soo-saar xaddidan waxay ka dhigaan wareegga wakiilka mid degdeg ah isla markaana ku filan macnaha guud, si noocku ugu sii wado caqliyeynta natiijooyinka khuseeya halkii uu kaga mashquuli lahaa diiwaannada terminal-ka ee cayriin.

Hal dhibaato oo suurtagal ah oo ka dhalan karta wareegyada wakiilka waa in hawshu socon karto muddo dheer. Hawlaha dheer waxay buuxiyaan daaqadda macnaha guud, taas oo muhiim u ah bixinta macnaha guud ee wareegyada iyo wakiillada dhexdooda. Qiyaas wakiil yeedhanaya xirfad, helaya jawaab, ku daraya wicitaanno qalab iyo soo-koobyo caqliyeyn ah—daqadda macnaha guud ee xaddidan si degdeg ah ayey u buuxsantaa. Si looga fogaado luminta macnaha guud ee muhiimka ah inta wakiilku sii shaqaynayo, waxaan u baahanahay hab lagu hayo faahfaahinta muhiimka ah laguna saaro wax kasta oo dheeraad ah. Halkii aan horumariyeyaasha uga baahnaan lahayn inay naqshadeeyaan oo ay ilaaliyaan nidaamyo gaar ah oo soo-koobid ama gudbin xaalad ah, waxaan ku darnay isku-koobid asal ahaan ugu jirta Responses API, oo loo naqshadeeyey inay la jaanqaaddo sida noocku u dhaqmo iyo sida loo tababaray.

Noocyadeenna ugu dambeeya waxaa loo tababaray inay falanqeeyaan xaaladdii wada hadalka ee hore ayna soo saaraan shay isku-koobid ah oo ilaalinaya xaaladdii muhiimka ahayd ee hore qaab qarsoon oo token-ku-ku-ool ah. Isku-koobidda ka dib, daaqadda macnaha guud ee xigta waxay ka koobnaanaysaa shaygan isku-koobidda ah iyo qaybaha qiimaha sare leh ee daaqaddii hore. Tani waxay u oggolaanaysaa socod-shaqooyinka inay si isku xidhan u sii socdaan xuduudaha daaqadda, xitaa kulammo dheer oo tillaabooyin badan leh iyo kuwa qalabku hoggaamiyo. Codex wuxuu ku tiirsan yahay farsamadan si uu u sii wado hawlaha koodh qorista ee muddada dheer iyo fulinta qalab ee ku celceliska ah iyada oo aan tayadu hoos u dhicin.

Isku-koobiddu waxay diyaar ku tahay laba qaab: mid si ku-dhisan server-ka ah ama mid loo maro bar-dhammaadka goonida ah ee /compact. Isku-koobidda dhinaca server-ka waxay kuu oggolaanaysaa inaad dejiso xad, nidaamkuna si toos ah ayuu u maareeyaa goorta la isku-koobayo, taas oo meesha ka saaraysa baahida loo qabo caqli badan oo dhinaca macmiilka ah. Waxay u oggolaanaysaa daaqad gelin macne guud oo wax yar ka weyn si ay u dulqaadato ka-badnaan yar wax yar ka hor isku-koobidda, si codsiyada ku dhow xadka weli loo farsameeyo loona isku-koobo halkii la diidi lahaa. Marka tababarka noocyadu sii kobco, xalka isku-koobidda asalka ahi wuu la kobcaa sii-deyn kasta oo nooc OpenAI ah.

Codex wuxuu naga caawiyey dhismaha nidaamka isku-koobidda isaga oo noqday isticmaale hore. Marka hal tusaale oo Codex ah uu ku dhaco qalad isku-koobid, waxaan kicin jirnay tusaale labaad si uu u baaro. Natiijadu waxay noqotay in Codex uu helay nidaam isku-koobid asal ah oo wax ku ool ah isagoo keliya ka shaqaynaya dhibaatada. Awooddan Codex ee ah inuu iskiis isu baaro oo isu sifeeyo ayaa noqotay qayb gaar ahaan xiiso leh oo ka mid ah ka shaqaynta OpenAI. Qalabka badankiisu waxay kaliya uga baahan yihiin isticmaalaha inuu barto sida loo isticmaalo; Codex-na wuu nala bartaa.

Hadda aan daboolno xaaladda iyo kheyraadka. Weelku ma aha oo keliya meel lagu socodsiiyo amarro, balse sidoo kale waa macnaha guud ee shaqada ee noocka. Gudaha weelka, noocku wuxuu akhrin karaa faylal, waydiin karaa keyd-xogeedyo, wuxuuna geli karaa nidaamyo dibadeed iyadoo la raacayo xakamaynta siyaasadaha shabakadda.

Qaybta koowaad ee macnaha guud ee weelka waa nidaamka faylka ee loogu talagalay gelinta, habaynta, iyo maareynta kheyraadka. Waxaan dhisnay API-yada weelka iyo faylka⁠(ku furmaa daaqad cusub) si aan noocka u siino khariidad muujinaysa xogta la heli karo ugana caawino inuu doorto hawlgallo faylal oo bartilmaameed leh halkii uu ka samayn lahaa baaritaanno ballaaran oo buuq badan.

Qaab khaldan oo caadi ah waa in gelinta oo dhan si toos ah loogu rido macnaha guud ee weydiinta. Marka gelinnadu koraan, weydiinta oo la buux-dhaafiyo waxay noqotaa qaali oo ku adag noocka inuu dhex maro. Qaab ka wanaagsan waa in kheyraadka lagu diyaariyo nidaamka faylka ee weelka loona daayo noocka inuu go'aamiyo waxa la furayo, la falanqaynayo, ama lagu beddelayo amarro shell ah. Sida dadka oo kale, noocyadu si ka wanaagsan bay ula shaqeeyaan xog abaabulan.

Qaybta labaad ee macnaha guud ee weelka waa keyd-xogeedyo. Xaalado badan, waxaan horumariyeyaasha u soo jeedinnaa inay ku kaydiyaan xogta habaysan keyd-xogeedyo sida SQLite oo ay waydiiyaan. Tusaale ahaan, halkii xaashi-xisaabeed dhan loogu koobi lahaa weydiinta gudaheeda, waxaad siin kartaa noocka sharaxaad miisaska ku saabsan—tiirarka jira iyo waxa ay ka dhigan yihiin—kadibna u oggolow inuu soo qaato safafka uu u baahan yahay.

Tusaale ahaan, haddii aad waydiiso, “Alaabtee ayaa iibkoodu hoos u dhacay rubucan?” noocku wuxuu waydiin karaa keliya safafka khuseeya halkii uu ka baari lahaa xaashi-xisaabeedka oo dhan. Tani waa ka dhakhso badan tahay, ka jaban tahay, waxayna si fiican ugu miisaaman tahay xog-ururinno waaweyn.

Qaybta saddexaad ee macnaha container-ka waa helitaanka shabakadda, oo ah qayb lama huraan u ah culaysyada shaqo ee wakiillada. Socodka shaqada wakiilka wuxuu u baahan karaa inuu soo qaato xog toos ah, u yeedho API-yo dibadeed, ama rakibo xirmooyin. Isla waqtigaas, siinta container-rada gelitaan internet aan xad lahayn waxay noqon kartaa khatar: waxay macluumaad u bandhigi kartaa mareegaha dibadda, si aan ula kac ahayn u taaban kartaa nidaamyo xasaasi ah oo gudaha ah ama dhinac saddexaad ah, ama ka dhigi kartaa daadinta aqoonsiyada iyo saarista xogta kuwo adag in laga ilaaliyo.

Si loo xalliyo walaacyadan iyada oo aan la xaddidayn faa’iidada wakiillada, waxaan dhisnay container-ro martigelisan oo adeegsada sidecar egress proxy. Dhammaan codsiyada shabakaddu marka ay bannaanka u baxayaan waxay maraan lakab siyaasad dhexe ah oo dhaqan geliya liisaska la oggol yahay iyo xakamaynta gelitaanka, iyadoo weliba taraafikada laga dhigay mid la arki karo. Aqoonsiyada, waxaan u adeegsannaa gelin sir ah oo ku xaddidan domain-ka marka ay taraafikadu baxeyso. Nooca iyo container-ku waxay arkaan oo keliya placeholders, halka qiyamka sirta ee dhabta ah ay ka baxsan yihiin macnaha noocku arki karo waxaana lagu dabaqaa oo keliya meelaha loo oggolaaday. Tani waxay yareynaysaa khatarta daadinta iyadoo weli suuragelinaysa wicitaanno dibadeed oo la aqoonsan yahay.

Amarka shell-ku waa awood badan yihiin, laakiin hawlo badan ayaa ku celiya isla qaabab tallaabooyin badan leh. Wakiilladu waa inay mar kasta dib u ogaadaan socodka shaqada—dib u qorsheeyaan, dib u diraan amarrada, oo dib u bartaan caadooyinka—taas oo keenta natiijooyin aan joogto ahayn iyo fulin khasaaraysa. Xirfadaha wakiilka⁠(ku furmaa daaqad cusub) waxay qaabeeyaan qaababkaas iyagoo ka dhigaya dhismooyin dib loo adeegsan karo oo la isu geyn karo. Si muuqata, xirfaddu waa xirmo gal ah oo ka kooban ‘SKILL.md⁠(ku furmaa daaqad cusub)’ (oo wata metadata iyo tilmaamo) iyo khayraad kasta oo taageero ah, sida sifooyinka API iyo agabka UI.

Qaab-dhismeedkan si dabiici ah ayuu ula jaanqaadaa naqshadda runtime-ka ee aan hore u sharaxnay. Container-ku wuxuu bixiyaa faylal waara iyo macnaha fulinta, qalabka shell-kuna wuxuu bixiyaa isdhexgalka fulinta. Markay labaduba jiraan, noocku wuxuu ogaan karaa faylasha xirfadda isagoo adeegsanaya amarrada shell-ka (`ls`, `cat`, iwm.) marka uu u baahdo, fahmi karaa tilmaamaha, kuna socodsiin karaa qoraallada xirfadda isla wareegga wakiilka gudaheeda.

Waxaan bixinnaa API-yo⁠(ku furmaa daaqad cusub) lagu maareeyo xirfadaha gudaha madasha OpenAI. Horumariyayaashu waxay soo geliyaan oo kaydiyaan galalka xirfadda sidii xirmooyin noocyo leh, kuwaas oo mar dambe lagu soo ceshan karo aqoonsiga xirfadda. Ka hor inta aan weydiinta loo dirin nooca, Responses API wuxuu soo raraa xirfadda wuxuuna ku daraa macnaha nooca. Taxanahani waa go’an:

1. Soo qaad metadata-ga xirfadda, oo ay ku jiraan magaca iyo sharaxaadda.
2. Soo qaad xirmada xirfadda, ku koobbi gudaha container-ka, dabadeedna kala furfur.
3. Cusboonaysii macnaha nooca metadata-ga xirfadda iyo waddada container-ka.

Marka uu go’aaminayo in xirfaddu khusaynayso iyo in kale, noocku si tartiib-tartiib ah ayuu u sahamiyaa tilmaamaheeda, wuxuuna qoraalladeeda ku fuliyaa amarrada shell-ka ee gudaha container-ka.

Si loo isu geeyo dhammaan qaybaha: Responses API wuxuu bixiyaa hagid, qalabka shell-ka wuxuu bixiyaa ficillo la fulin karo, container-ka martigelisan wuxuu bixiyaa macnaha runtime-ka ee waara, xirfadaha waxay kor saaraan macquulka socod shaqo ee dib loo adeegsan karo, halka isku-koobiddu u oggolaanayso wakiil inuu muddo dheer socdo isaga oo wata macnaha uu u baahan yahay.

Asaasyadan, hal weydiin ayaa ku fidi karta socod-shaqo bilow-ilaa-dhammaad ah: ogaanshaha xirfadda saxda ah, soo qaadista xogta, u beddelidda xaalad maxali ah oo habaysan, si hufan u waydiinta, iyo abuurista agab waara. 

Jaantuska hoose wuxuu muujinayaa sida nidaamkani ugu shaqeeyo abuurista xaashi xisaabeed laga sameeyo xog toos ah.

Tusaale qoto dheer oo ku saabsan isku darka qalabka shell-ka iyo deegaanka kombiyuutarka ee socod-shaqooyinka bilow-ilaa-dhammaad, eeg qoraalkeenna blog-ga horumariyaha⁠(ku furmaa daaqad cusub) iyo cookbook⁠(ku furmaa daaqad cusub) oo sharxaya sida xirfad loo xirmo looguna fuliyo Responses API.

Waxaan ku faraxsanahay inaan aragno waxa horumariyayaashu ku dhisaan xirmadan asaasyada ah. Noocyada luuqaddu looma jeedo oo keliya inay soo saaraan qoraal, sawirro, iyo cod—waxaan sii wadi doonnaa horumarinta madalkeenna si ay uga sii awood badnaato maaraynta hawlo adag oo dunida dhabta ah ah baaxad weyn.