awesome-jev yordamida Jev qaror namunalari qanday topiladi va baholanadi

awesome-jev nima?

awesome-jev — Jev, TypeSafe AI’ning System One qaror qabul qilish modeliga oid ommaviy misollar jamlangan katalog. Resurslarni muallif, maqola yoki repozitoriy bo‘yicha tartiblash o‘rniga, ularni qabul qilinayotgan qaror bo‘yicha guruhlaydi: masalan, vositani tanlash, kontekstni saralash, tahdidni tasniflash yoki ma’lumotni saqlash kerak-kerakmasligini aniqlash.

Repozitoriy indeks bo‘lib, Jev mahsuloti yoki SDK emas. U TypeSafe AI bilan bog‘liq emas va katalogga kiritilish tavsiya degani emas. Uning maqsadi dasturchilarga amaliyotlarni topish, ularda ishlatiladigan primitivlarni tekshirish va biror andozani qo‘llashdan oldin muhim cheklovlarni tushunishga yordam berishdir.

Katalogdagi yozuv uning havolasi ishlaganini va biror kishi uni ko‘rib chiqqanini anglatadi. Bu amalga oshirish to‘g‘ri, xavfsiz, samarali yoki ishlab chiqarishda foydalanishga mos degani emas.

Jev’ni tushunish

Jev holat va tiplashtirilgan savollarni qabul qiladi, so‘ng kalibrlangan ishonch darajasiga ega tiplashtirilgan javoblarni qaytaradi. U uzun matn yaratishdan ko‘ra agent sikli ichidagi tezkor va arzon qarorlar uchun mo‘ljallangan.

Katalog Jev’ning uchta primitivini kuzatadi:

• Choice: mavjud variantlar orasidan qaror qabul qilish kerak bo‘lganda ishlatiladi.
• Score: element yoki nomzodga tiplashtirilgan baho berish kerak bo‘lganda ishlatiladi.
• Noul: alohida mulohaza yoki fikrni baholash uchun ishlatiladi.

Turli primitiv kombinatsiyalari o‘zaro almashtiriladi deb o‘ylamang. README’da bir nechta variant uchun bitta Choice ishlatish va har bir variant uchun bittadan Noul ishlatish turli savollarga javob berishi alohida ta’kidlangan. Bu farq amalga oshirishdagi xatolarning keng tarqalgan manbaidir.

Jev matnli kiritmalarni, jumladan satrlar, JSON obyektlari va matn massivlarini qabul qiladi. Hujjatlarda ko‘rsatilgan so‘rov konteksti 64 000 tokenni tashkil etadi; holat va eng uzun savol uchun 32 000 token mavjud. Model og‘irliklari e’lon qilinmagan, shuning uchun Jev’ni lokal ravishda ishga tushirib bo‘lmaydi.

Katalogning asosiy xususiyatlari

Qarorga yo‘naltirilgan tuzilma

Asosiy indeks yozuvlarni qayta ishlatiladigan qaror andozalari bo‘yicha guruhlaydi. Bu “Agentlar vositalarni qanday tanlaydi?” kabi savollarga Jev tilga olingan, ammo bir-biriga aloqasiz postlarni qidirishdan ko‘ra osonroq javob topish imkonini beradi.

Qidiriladigan va ulashiladigan ko‘rinishlar

Qidiriladigan sayt filtrlar, yozuv kartalari, qamrov gistogrammasi va ulashiladigan URL manzillarni taqdim etadi. Unda maxsus primitivlar va moslik ko‘rinishlari ham mavjud.

Dalil va cheklov metama’lumotlari

Yozuvlarda manba, amalga oshirish tili va kod tomonidan amalda chaqiriladigan primitivlar ko‘rsatiladi. Ularda soya rejimi, vendor raqamlari, tasdiqlanmagan yoki litsenziya yo‘q kabi cheklovlar ham bo‘lishi mumkin. To‘liq qaydlar catalog.json faylida saqlanadi va saytda ko‘rsatiladi.

Qamrov va tadqiqotdagi bo‘shliqlar

Qamrov ko‘rinishi har bir qaror andozasi uchun nechta ommaviy misol mavjudligini ko‘rsatadi. Nol qiymati ko‘rsatishdagi muammoni emas, tadqiqotdagi bo‘shliqni anglatadi. Bu ham mavjud andozalarni topish, ham hali ommaviy namoyish etilmagan ehtimoliy qo‘llanishlarni aniqlash uchun foydalidir.

Mustaqil o‘lchovlar

