Indlela Yokuhlola Nokuhlaziya Amaphrojekthi E-Jev Asebenzisa Izinqumo Ezinohlobo Emhlabeni Wangempela

Yini i-awesome-jev

awesome-jev iyinkomba ekhethiwe yamaphrojekthi nemikhuba yomphakathi eyakhiwe ngokusekelwe ku-imodeli ye-Jev System One ye-TypeSafe AI. Yakhelwe ukuba umhlahlandlela wensimu osheshayo ukuwuskena, othola lapho u-Jev enza khona izinqumo ezibonakalayo nokuthi yimaphi amaphethini okusebenzisa angadluliselwa phakathi kwezimboni.

U-Jev akayona imodeli yengxoxo evamile. Uthola isimo esingahlelekile kanye nombuzo onezinhlobo ezichaziwe, bese ebuyisa isinqumo esinohlobo oluchaziwe, njengokukhetha, amaphuzu, noma i-boolean, kanye nokuzethemba. Izinhlelo zokusebenza zingasebenzisa lowo mphumela njengongqimba lwesinqumo olunezithiyo lokuhlukanisa, ukuqondisa, ukufaka amaphuzu, ukuqinisekisa, nokubeka imingcele kuma-agent.

Iphrojekthi evela ku-awesome-jev ihlangabezane nemithetho yokufakwa kwendawo yokugcina, kodwa lokho akusho ukuthi idlule ekubuyekezweni kwekhodi, ekuhlolweni kokuphepha, ekuqinisekisweni kokuphindaphindeka, noma ekuhlolweni kokuvuthwa.

Izici Ezisemqoka Zenkomba

Izigaba ezigxile ezinhlelweni zokusebenza

Into ngayinye ingeyesigaba esisodwa kuphela, esikhethwa ngokohlelo lwayo oluqondile kakhulu lwe-Jev. Inkomba yamanje ihlanganisa izindawo ezifana nalezi:

• Ukuhlukanisa nokuqondisa: ukukhetha imodeli, ukuqondisa inhloso ye-imeyili, ukuqasha, ukuhlunga isiphequluli, nokuhlukanisa amaphutha.
• Ukuqinisekisa nemingcele yokuphepha: izango zokubuyekezwa kwekhodi, ukuphepha kwezingcingo zamathuluzi, ukuhlolwa kokujova kwemiyalelo, nokuqinisekiswa kokuqedwa komsebenzi.
• Ukufaka amaphuzu nokukala: ukuhambisana kosesho, ukwesekwa kwezinkomba, ikhwalithi yekhodi, i-SEO, nokwenza imephu yesemantiki.
• Izinqumo zama-agent: izenzo zesiphequluli, izahlulelo zama-agent okubhala ikhodi, ukunciphisa umongo, nezenzo zerobhothi ezinemingcele.
• Ukulebula nokukhetha idatha: ukuhlunga amasethi edatha nokuhlukanisa izinkinga.
• Ukuhlola nokulinganisa: izivivinyo zokuqhathanisa, amathuluzi okulinganisa, namahhanisi okuhlola aphindaphindekayo.
• Ukulinganisa nocwaningo: ukuphindaphinda kwasendaweni, ezinye izindlela ezivulekile, namamodeli ezinqumo anomumo we-Jev.
• Ingqalasizinda nokuhlanganiswa: ama-SDK, ama-gateway, amathuluzi omugqa womyalo, nokuhlanganiswa kwamafreyimwokhi.
• Izigaba zezizinda: imidlalo, ukulingisa, ezezimali, ukuhweba, ukuthobela imithetho, ukuhamba komsebenzi kwezomthetho, nokwengamela okuqukethwe.
• Imikhuba nezingxoxo ezihlobene: imibiko yomphakathi ethembekile yokusetshenziswa kwangempela lapho ikhasi elizimele lephrojekthi eliqinile lingatholakali.

Indawo yokugcina iphinde iveze izigaba ezisasekwa. Isibonelo, i-README njengamanje ibala ama-Pipeline Esayensi ngaphandle kwezinto.

Izinto ezimfishane ezigxile ebufakazini

Into ngayinye eyamukelwe ixhuma emthonjeni womphakathi futhi ifingqa isimo, indlela, nenani ngomusho owodwa. Into kufanele iveze ngokusobala u-Jev, ibhekisele endleleni ye-System One ye-TypeSafe AI, noma ibonise iluphu enohlobo oluchaziwe lapho umbuzo ukhiqiza impendulo enohlobo oluchaziwe kanye nokuzethemba, bese uhlelo lokusebenza luyayamukela, luyenqabe, noma luyidlulisele ezingeni eliphezulu.

