Indlela Yokuthola Nokuhlola Amaphethini Ezinqumo ze-Jev nge-awesome-jev

Yini i-awesome-jev?

awesome-jev iyikhathalogi ehlelwe ngokucophelela yezibonelo zomphakathi ezibandakanya i-Jev, imodeli yesinqumo ye-System One ye-TypeSafe AI. Esikhundleni sokuhlela izinsiza ngombhali, i-athikili, noma indawo yokugcina ikhodi, izihlanganisa ngokwe-sinqumo esenziwayo, njengokukhetha ithuluzi, ukuhlela umongo ngokubaluleka, ukuhlukanisa usongo, noma ukunquma ukuthi ulwazi kufanele lugcinwe yini.

Le ndawo yokugcina ikhodi iyinkomba, hhayi umkhiqizo we-Jev noma i-SDK. Ayihlobene ne-TypeSafe AI, futhi ukufakwa kuyo akusho ukuthi kukhona okunconywayo. Inhloso yayo ukusiza abathuthukisi bathole ukusetshenziswa, bahlole izakhi eziyisisekelo ezisetshenziswayo, futhi baqonde izexwayiso ezibalulekile ngaphambi kokwamukela iphethini.

Ukufakwa kukhathalogi kusho ukuthi isixhumanisi sisebenzile nokuthi umuntu usihlolile. Akusho ukuthi ukusetshenziswa kulungile, kuphephile, kusebenza kahle, noma kulungele ukukhiqizwa.

Ukuqonda i-Jev

I-Jev yamukela isimo nemibuzo enohlobo oluchaziwe, bese ibuyisa izimpendulo ezinohlobo oluchaziwe nokuzethemba okulinganisiwe. Yenzelwe izinqumo ezisheshayo nezingabizi ngaphakathi komjikelezo we-ejenti, kunokukhiqiza umbhalo omude.

Ikhathalogi ilandelela izakhi ezintathu eziyisisekelo ze-Jev:

• Choice: isetshenziswa lapho kufanele kwenziwe isinqumo phakathi kwezinketho ezitholakalayo.
• Score: isetshenziswa lapho into noma ikhandidethi lidinga amaphuzu anohlobo oluchaziwe.
• Noul: isetshenziselwa isahlulelo noma isiphakamiso esisodwa.

Ungacabangi ukuthi ukuhlelwa okuhlukile kwezakhi eziyisisekelo kuyashintshana. I-README ixwayisa ngokuthi i-Choice eyodwa phakathi kwezinketho eziningana kanye ne-Noul eyodwa kwinketho ngayinye kuphendula imibuzo ehlukene. Lo mehluko ungumthombo ovamile wamaphutha okusetshenziswa.

I-Jev yamukela okokufaka kombhalo, okuhlanganisa izintambo, izinto ze-JSON, namalungu afanayo ombhalo. Umongo wesicelo obhaliwe unamathokheni angu-64,000, kanti amathokheni angu-32,000 ayatholakala esifundeni kanye nombuzo omude kunayo yonke. Azikho izisindo zemodeli ezishicilelwe, ngakho i-Jev ayikwazi ukusetshenziswa endaweni.

Izici ezibalulekile zekhathalogi

Ukuhlelwa okugxile ezinqumweni

Inkomba eyinhloko ihlanganisa okufakiwe ngokwamaphethini ezinqumo angasetshenziswa kabusha. Lokhu kwenza kube lula ukuphendula imibuzo efana nokuthi “Ama-ejenti akhetha kanjani amathuluzi?” kunokusesha ezindabeni ezingahlobene ezivele zikhulume nge-Jev.

Ukubukwa okuseshekayo nokwabelanekayo

Isayithi eliseshekayo linikeza izihlungi, amakhadi okufakiwe, i-histogram yokusabalala, nama-URL okwabelwana ngawo. Futhi lihlanganisa ukubukwa okukhethekile kwe-zakhi eziyisisekelo kanye kokuhambisana.

Imethadatha yobufakazi nezexwayiso

Okufakiwe kuchaza umthombo wakho, ulimi lokusetshenziswa, kanye nezakhi eziyisisekelo ezibizwa yikhodi ngempela. Kungase futhi kube nezexwayiso ezifana ne-shadow mode, vendor numbers, unverified, noma no licence. Amanothi agcwele agcinwe ku-catalog.json futhi aboniswa kusayithi.

Ukusabalala nezikhala zocwaningo

Ukubukwa kokusabalala kubonisa ukuthi zingaki izibonelo zomphakathi ezikhona ngephethini ngayinye yesinqumo. Uziro ukhombisa igebe locwaningo, hhayi inkinga yokubonisa. Lokhu kuyasiza kokubili ekutholeni amaphethini asevele emisiwe nasekuhlonzeni ukusetshenziswa okungenzeka okungakaze kuboniswe esidlangalaleni.