Maxsus bo‘lim reklama da’volari o‘rniga o‘lchangan natijalarni ta’kidlaydi. Bir nechta yozuvlarda salbiy yoki neytral natijalar keltirilgan: jumladan, Jev mavjud xulosa chiqaruvchidan yomonroq natija ko‘rsatgan, amaldagi klassifikator bilan teng natija qayd etgan yoki sezilarli kechikish yaxshilanishini ta’minlamasdan hisoblangan kirish hajmini oshirgan baholashlar.

O‘rnatish va sozlash

1-variant: Joylashtirilgan katalogdan foydalanish

Oddiy tadqiqot uchun o‘rnatish talab qilinmaydi. Joylashtirilgan saytni oching, qaror andozasini tanlang va mos yozuvlarni ko‘rib chiqing.

1. Qidiriladigan saytni oching.
2. Qaror andozasi bo‘yicha filtrlash uchun qamrov gistogrammasidagi ustunni tanlang.
3. Yozuvni ochib, uning manbasi, tili, primitivlari va cheklovlarini ko‘rib chiqing.
4. Filtrlangan ko‘rinishni ulashmoqchi bo‘lsangiz, hosil bo‘lgan URL manzilni nusxalang.

2-variant: Repozitoriyni klonlash

Manba ma’lumotlari, hujjatlar, misollar yoki yaratish skriptlarini lokal ravishda ko‘rib chiqmoqchi bo‘lsangiz, loyihani klonlang.

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

README catalog.json faylidan yaratiladi. Repozitoriyda ta’minlovchilarga yaratilgan README’ni bevosita tahrirlash o‘rniga katalogni tahrirlash aniq ko‘rsatilgan. Uni qayta yaratish uchun repozitoriy ildizidan hujjatlarda ko‘rsatilgan buyruqni bajaring:

python3 scripts/build_readme.py

Taqdim etilgan materiallarda README qo‘shimcha o‘rnatish bosqichlarini ko‘rsatmaydi. Katalogni o‘zgartirish yoki tekshirishdan oldin repozitoriy fayllari va avtomatlashtirish sozlamalarini ko‘rib chiqing.

Asosiy foydalanish: mos amalga oshirishni topish

1-qadam: Qarorni aniqlang

Keng texnologik yorliqdan emas, tizimingiz qabul qilishi kerak bo‘lgan qarordan boshlang. Masalan:

• Agent keyingi navbatda qaysi vositani chaqirishi kerak?
• Qaysi fayllar ko‘rib chiqish kontekstiga kiritilishi kerak?
• Avvalgi vosita natijasi hali ham muhimmi?
• Qaysi tahdid toifasi yangilikka eng mos keladi?

2-qadam: Mos andozani tanlang

Saytning qamrov gistogrammasi yoki README faylidagi qaror namunalari bo‘limlaridan foydalaning. Keyingi harakatini tanlayotgan agent uchun Vosita tanlash bo‘limidan boshlang. Katalogda funksiyani chaqirish va ko‘nikma tavsiyasidan tortib brauzerni boshqarish va ruxsatlarni ko‘rib chiqishgacha bo‘lgan misollar keltirilgan.

3-qadam: Primitiv bo‘yicha filtrlash

Arxitekturangiz allaqachon savol turini ko‘rsatib turgan bo‘lsa, primitivlar ko‘rinishidan foydalaning. Yopiq to‘plamdagi harakat tanlovi sizni Choice misollariga, mustaqil dolzarblik baholari esa Score yoki Noul misollariga yo‘naltirishi mumkin.

Primitiv yorliqlari havola qilingan kod nimani chaqirishini tavsiflovchi belgilar sifatida qaralishi kerak; ular amalga oshirish jarayonida eng yaxshi primitiv tanlanganini kafolatlamaydi.

4-qadam: Izohlarni o‘qish

Havola qilingan loyihani ochishdan oldin uning ogohlantirish yorliqlari va katalog izohini ko‘rib chiqing. Masalan, shadow mode bilan belgilangan integratsiya tizimga ulangan bo‘lishi mumkin, biroq uning qarorlari ishlab chiqarish yorliqlari, keshlari yoki ogohlantirishlariga ta’sir qilishining oldi ataylab olingan bo‘ladi.

5-qadam: Asl manbani ko‘rib chiqish

Katalogdan izlash uchun foydalaning, so‘ngra xatti-harakatni havola qilingan repozitoriy yoki hujjatlarda tekshiring. Holat qanday tuzilishini, savollar qanday tiplashtirilganini, qanday chegaraviy qiymatlardan foydalanilishini va ishonch past bo‘lganda nima sodir bo‘lishini tasdiqlang.

Tadqiqot ish jarayonlariga misollar

Uchta primitivni o‘rganish

