
awesome-jev ni nini?
awesome-jev ni katalogi iliyoratibiwa ya mifano ya umma inayohusisha Jev, modeli ya maamuzi ya System One ya TypeSafe AI. Badala ya kupanga rasilimali kwa mwandishi, makala au hazina, inazipanga kulingana na uamuzi unaofanywa, kama vile kuchagua zana, kupanga muktadha kwa viwango, kuainisha tishio au kuamua ikiwa taarifa inapaswa kuhifadhiwa.
Hazina hii ni faharasa, si bidhaa ya Jev wala SDK. Haihusiani na TypeSafe AI, na kujumuishwa humo hakumaanishi pendekezo. Lengo lake ni kuwasaidia wasanidi kugundua utekelezaji, kukagua primitives wanazotumia na kuelewa tahadhari muhimu kabla ya kutumia muundo fulani.
Ingizo la katalogi linamaanisha kuwa kiungo chake kilifunguka na mtu alilikagua. Haimaanishi kuwa utekelezaji huo ni sahihi, salama, wenye ufanisi au unafaa kwa matumizi ya uzalishaji.
Kuielewa Jev
Jev hupokea hali na maswali yaliyoainishwa, kisha hurejesha majibu yaliyoainishwa pamoja na kiwango cha imani kilichorekebishwa. Imekusudiwa kwa maamuzi ya haraka na ya gharama nafuu ndani ya mzunguko wa wakala, badala ya utengenezaji wa maandishi marefu.
Katalogi inafuatilia primitives tatu za Jev:
- Choice: hutumiwa wakati uamuzi lazima ufanywe kati ya chaguo zilizopo.
- Score: hutumiwa wakati kipengele au mgombea anahitaji alama iliyoainishwa.
- Noul: hutumiwa kwa hukumu au dai moja moja.
Usidhani kuwa mipangilio tofauti ya primitives inaweza kubadilishana. README inaonya kwamba Choice moja kati ya chaguo kadhaa na Noul moja kwa kila chaguo hujibu maswali tofauti. Tofauti hii ni chanzo cha kawaida cha makosa ya utekelezaji.
Jev hupokea ingizo la maandishi, likiwemo mifuatano, vitu vya JSON na safu za maandishi. Muktadha wa ombi ulioandikwa ni tokeni 64,000, huku tokeni 32,000 zikitengwa kwa hali pamoja na swali refu zaidi. Hakuna uzani wa modeli uliochapishwa, kwa hivyo Jev haiwezi kuendeshwa ndani ya kompyuta ya eneo lako.
Vipengele muhimu vya katalogi
Mpangilio unaolenga maamuzi
Faharasa kuu hupanga maingizo kulingana na miundo ya maamuzi inayoweza kutumika tena. Hii hurahisisha kujibu maswali kama “Mawakala wanachaguaje zana?” badala ya kutafuta machapisho yasiyohusiana yanayotaja Jev kwa bahati tu.
Mionekano inayoweza kutafutwa na kushirikiwa
Tovuti inayoweza kutafutwa hutoa vichujio, kadi za maingizo, histogramu ya ufunikaji na URL zinazoweza kushirikiwa. Pia ina mionekano maalum ya primitives na utangamano.
Metadata ya ushahidi na tahadhari
Maingizo hutaja chanzo chao, lugha ya utekelezaji na primitives zinazoitwa na msimbo halisi. Pia yanaweza kuwa na tahadhari kama hali ya kivuli, nambari za muuzaji, haijathibitishwa au hakuna leseni. Maelezo kamili huhifadhiwa katika catalog.json na kuonyeshwa kwenye tovuti.
Ufunikaji na mapengo ya utafiti
Mtazamo wa ufunikaji unaonyesha ni mifano mingapi ya umma iliyopo kwa kila muundo wa uamuzi. Sufuri inaonyesha pengo la utafiti, si tatizo la kuonyesha data. Hii ni muhimu kwa kugundua miundo iliyoimarika na kutambua matumizi yanayowezekana ambayo bado hayajaonyeshwa hadharani.
Vipimo huru
Sehemu maalum inaangazia matokeo yaliyopimwa badala ya madai ya matangazo. Maingizo kadhaa yanaripoti matokeo hasi au yasiyoegemea upande wowote, yakiwemo tathmini ambapo Jev ilifanya vibaya kuliko kifupisho kilichokuwepo, ilifungana na kiainishaji kilichokuwepo au ikaongeza ingizo linalotozwa bila kutoa maboresho yenye maana ya muda wa kusubiri.
Usakinishaji na usanidi
Chaguo la 1: Tumia katalogi iliyopangishwa
Hakuna usakinishaji unaohitajika kwa utafiti wa kawaida. Fungua tovuti iliyopangishwa, chagua muundo wa uamuzi na ukague maingizo yanayolingana.
- Fungua tovuti inayoweza kutafutwa.
- Chagua pau kwenye histogramu ya ufunikaji ili kuchuja kwa muundo wa uamuzi.
- Fungua ingizo na ukague chanzo, lugha, primitives na tahadhari zake.
- Nakili URL inayotokana ikiwa ungependa kushiriki mtazamo uliochujwa.
Chaguo la 2: Nakili hazina
Naakili mradi ikiwa ungependa kukagua data yake ya chanzo, nyaraka, mifano au hati za uundaji ndani ya kompyuta yako.
git clone https://github.com/kydlikebtc/awesome-jev.git
cd awesome-jevREADME huzalishwa kutoka catalog.json. Hazina inaelekeza wazi wasimamizi kuhariri katalogi badala ya kuhariri README iliyozalishwa moja kwa moja. Ili kuijenga upya, endesha amri iliyoandikwa kutoka kwenye mzizi wa hazina:
python3 scripts/build_readme.pyREADME haitaji hatua za ziada za usakinishaji katika nyenzo zilizotolewa. Angalia faili za hazina na usanidi wa uendeshaji kiotomatiki kabla ya kurekebisha au kuthibitisha katalogi.
Matumizi ya msingi: kutafuta utekelezaji unaofaa
Hatua ya 1: Bainisha uamuzi
Anza na uamuzi ambao mfumo wako lazima ufanye, si kwa lebo pana ya teknolojia. Kwa mfano:
- Wakala unapaswa kuita zana gani inayofuata?
- Ni faili zipi zinapaswa kujumuishwa kama muktadha wa ukaguzi?
- Je, matokeo ya awali ya zana bado yana umuhimu?
- Ni kategoria gani ya tishio inayolingana zaidi na kipengee cha habari?
Hatua ya 2: Chagua muundo unaolingana
Tumia histogramu ya chanjo ya tovuti au sehemu za mifumo ya maamuzi katika README. Kwa wakala anayechagua hatua yake inayofuata, anza na Uteuzi wa zana. Katalogi ina mifano kuanzia kuita vitendaji na kupendekeza ujuzi hadi kudhibiti kivinjari na kukagua ruhusa.
Hatua ya 3: Chuja kwa primitive
Tumia mwonekano wa primitives wakati usanifu wako tayari unapendekeza aina ya swali. Uteuzi wa hatua kutoka seti iliyofungwa unaweza kukuongoza kwenye mifano ya Choice, huku hukumu huru za umuhimu zikikuongoza kwenye mifano ya Score au Noul.
Lebo za primitive zinapaswa kuchukuliwa kama maelezo ya kile ambacho msimbo uliorejelewa unaita, si kama dhamana kwamba utekelezaji ulichagua primitive bora zaidi.
Hatua ya 4: Soma tahadhari
Kabla ya kufungua mradi uliounganishwa, kagua lebo zake za tahadhari na dokezo la katalogi. Kwa mfano, muunganisho uliowekwa alama ya hali ya kivuli unaweza kuwa umeunganishwa kwenye mfumo huku ukizuia kwa makusudi maamuzi yake yasiathiri lebo, akiba au arifa za uzalishaji.
Hatua ya 5: Kagua chanzo asili
Tumia katalogi kwa ugunduzi, kisha thibitisha tabia katika hazina au nyaraka zilizounganishwa. Thibitisha jinsi hali inavyoundwa, jinsi maswali yanavyowekwa aina, viwango vya mipaka vinavyotumika, na kinachotokea wakati ujasiri ni mdogo.
Mifumo ya mfano ya utafiti
Kujifunza primitives tatu
Kwa utangulizi wa kwanza, fuata mpangilio wa kusoma unaopendekezwa na hazina:
- Soma mwongozo rasmi wa kuanza haraka kuhusu ombi lenye maswali ya Choice, Score na Noul.
- Soma vikwazo vinavyojulikana vya Jev 1.13.
- Kagua mfano wa primitives tatu katika katalogi.
Hazina inabainisha kuwa mfano wake wa ndani ulikaguliwa sehemu kwa sehemu dhidi ya marejeo rasmi ya API, lakini haukuendeshwa dhidi ya API inayotumika. Zingatia tofauti hiyo unapoutathmini.
Kutafiti uteuzi wa zana
Tuseme unabuni wakala anayepaswa kuchagua zana moja kutoka katalogi kubwa. Tafuta mfumo wa Uteuzi wa zana na linganisha utekelezaji kama:
- Kitabu rasmi cha mapishi cha kuita vitendaji, kinachopangia maombi vitendaji vilivyo na aina kwa kutumia maswali kutoka seti iliyofungwa.
- Kitabu cha mapishi cha kupendekeza ujuzi, kinachotathmini kama ujuzi unahitajika na kupanga ujuzi unaoweza kutumika.
- Mgeuzaji wa majaribio wa utafutaji wa Jev wa FastMCP, anayefanya upangaji wa jumla kabla ya kuhukumu zana zilizoorodheshwa kwa ufupi.
- Mtoa huduma wa Composio, anayejenga upya miito ya zana na kushughulikia hali za kujizuia au zinazohitaji uthibitisho.
Kulinganisha maingizo haya hufichua chaguo za usanifu ambazo upangaji rahisi kwa umaarufu ungeficha, zikiwemo urejeshaji wa hatua kwa hatua, kujizuia kwa uwazi, na ushughulikiaji tofauti wa uthibitisho.
Kutathmini uteuzi wa muktadha
Ikiwa unataka Jev ipange faili au kumbukumbu, anza na mifano iliyopimwa badala ya maonyesho ya matangazo. Katalogi inaripoti kuwa jaribio la muktadha wa ukaguzi lisilo na makosa lilitumia Score moja kwa kila faili iliyogombea na kupata ingizo la bili kubwa zaidi kwa kiasi, bila karibu kuboreshwa kwa muda wa saa. Matokeo hayo hayathibitishi kuwa mfumo huo haufanyi kazi kila wakati, lakini yanatoa sababu halisi ya kuulinganisha na msingi rahisi zaidi.
Vidokezo vya hali ya juu
Pendelea vipimo huru
Weka kipaumbele kwa maingizo ya vigezo yanayochapisha mbinu, misingi ya kulinganisha, hitilafu na ushahidi ghafi au unaoweza kuzalishwa upya. Katalogi inasisitiza tathmini ya kubana ya Hermes Agent kwa sababu ililinganisha Jev na kifupisho kilichokuwepo na kuchapisha uamuzi wa kutotumia mbinu hiyo.
Vilevile, matokeo yasiyoegemea upande wowote yanaweza kuwa muhimu. Muunganisho wa worldmonitor uliendelea katika hali ya kivuli baada ya tathmini isiyo na upendeleo kugundua kuwa Jev ilifungana tu na modeli iliyokuwepo. Huu ni mfano wa vitendo wa kujaribu mfumo mpya wa maamuzi bila kuuruhusu mara moja kuathiri tabia ya uzalishaji.
Jaribu unyeti kwa mpangilio wa chaguo
Ripoti moja huru iligundua kuwa kubadilisha mpangilio wa chaguo kulibadilisha uwezekano kiasi cha kuvuka kiwango cha 0.9. Matokeo hayo hayajarudiwa, kwa hiyo ukubwa wake haupaswi kuchukuliwa kuwa wa jumla. Hata hivyo, yanapendekeza jaribio muhimu la uimara:
- Endesha uamuzi huo huo kwa mpangilio wa awali wa chaguo.
- Panga upya au geuza chaguo bila kubadilisha maana yake.
- Linganisha majibu yaliyochaguliwa na thamani za ujasiri.
- Kagua kama viwango vya uendeshaji vimevukwa.
Ikiwa kupanga upya bila madhara kunabadilisha tabia ya uzalishaji, huenda kiwango hicho kisiwe thabiti kama kinavyoonekana.
Linganisha bajeti zinazolingana na misingi rahisi
Daima linganisha Jev na mfumo ambao ingechukua nafasi yake. Jumuisha njia rahisi kama kupanga kwa uhalisi wa hivi karibuni, kanuni za kideterministi, kigawanya madaraja kilichopo au kipangaji upya maalumu. Bajeti za muktadha zinapotofautiana, linganisha matokeo kwa bajeti zinazolingana ili tathmini itenganishe ubora wa uamuzi na ingizo la ziada.
Tenganisha matokeo yenye aina na matokeo sahihi
Majibu yenye aina huboresha urahisi wa kuunganisha, lakini hayahakikishi kuwa uamuzi wa msingi ni sahihi. Thibitisha usahihi, ulinganifu wa uwezekano, muda wa kusubiri, gharama na tabia ya kushindwa kwa data inayowakilisha programu yako.
Buni kwa ajili ya kujizuia na ukaguzi
Mifano katika katalogi inajumuisha kujizuia kwa uwazi, hali zinazohitaji uthibitisho, uwekaji wa kivuli na vipengele vya kujijumuisha. Mifumo hii ni muhimu hasa wakati jibu lisilo sahihi lenye ujasiri mkubwa linaweza kuanzisha hatua isiyo salama au ya gharama kubwa.
Kagua uoanifu kabla ya utekelezaji
Pitia nyaraka za uoanifu za hazina ili kuelewa tofauti za mifumo mbalimbali. Usidhani kwamba mifano iliyoandikwa kwa Python, JavaScript, TypeScript, Go au lugha nyingine inaonyesha tabia au maelezo ya ujumuishaji yanayofanana.
Tumia data ya katalogi kwa usahihi
Unapohariri mradi, chukulia catalog.json kuwa chanzo cha ukweli na uzalishe upya README baadaye. Beji za hazina zinaonyesha kuwa data ya katalogi imepewa leseni ya CC0-1.0 na msimbo wa mradi umepewa leseni ya MIT, lakini bado unapaswa kukagua miradi iliyounganishwa mmoja baada ya mwingine kwa sababu leseni zake zinaweza kutofautiana au kutokuwepo.
Makosa ya kawaida ya kuepuka
- Kuichukulia katalogi kama idhini: kujumuishwa kunaonyesha tu kwamba kiungo kilikaguliwa na kufunguka.
- Kuchagua mifano kwa kuzingatia idadi ya nyota pekee: umaarufu hauhakikishi usahihi, urekebishaji au ufaafu.
- Kuchanganya Choice na hukumu huru za Noul: mipangilio hii hujibu maswali tofauti.
- Kuamini takwimu za utendaji za wauzaji bila msingi wa kulinganisha: pendelea vipimo huru vinavyoweza kurudiwa.
- Kupuuza matokeo hasi: majaribio yaliyoshindwa au yasiyoegemea upande wowote mara nyingi hutoa mwongozo wa kihandisi unaoweza kutumika zaidi.
- Kudhani kuwa matokeo yenye aina maalum yanahakikisha usahihi: thibitisha maamuzi kwa kutumia ukweli halisi wenye lebo au unaoweza kutetewa kwa njia nyingine.
- KUhariri README iliyozalishwa moja kwa moja: sasisha
catalog.jsonna uendeshe hati ya ujenzi badala yake.
Hitimisho
awesome-jev inafaa zaidi kutumiwa kama ramani ya utafiti inayozingatia ushahidi kwa ajili ya ujumuishaji wa Jev. Anza na uamuzi ambao mfumo wako unahitaji kufanya, chuja mifano kwa muundo na primitive, kagua tahadhari, na thibitisha kila dai katika chanzo asili. Kabla ya kutumia muundo fulani, urudie kwenye data yako mwenyewe, linganisha na misingi rahisi, jaribu uthabiti wa uaminifu, na panga uwezekano wa kutotoa uamuzi au kukagua na binadamu.