Izilinganiso ezizimele

Isigaba esikhethekile sigqamisa imiphumela elinganisiwe esikhundleni sezimangalo zokukhangisa. Okufakiwe okuningana kubika imiphumela engemihle noma engathathi hlangothi, okuhlanganisa ukuhlolwa lapho i-Jev yenza kabi kunesifinyezi esivele sikhona, yalingana nesihlukanisi esikhona, noma yandisa okokufaka okukhokhiswayo ngaphandle kokuhlinzeka ngokuthuthuka okunengqondo kwesikhathi sokuphendula.

Ukufakwa nokusethwa

Inketho 1: Sebenzisa ikhathalogi esingathwe

Akudingeki ukufakwa ukuze kwenziwe ucwaningo olujwayelekile. Vula isayithi elisingathwe, khetha iphethini yesinqumo, bese uhlola okufakiwe okuhambisanayo.

1. Vula isayithi eliseshekayo.
2. Khetha ibha ku-histogram yokusabalala ukuze uhlunge ngephethini yesinqumo.
3. Vula okufakiwe bese ubuyekeza umthombo wakho, ulimi, izakhi eziyisisekelo, nezexwayiso.
4. Kopisha i-URL ephumayo uma ufuna ukwabelana ngokubukwa okuhlungiwe.

Inketho 2: Klona indawo yokugcina ikhodi

Klona iphrojekthi uma ufuna ukuhlola idatha yayo yomthombo, imibhalo, izibonelo, noma izikripthi zokuyakha endaweni.

git clone https://github.com/kydlikebtc/awesome-jev.git
cd awesome-jev

I-README yakhiwa kusuka ku-catalog.json. Indawo yokugcina ikhodi iyalela ngokusobala abagcini ukuthi bahlele ikhathalogi esikhundleni sokuhlela i-README ekhiqiziwe ngokuqondile. Ukuze uyakhe kabusha, sebenzisa umyalo obhaliwe usuka empandeni yendawo yokugcina ikhodi:

python3 scripts/build_readme.py

I-README ayicacisi ezinye izinyathelo zokufaka ezintweni ezinikeziwe. Bheka amafayela endawo yokugcina ikhodi kanye nokucushwa kwe-automation ngaphambi kokuguqula noma ukuqinisekisa ikhathalogi.

Ukusetshenziswa okuyisisekelo: ukuthola ukusetshenziswa okufanele

Isinyathelo 1: Chaza isinqumo

Qala ngesinqumo okufanele senziwe uhlelo lwakho, hhayi ngelebula elibanzi lobuchwepheshe. Ngokwesibonelo:

• Iliphi ithuluzi okufanele libizwe yi-ejenti ngokulandelayo?
• Imaphi amafayela okufanele afakwe kumongo wokubuyekeza?
• Ingabe umphumela wethuluzi wangaphambilini usabalulekile?
• Iliphi isigaba sosongo esihambisana kangcono nento yezindaba?

Isinyathelo 2: Khetha iphethini ehambisanayo

Sebenzisa i-histogramu yokumbozwa kwesayithi noma izigaba zamaphethini ezinqumo ku-README. Ku-agent ekhetha isenzo sayo esilandelayo, qala ngoUkukhethwa kwamathuluzi. Ikhathalogi ihlanganisa izibonelo ezisukela ekubizeni imisebenzi nasekusikiseleni amakhono kuye ekulawuleni isiphequluli nasekubuyekezeni izimvume.

Isinyathelo 3: Hlunga nge-primitive

Sebenzisa ukubuka kwama-primitive lapho i-architecture yakho isivele iphakamisa uhlobo lombuzo. Ukukhetha isenzo kusethi evaliwe kungakuqondisa ezibonelweni ze-Choice, kuyilapho izahlulelo zokuhambisana ezizimele zingakuqondisa ezibonelweni ze-Score noma ze-Noul.

Amalebula ama-primitive kufanele athathwe njengezincazelo zalokho okubizwa yikhodi ekhonjiwe, hhayi njengeziqinisekiso zokuthi i-implementation ikhethe i-primitive engcono kakhulu.

Isinyathelo 4: Funda izexwayiso

Ngaphambi kokuvula iphrojekthi exhunyiwe, hlola amathegi ezixwayiso nenothi lekhathalogi. Ngokwesibonelo, i-integration ephawulwe ngokuthi imodi yesithunzi ingaxhunywa ohlelweni kodwa ivimbele ngamabomu izinqumo zayo ukuthi zithinte amalebula okukhiqiza, ama-cache, noma izexwayiso.

Isinyathelo 5: Hlola umthombo wokuqala