Birinchi tanishuv uchun repozitoriyning tavsiya etilgan o‘qish tartibiga rioya qiling:

1. Choice, Score va Noul savollarini o‘z ichiga olgan so‘rov uchun rasmiy tezkor boshlash qo‘llanmasini o‘qing.
2. Jev 1.13 ning ma’lum cheklovlari bilan tanishing.
3. Katalogdagi uchta primitiv misolini ko‘rib chiqing.

Repozitoriyda mahalliy misol rasmiy API ma’lumotnomasi bilan maydonma-maydon tekshirilgani, biroq jonli API orqali ishga tushirilmagani qayd etilgan. Uni baholashda bu farqni saqlab qoling.

Vosita tanlashni tadqiq qilish

Aytaylik, siz katta katalogdan bitta vositani tanlashi kerak bo‘lgan agentni loyihalamoqdasiz. Vosita tanlash namunasini qidiring va quyidagi amalga oshirishlarni taqqoslang:

• Yopiq to‘plamdagi savollar yordamida so‘rovlarni tiplashtirilgan funksiyalarga moslaydigan rasmiy funksiyani chaqirish bo‘yicha qo‘llanma.
• Ko‘nikma kerak yoki kerak emasligini baholaydigan va nomzod ko‘nikmalarni reytinglaydigan ko‘nikma tavsiyasi bo‘yicha qo‘llanma.
• Qisqa ro‘yxatga kiritilgan vositalarni baholashdan oldin dastlabki reytingni amalga oshiradigan FastMCP’ning eksperimental Jev qidiruv transformatsiyasi.
• Vosita chaqiruvlarini qayta tiklaydigan hamda voz kechish yoki tasdiqlash talab qilinadigan holatlarni boshqaradigan Composio provayderi.

Ushbu yozuvlarni taqqoslash oddiy mashhurlik reytingi yashirib qo‘yadigan arxitektura tanlovlarini, jumladan bosqichma-bosqich qidirish, aniq voz kechish va tasdiqlashni alohida boshqarishni ochib beradi.

Kontekst tanlovini baholash

Agar Jev fayllar yoki xotiralarni reytinglashi kerak bo‘lsa, reklama namoyishlaridan ko‘ra o‘lchangan misollardan boshlang. Katalogda xatolarsiz ko‘rib chiqish konteksti tajribasida har bir nomzod fayl uchun bittadan Score ishlatilgani va amalda hech qanday devor vaqti yaxshilanishisiz hisoblangan kiritma sezilarli darajada ko‘paygani qayd etilgan. Bu natija namuna har doim samarasiz ekanini isbotlamaydi, biroq uni soddaroq bazaviy yechim bilan taqqoslab sinash uchun aniq sabab beradi.

Ilg‘or maslahatlar

Mustaqil o‘lchovlarni afzal ko‘ring

Usullar, bazaviy yechimlar, muvaffaqiyatsizliklar va xom yoki qayta tiklanadigan dalillarni e’lon qiladigan benchmark yozuvlariga ustuvorlik bering. Katalog Hermes Agent’ning kompaktlashni baholashini alohida ta’kidlaydi, chunki unda Jev mavjud umumlashtirgich bilan taqqoslangan va yondashuvni qabul qilmaslik haqida qaror e’lon qilingan.

Xuddi shuningdek, neytral natija ham foydali bo‘lishi mumkin. Ko‘r-ko‘rona baholash Jev amaldagi model bilan faqat durang natija ko‘rsatganini aniqlaganidan so‘ng, worldmonitor integratsiyasi shadow mode rejimida qoldi. Bu yangi qaror tizimini sinashda uni ishlab chiqarish xatti-harakatlariga darhol ta’sir qildirmaslik uchun amaliy namunadir.

Variantlar tartibiga sezgirlikni sinang

Bir mustaqil hisobotda variantlar tartibini teskari o‘zgartirish ehtimolni 0.9 chegarasidan o‘tadigan darajada o‘zgartirgani aniqlangan. Natija takroran tasdiqlanmagan, shuning uchun uning kattaligini universal deb qabul qilmaslik kerak. Biroq u qimmatli barqarorlik sinovini taklif qiladi:

1. Xuddi shu qarorni variantlarning asl tartibida bajaring.
2. Ma’nosini o‘zgartirmagan holda variantlarni aralashtiring yoki teskari tartiblang.
3. Tanlangan javoblar va ishonch qiymatlarini taqqoslang.
4. Operatsion chegaraviy qiymatlar kesib o‘tilgan-o‘tilmaganini tekshiring.