Ikhasi lasekhaya elikhiqizwayo

I-README eyinhloko ihlanganisa amafayela ezigaba. Ikhiqizwa ngu-scripts/build-readme.py, ngakho abanikeli kufanele bahlele ifayela lesigaba elifanele kunokushintsha okuqukethwe kwesigaba okukhiqiziwe ku-README kuphela.

Ukufaka Nokulungiselela

Ukuphequlula ngaphandle kokufaka

i-awesome-jev iyinkomba, hhayi i-SDK, ifreyimwokhi, noma uhlelo lokusebenza olusebenzisekayo. Ungayisebenzisa ngokuqondile ku-GitHub ngokuvula i-README, ukhethe isigaba, bese ulandela izixhumanisi eziya kumaphrojekthi ngamanye. Akudingeki ukufaka iphakheji noma imininingwane yokungena ku-API ukuze uphequlule uhlu.

Ukusebenza ngekhophi yasendaweni

Uma ufuna ukusesha amafayela endaweni noma ulungiselele umnikelo, klona indawo yokugcina usebenzisa i-URL yayo ye-GitHub:

git clone <repository-url>
cd awesome-jev

Amafayela omthombo ezigaba agcinwe ngaphansi kwe-categories/. Izibonelo eziwusizo zihlanganisa:

categories/classification-routing.md
categories/verification-guardrails.md
categories/scoring-ranking.md
categories/evaluation-benchmarking.md

Ngemva kokuhlela ifayela lesigaba, yakha kabusha i-README ehlanganisiwe nge-scripts/build-readme.py. Landela imiyalelo yendawo yokugcina mayelana nemvelo neminikelo ngaphambi kokuyisebenzisa. Uma iskripthi silungiselelwe ukusebenzisa i-Python ngokuqondile, umyalo ngokuvamile uzoba:

python scripts/build-readme.py

Bheka ku-CONTRIBUTING.md ukuze uthole imithetho egunyaziwe, ikakhulukazi leyo ephathelene nomsebenzi osizwa yi-AI, ukujula kwephrojekthi, neminikelo eminingi.

Ukusetshenziswa Okuyisisekelo: Ukuthola Iphethini Efanele Ye-Jev

Isinyathelo 1: Chaza isinqumo, hhayi imboni

Qala ngokuchaza isinqumo esincane okufanele isofthiwe yakho isenze. Buza ukuthi umphumela odingekayo uwukukhetha, amaphuzu, noma i-boolean, nokuthi yini okufanele yenzeke lapho ukuzethemba kunganele.

Inkontileka yesinqumo yomqondo ingabukeka kanje:

State: the relevant unstructured input
Question: one narrowly defined typed question
Decision: Choice | Score | Boolean
Confidence: model confidence in that decision
Action: accept | reject | escalate

Lena iphethini yomqondo, akuyona i-syntax ye-Jev API. Sebenzisa imibhalo ye-API ne-SDK exhunywe yiphrojekthi ethile oyikhethayo.

Isinyathelo 2: Khetha isigaba esiseduze nesisebenza ngokuqondile

Uma uhlelo lwakho kufanele lukhethe imodeli, luhlukanise i-imeyili, noma luqondise isicelo, qala ngokuHlukanisa nokuQondisa. Uma kufanele luvumele isenzo se-agent noma luqinisekise umsebenzi oqediwe, qala ngokuQinisekisa nemingcele yokuphepha. Sebenzisa ukuFaka Amaphuzu nokuKala lapho umphumela ngokuyinhloko uyinani elilinganisiwe noma ukuhleleka.

Ungaseshi ngemboni kuphela. Iphethini yokuqondisa esetshenziswa yi-agent yokubhala ikhodi isengadluliselwa ekusekelweni kwamakhasimende, ekucubunguleni amadokhumenti, noma kwesinye isizinda uma isinqumo esinohlobo oluchaziwe sinomumo ofanayo.

Isinyathelo 3: Qhathanisa izibonelo ezicacile

Ake sithi udinga ukuqondisa izicelo phakathi kwamamodeli. Uhla lwemibhalo lunezindlela eziningana ezifanele:

• jev-router icela i-Jev ukuthi ikhethe phakathi kwamamodeli angaba khona ngokusekelwe emsebenzini.
• pi-jev-router yengeza ukuqondiswa kwemodeli ngesicelo ngasinye ku-ejenti yokubhala ikhodi i-Pi nge-Vercel AI Gateway.
• jcm-router ikhetha imodeli ye-Claude nomzamo wokucabanga kumlayezo ngamunye, kuyilapho igcina ingxoxo eyinhloko egcinwe kunqolobane.
• duet-agent igcina ithebula lokuqondisa elisekelwe ku-Jev lokukhetha imodeli.

Lezi zinto zabelana ngephethini yokuqondisa enohlobo olucacisiwe, kodwa ziyehluka ngesikhathi sokusebenza, kuhlelo oluqondiswe kulo, nasemngceleni wokuhlanganiswa. Landela isixhumanisi somthombo ngasinye bese uhlola indlela esebenza ngayo ngaphambi kokukhetha eyodwa.

Isinyathelo 4: Landela wonke umjikelezo wokwenza isinqumo

Ukuqaliswa okuthembekile kufanele kubonise okungaphezu kwesimangalo esihlobene ne-Jev ku-README yaso. Bheka indlela ephelele:

1. Uhlelo luqoqa isimo esidingekayo ukuze kwenziwe isinqumo.
2. Luthumela umbuzo onohlobo olucacile noweqondiswe ngqo ku-Jev.
3. Luhlaziya umphumela onohlobo olucacile kanye nokuzethemba kwawo.
4. Ikhodi yohlelo iqhathanisa umphumela nenqubomgomo noma umkhawulo ochazwe ngokusobala.
5. Uhlelo lwamukela umphumela, luwenqabe, noma ludlulisele udaba ezingeni eliphezulu.

Isibonelo, ukuhlanganiswa kwe-Notra okusohlwini kuqondisa izihlukanisi zokubonakala komkhiqizo ezinqumweni ze-Jev ezingu-boolean ngaphansi kwefulegi layo elithi NOTRA_JEV_CLASSIFIERS, futhi kuchaza umkhawulo ongu-0.5. Lokhu kusebenza kakhulu kunomsebenzi osho nje ukuthi usebenzisa ukuhlukaniswa okuqhutshwa yi-AI.

Isinyathelo 5: Sebenzisa ubufakazi bephrojekthi uqobo

Uma usukhombe umuntu ongase afaneleke, phuma ohlwini lwe-awesome bese ulandela imiyalelo yokusetha yaleyo phrojekthi. Khetha kuqala izinto ezinezivivinyo, okokufaka okuyisibonelo kanye nemiphumela elindelekile, noma ukuboniswa komphakathi. Indawo yokugcina i-awesome-jev ayiqinisekisi ukuthi isofthiwe esohlwini iyahlanganiswa noma ukuthi imiphumela eshicilelwe iyaphindaphindeka.

Izibonelo Zokuhlola Ngokusebenzayo

Ukwakha isivikelo sezenzo zama-ejenti

Vula isigaba sokuQinisekisa neziVikelo lapho udinga ukuhlola isenzo ngaphambi kokusenza. Amaphethini afanele asohlwini ahlanganisa ukuhlola izingcingo zamathuluzi e-Pi eziyingozi kusetshenziswa i-pi-jev, ukuvimba ukujova imiyalelo noma izenzo eziyingozi nge-jev-guard, kanye nokuqhathanisa zonke izingcingo zamathuluzi ezidala imiphumela nohlelo lomsebenzisi nge-pi-heed.

Lapho uhlola la maphrojekthi, khomba kahle ukuthi isango lisebenza kuphi. Isango langaphambi kokwenza lingavimbela isenzo, kuyilapho umbuyekezi wangemva kokuhlela engakwazi kuphela ukuthola noma ukubika inkinga ngemva kokuba ushintsho selwenzekile.

Ukufaka amaphuzu nokuhlela kabusha imiphumela

Isigaba sokuFaka Amaphuzu nokuHlela sihlanganisa ukuhlela kabusha imiphumela yosesho, ukuqinisekiswa kwezingcaphuno, ukuhlolwa kwekhwalithi yekhodi, nokumakwa kokuqukethwe. Hlola ukuthi i-Jev ikhiqiza iphuzu elilodwa eliphelele yini noma ubukhulu obuningana obuhlanganiswa yikhodi yohlelo kamuva.