Sebenzisa ikhathalogi ukuze uthole, bese uqinisekisa ukuziphatha ku-repository noma emibhalweni exhunyiwe. Qinisekisa ukuthi i-state yakhiwa kanjani, imibuzo ihlelwa kanjani ngohlobo, yimiphi imingcele esetshenziswayo, nokuthi kwenzekani lapho ukuzethemba kuphansi.

Izindlela zocwaningo eziyizibonelo

Ukufunda ama-primitive amathathu

Ukuze uthole isingeniso sokuqala, landela uhlelo lokufunda olunconywe yi-repository:

1. Funda i-quickstart esemthethweni yesicelo esiqukethe imibuzo ye-Choice, Score, ne-Noul.
2. Funda imingcele eyaziwayo ye-Jev 1.13.
3. Hlola isibonelo sama-primitive amathathu sekhathalogi.

I-repository iphawula ukuthi isibonelo sayo sendawo saqhathaniswa inkambu nenkambu nereferensi ye-API esemthethweni kodwa asizange siqhutshwe ngokumelene ne-API esebenzayo. Londoloza lo mehluko lapho usihlola.

Ukucwaninga ukukhethwa kwamathuluzi

Ake sithi uklama i-agent okufanele ikhethe ithuluzi elilodwa kukhathalogi enkulu. Sesha iphethini ethi Ukukhethwa kwamathuluzi bese uqhathanisa ama-implementation afana nalawa:

• I-cookbook esemthethweni yokubiza imisebenzi, ehlela izicelo emisebenzini enohlobo kusetshenziswa imibuzo yesethi evaliwe.
• I-cookbook yokusikisela amakhono, ehlola ukuthi ikhono liyadingeka yini bese ihlela amakhono aqokiwe.
• I-Jev search transform yokuhlola ye-FastMCP, eyenza ukuhlelwa okujwayelekile ngaphambi kokwahlulela amathuluzi asohlwini olufushane.
• Umhlinzeki we-Composio, owakha kabusha ukubizwa kwamathuluzi futhi asingathe izimo zokungaphenduli noma ezidinga ukuqinisekiswa.

Ukuqhathanisa lezi zinto kuveza izinqumo ze-architecture ebezingafihlwa ukuhlelwa okulula ngokuthandwa, okuhlanganisa ukubuyisa ulwazi ngezigaba, ukungaphenduli okusobala, nokuphathwa okuhlukile kokuqinisekisa.

Ukuhlola ukukhethwa komongo

Uma ufuna i-Jev ihlele amafayela noma izinkumbulo, qala ngezibonelo ezilinganisiwe kunemiboniso yokukhangisa. Ikhathalogi ibika ukuthi ukuhlolwa komongo wokubuyekeza okungenamaphutha kusebenzise i-Score eyodwa ngefayela ngalinye eliqokelwe ukhetho futhi kwathola okokufaka okukhokhiswayo okuningi kakhulu ngaphandle kokuthuthuka okubonakalayo kwesikhathi sonke. Lo mphumela awufakazeli ukuthi iphethini ayisebenzi njalo, kodwa unikeza isizathu esiqondile sokuyiqhathanisa ne-baseline elula.

Izeluleko ezithuthukile

Khetha izilinganiso ezizimele

Beka phambili okufakiwe kokuhlolwa okushicilela izindlela, ama-baseline, ukwehluleka, nobufakazi obuluhlaza noma obungaphindwa. Ikhathalogi igqamisa ukuhlolwa kokunciphisa kwe-Hermes Agent ngoba yaqhathanisa i-Jev ne-summarizer ekhona futhi yashicilela isinqumo sokungayamukeli le ndlela.

Ngokufanayo, umphumela ongathathi hlangothi ungaba usizo. I-integration ye-worldmonitor yahlala kwimodi yesithunzi ngemva kokuba ukuhlolwa okungabonisi ukuthi iyiphi imodeli kuthole ukuthi i-Jev ibibambene kuphela nemodeli eyayikhona. Lena imodeli esebenzayo yokuhlola uhlelo olusha lwezinqumo ngaphandle kokuluvumela ngokushesha ukuthi luthinte ukuziphatha kokukhiqiza.

Hlola ukuzwela ekuhlelweni kwezinketho

Umbiko ozimele owodwa wathola ukuthi ukuhlehlisa ukuhleleka kwezinketho kwashintsha amathuba ngokwanele ukuthi awelele umngcele ongu-0.9. Lo mphumela awukaphindwa, ngakho ubukhulu bawo akufanele buthathwe njengobusebenza yonke indawo. Nokho, uphakamisa ukuhlolwa okubalulekile kokuqina:

1. Qalisa isinqumo esifanayo ngokuhleleka kwezinketho kwasekuqaleni.
2. Shintsha noma uhlehlise izinketho ngaphandle kokushintsha incazelo yazo.
3. Qhathanisa izimpendulo ezikhethiwe namanani okuzethemba.
4. Hlola ukuthi imingcele yokusebenza iyeqiwe yini.

Uma ukuhlelwa kabusha okungenangozi kushintsha ukuziphatha kokukhiqiza, umngcele ungase ungazinzi ngendlela obonakala ngayo.

Qhathanisa amabhajethi alinganayo nama-baseline alula

Hlala uqhathanisa i-Jev nohlelo ebizoluthatha indawo yalo. Faka ezinye izindlela ezilula njengokuhlela ngokusha, imithetho enqunyiwe, i-classifier ekhona, noma i-reranker ezinikele. Lapho amabhajethi omongo ehlukile, qhathanisa imiphumela kumabhajethi alinganayo ukuze ukuhlolwa kugxile kwikhwalithi yesinqumo kunokokufaka okwengeziwe.

Hlukanisa okukhiphayo okunohlobo nokukhiphayo okulungile

Izimpendulo ezinohlobo zithuthukisa ukusebenziseka kwe-integration, kodwa aziqinisekisi ukuthi isinqumo esingaphansi silungile. Qinisekisa ukunemba, ukulinganiswa, ukubambezeleka, izindleko, nokuziphatha kokwehluleka kudatha emele uhlelo lwakho.

Hlela ukungaphenduli nokubuyekezwa

Izibonelo ezisekhathalogi zihlanganisa ukungaphenduli okusobala, izimo ezidinga ukuqinisekiswa, ama-deployment akumodi yesithunzi, nezici ezisebenza kuphela ngemvume yomsebenzisi. La maphethini awusizo kakhulu lapho impendulo engalungile enokuzethemba okuphezulu ingabangela isenzo esingaphephile noma esibizayo.

Hlola ukuhambisana ngaphambi kwe-implementation

Buyekeza imibhalo yokuhambisana yenqolobane ukuze uqonde umehluko phakathi kwezinkundla. Ungacabangi ukuthi izibonelo ezibhalwe nge-Python, JavaScript, TypeScript, Go, noma ngolunye ulimi ziveza ukuziphatha noma imininingwane yokuhlanganisa efanayo.

Sebenzisa idatha yekhathalogi ngendlela efanele

Lapho uhlela iphrojekthi, thatha i-catalog.json njengomthombo oyinhloko weqiniso bese ukhiqiza kabusha i-README ngemva kwalokho. Amabheji enqolobane abonisa ukuthi idatha yekhathalogi inelayisensi ye-CC0-1.0 nokuthi ikhodi yephrojekthi inelayisensi ye-MIT, kodwa kusafanele uhlole amaphrojekthi axhunyiwe ngawodwana ngoba amalayisensi awo angahluka noma angabi khona.

Amaphutha avamile okufanele uwagweme

• Ukuthatha ikhathalogi njengokugunyaza: ukufakwa kusho kuphela ukuthi isixhumanisi sabuyekezwa futhi saxazululeka.
• Ukukhetha izibonelo ngokubala kwezinkanyezi kuphela: ukuthandwa akufakazeli ukunemba, ukulinganiswa, noma ukufaneleka.
• Ukudida i-Choice nezahlulelo ezizimele ze-Noul: lezi zinhlelo ziphendula imibuzo ehlukene.
• Ukuthembela ezibalweni zokusebenza zabathengisi ngaphandle kwesisekelo: beka phambili izilinganiso ezizimele neziphindaphindekayo.
• Ukunganaki imiphumela engemihle: izivivinyo ezihlulekile noma ezingathathi hlangothi zivame ukunikeza isiqondiso sobunjiniyela esisebenziseka kakhulu.
• Ukucabanga ukuthi okukhiphayo okunohlobo olucacisiwe kuqinisekisa ukunemba: qinisekisa izinqumo ngedatha eyiqiniso enamalebula noma enye idatha engavikelwa ngokunengqondo.
• Ukuhlela i-README ekhiqiziwe ngokuqondile: buyekeza i-catalog.json bese usebenzisa iskripthi sokwakha esikhundleni salokho.

Isiphetho

i-awesome-jev isetshenziswa kangcono njengebalazwe locwaningo eligxile ebufakazini lokuhlanganiswa kwe-Jev. Qala ngesinqumo okudingeka isistimu yakho isenze, hlunga izibonelo ngephethini nange-primitive, hlola izexwayiso, bese uqinisekisa isimangalo ngasinye emthonjeni wokuqala. Ngaphambi kokwamukela umklamo, uwuphinde uwusebenzise kudatha yakho, uwuqhathanise nezisekelo ezilula, uhlole ukuzinza kokuzethemba, bese uhlela ukugwema izinqumo noma ukubuyekezwa ngumuntu.