Agar zararsiz qayta tartiblash ishlab chiqarishdagi xatti-harakatni o‘zgartirsa, chegara ko‘ringanidan kamroq barqaror bo‘lishi mumkin.

Teng byudjetlar va sodda bazaviy yechimlarni taqqoslang

Jev’ni har doim u almashtirishi kerak bo‘lgan tizim bilan taqqoslang. Yangilik bo‘yicha tartiblash, deterministik qoidalar, amaldagi klassifikator yoki maxsus qayta reytinglovchi kabi sodda muqobillarni ham kiriting. Kontekst byudjetlari farq qilganda, baholash qo‘shimcha kiritma emas, balki qaror sifatini ajratib ko‘rsatishi uchun natijalarni tenglashtirilgan byudjetlarda taqqoslang.

Tiplashtirilgan chiqishni to‘g‘ri chiqishdan ajrating

Tiplashtirilgan javoblar integratsiya qulayligini oshiradi, biroq ular asosiy qaror to‘g‘ri ekanini kafolatlamaydi. Ilovangizga xos ma’lumotlarda aniqlik, kalibrlash, kechikish, xarajat va muvaffaqiyatsizlik xatti-harakatini tekshiring.

Voz kechish va ko‘rib chiqish uchun loyihalang

Katalogdagi misollarga aniq voz kechish, tasdiqlash talab qilinadigan holatlar, shadow deployment’lar va ixtiyoriy yoqiladigan funksiyalar kiradi. Bu namunalar, ayniqsa, yuqori ishonch bilan berilgan noto‘g‘ri javob xavfli yoki qimmat harakatni ishga tushirishi mumkin bo‘lgan holatlarda foydalidir.

Amalga oshirishdan oldin moslikni tekshiring

Platformalararo farqlar uchun repozitoriydagi moslik hujjatlarini ko‘rib chiqing. Python, JavaScript, TypeScript, Go yoki boshqa tilda yozilgan misollar bir xil xatti-harakat yoki integratsiya tafsilotlarini taqdim etadi, deb taxmin qilmang.

Katalog ma’lumotlaridan to‘g‘ri foydalaning

Loyihani tahrirlashda catalog.json faylini asosiy manba sifatida qabul qiling va undan keyin README faylini qayta yarating. Repozitoriy nishonlari katalog ma’lumotlari CC0-1.0, loyiha kodi esa MIT litsenziyasiga ega ekanini ko‘rsatadi, biroq litsenziyalari farq qilishi yoki umuman bo‘lmasligi mumkinligi sababli havola berilgan loyihalarni alohida tekshirishingiz kerak.

Qochish kerak bo‘lgan keng tarqalgan xatolar

• Katalogni tavsiya sifatida talqin qilish: ro‘yxatga kiritilish faqat havola ko‘rib chiqilgani va ishlashi tasdiqlanganini bildiradi.
• Misollarni faqat yulduzlar soniga qarab tanlash: ommaboplik to‘g‘rilik, kalibrlanganlik yoki moslikni anglatmaydi.
• Choice’ni mustaqil Noul xulosalari bilan adashtirish: bu yondashuvlar turli savollarga javob beradi.
• Taqqoslash asosisiz sotuvchi keltirgan samaradorlik ko‘rsatkichlariga ishonish: mustaqil va qayta ishlab bo‘ladigan o‘lchovlarga ustuvorlik bering.
• Salbiy natijalarni e’tiborsiz qoldirish: muvaffaqiyatsiz yoki neytral tajribalar ko‘pincha muhandislik uchun eng amaliy yo‘l-yo‘riqni beradi.
• Qat’iy tiplashtirilgan chiqish to‘g‘rilikni kafolatlaydi, deb hisoblash: qarorlarni belgilangan yoki boshqa jihatdan asoslab bo‘ladigan haqiqiy ma’lumotlar bilan tekshiring.
• Yaratilgan README faylini bevosita tahrirlash: buning o‘rniga catalog.json faylini yangilang va build skriptini ishga tushiring.

Xulosa

awesome-jev’dan Jev integratsiyalari uchun dalillarga yo‘naltirilgan tadqiqot xaritasi sifatida foydalanish eng ma’qul. Tizimingiz hal qilishi kerak bo‘lgan qarordan boshlang, misollarni naqsh va primitiv bo‘yicha saralang, cheklovlarni ko‘rib chiqing va har bir da’voni asl manbada tekshiring. Dizaynni joriy etishdan oldin uni o‘z ma’lumotlaringizda qayta sinang, oddiy bazaviy usullar bilan taqqoslang, ishonchlilik barqarorligini tekshiring hamda javob bermaslik yoki inson tomonidan ko‘rib chiqish imkoniyatini rejalashtiring.