Phinde ubuyekeze isigaba sokuHlola nokuLinganisa ngaphambi kokucabanga ukuthi ukuhlela kabusha kuzothuthukisa uhlelo. Umbiko owodwa olinganisiwe osohlwini uthi ukuhlela kabusha kwe-Jev kukodwa akuzange kudlule ukubuyiswa kwe-vector kukhathalogi nesethi yemibuzo eyahlolwa. Imiphumela engemihle ingaba wusizo njengemizekelo ephumelelayo lapho ukhetha ukwakheka kohlelo.

Ukuphatha izinqumo ezinokuzethemba okuphansi

Ukuzethemba kufanele kuqhube inqubomgomo yohlelo echazwe ngokusobala, kunokuba kuboniswe bese kunganakwa. Ukwakheka okuvamile ukwamukela izinqumo ezinohlobo olucacile nezokuzethemba okuphezulu, kuyilapho amacala angaqinisekile ethunyelwa kumuntu noma kumodeli ebizayo kakhulu. Iphrojekthi esohlwini ethi jevcal ibaluleke kakhulu: ibeka imikhawulo yesicelo ngasinye ukuze ifinyelele ukunemba okuhlosiwe kudatha enamalebula, iyihlole esigabeni sedatha esigcinelwe ukuhlolwa, ibike inani lamacala adluliselwe ezingeni eliphezulu, futhi ingahluleka i-CI lapho ukubuyekezwa kwemodeli kwephula imikhawulo evaliwe.

Indlela Yokuhlola Iphrojekthi Esolwini

Ngenxa yokuthi ukukhethwa akusho ukugunyazwa, sebenzisa uhlu lokuhlola olungaguquki ngaphambi kokwamukela iphrojekthi:

1. Qinisekisa ucingo lwangempela lwe-Jev. Thola isicelo esinemibuzo enezinhlobo ezicacile kanye nekhodi ehlaziya impendulo.
2. Bheka ukuhlola okungasebenza. Khetha kuqala izivivinyo, izibonelo ezinemiphumela elindelekile, izilinganiso, noma ukuboniswa komphakathi.
3. Landela izimangalo zobuningi. Izibalo zokunemba, izindleko, ukubambezeleka, nomthamo kufanele zixhumane nobufakazi obungaphindaphindeka noma obubhalwe ngokucacile.
4. Linganisa ukujula kokuqaliswa. Thola ukuthi indawo yokugcina inekhodi esebenzayo, isakhiwo esincane nje, noma ikakhulukazi imiyalelo nemibhalo.
5. Hlola ilayisensi. Ilayisensi engekho noma engahambisani ingavimbela ukusetshenziswa kabusha nokusatshalaliswa kabusha noma ikhodi isesidlangalaleni.
6. Buyekeza umlando nabaphathi. Izindawo zokugcina ezenziwe ngosuku olufanayo ezinezizinda ezifanayo nomlando omncane wokwenza izinguquko zingase zibe semthethweni, kodwa azikafakazelwa.

Phatha izinto ezisohlwini lwemibhalo njengezinkomba zocwaningo. Hlola ngokuzimela ukuphepha, ukwethembeka, ukugcinwa kalula, namalayisensi ngaphambi kokuzisebenzisa ekukhiqizeni.

Amathiphu Athuthukile

Hlukanisa ukwahlulela kwemodeli kunqubomgomo yohlelo

Gcina isinqumo esinohlobo olucacile nokuzethemba kuhlukene nesenzo esithathwa uhlelo lwakho. Imikhawulo, izindlela zokudlulisela ezingeni eliphezulu, imikhawulo yokusebenzisa imali, nemithetho yokuphepha kufanele kuhlale kubonakala kukhodi evamile yohlelo. Lokhu kwenza kube lula ukuhlola nokushintsha ukuziphatha ngaphandle kokubhala kabusha umbuzo wesinqumo.

Khetha imibuzo eqondiswe ngqo

Izibonelo ze-Jev ezisohlwini lwemibhalo ziqine kakhulu lapho zibuza imibuzo enqunyelwe: ukuthi kukhethwe muphi umuntu ongenele, ukuthi umthetho wephuliwe yini, ukuthi ubufakazi busisekela kangakanani isimangalo, noma ukuthi umsebenzi uphelile yini. Gwema ukuphatha imodeli yesinqumo esinohlobo olucacile njengengxenye ev替ayo yokukhiqiza okuvulekile.

Yakha indlela yokungaphenduli

Ungaphoqeleli ukufanisa okubuthakathaka kube isenzo esibukeka siqinisekile. I-agent skill router esohlwini isebenzisa ngokusobala izinqumo ezazi izinga lokuzethemba, ukuze ukufanisa okubuthakathaka kwenqatshwe. Ukuziphatha okufanayo kokubuyela emuva kungasetshenziswa ekuhambeni komsebenzi kokuhlukanisa, ukuqinisekisa, nokulawula okuqukethwe.

Qinisekisa imingcele ngedatha yakho

Umngcele obikwe iphrojekthi eyodwa awufaneleki ngokuzenzakalelayo kwenye. Qoqa izimo ezimele ezinelebula, khetha izinga lekhwalithi oluhlosile, kala ububanzi bokusetshenziswa nezinga lokudluliselwa ekubuyekezweni, bese uqinisekisa umphumela ngedatha egcinelwe ukuhlolwa. Phinda ukuhlola ngemva kokushintsha umbuzo, imodeli, ifomethi yokufaka, noma inqubomgomo yesinqumo.

Sebenzisa amafayela ezigaba ekubuyekezweni okugxilile

I-README ekhiqiziwe ilungele ukuthola izinto ngokubanzi, kodwa amafayela ngamanye angaphansi kwe-categories/ angcono ekubuyekezweni okugxilile nasekunikelweni. Njengoba okufakiwe ngakunye kuvela esigabeni esisodwa ncamashi, hlola nezigaba eziseduze lapho iphrojekthi ihlanganisa izindaba eziningi.

Hlola ezinye izindlela ezivulekile ngokucophelela

Isigaba se-Calibration and Research sihlanganisa ukukhiqizwa kabusha kwasendaweni, ukubuka kuqala okuzimele, namamodeli avulekile afana no-Jev. Lawa maphrojekthi angaphinda akhe isixhumi esibonakalayo sezinqumo ezinezinhlobo noma ahlole izindlela ezihlobene zokukhipha, kodwa akufanele kuthathwe ngokuzenzakalelayo ukuthi ahambisana nokuziphatha, ukulinganiswa, noma izici zokusebenza ze-Jev ye-TypeSafe AI.

Ukunikela Ngokufakiwe

Okufakiwe okuhlongozwayo kufanele kube sesidlangalaleni, kucashunwe, futhi kube nokuxhumana okubonakalayo no-Jev noma ne-port noma i-derivative ka-Jev ebhalwe phansi. Kufanele sichaze isinqumo esithile esinezinhlobo, hhayi i-classifier, router, noma judge evamile efana nephethini kuphela.

1. Khetha isigaba esisondelene kakhulu nokusetshenziswa okuqondile kwephrojekthi.
2. Hlela ifayela lomthombo laleso sigaba ngaphansi kwe-categories/.
3. Bhala isifinyezo somusho owodwa esihlanganisa isimo, indlela, nenani.
4. Qinisekisa ukuthi umthombo oxhunyiwe ubonisa ngokusobala u-Jev noma iluphu yesinqumo esinezinhlobo.
5. Yakha kabusha i-README ekhiqiziwe nge-scripts/build-readme.py.
6. Landela yonke imiyalelo eku-CONTRIBUTING.md ngaphambi kokuvula i-pull request.

Ukulungisa nokususa nakho kuyiminikelo efanele. Uma okufakiwe kungafinyeleleki, kuhlukaniswe ngokungalungile, kungacacile ngokweqile, noma kungasazanelisi izimiso zokufakwa, vula i-issue noma i-pull request enobufakazi obusekelayo.

Isiphetho

awesome-jev inikeza indlela ehlelekile yokuthola izinhlelo zangempela zezinqumo ezinezinhlobo ku-routing, scoring, verification, agents, research, naku-infrastructure. Inani layo elikhulu alikho nje enanini lezixhumanisi, kodwa nasemaphethinini aphindaphindekayo avezwa yilawo maphrojekthi. Sebenzisa uhlu ukuthola abangase bafanele, landelela iluphu yesinqumo ngayinye, hlola iphrojekthi yokuqala, linganisa ngedatha yakho, futhi uphathe konke okufakiwe njengomkhondo hhayi njengesiqinisekiso.