Jinsi ya Kusakinisha na Kutumia Jev Skills kwa Maamuzi ya Wakala

Jev Skills Hufanya Nini

Awesome Jev Skills ni mkusanyiko wa skills tisa zinazoweza kusakinishwa kwa ajili ya kuongeza maamuzi yaliyopangwa katika mtiririko wa kazi wa mawakala wa AI. Jev huchagua kati ya watahiniwa, huainisha ingizo, na huweka alama kwa vigezo vilivyobainishwa. Wakala wako bado anawajibika kukusanya muktadha, kuita zana, kufanya kazi, na kuthibitisha matokeo.

Hifadhi hii inajumuisha hali 90 na mifano 14 ya ingizo na matokeo iliyorekodiwa. Mapishi yake yanahusu mawakala wanaodumu kwa muda mrefu, tathmini, uelekezaji, usimamizi wa muktadha, mwingiliano na kivinjari, upangaji wa kikasha, ushahidi wa hati, zana za msanidi, uigaji, michezo, na mtiririko wa kazi wa ubunifu.

Jev huchagua au kuweka alama. Haibofyi vitufe, haitumi ujumbe, haibadilishi faili, haitoi midia, wala kutekeleza kitendo kilichochaguliwa.

Sifa Muhimu

• Aina za maamuzi yaliyopangwa: Tumia choice kuchagua mgombea mmoja, noul kwa uamuzi huru wa kweli-au-si kweli, na score kwa viwango vya tathmini.
• Skills maalum: Sakinisha skills za upangaji, hati, violesura vya mtumiaji, uelekezaji, muktadha, ukaguzi wa msimbo, ugunduzi wa msimbo, na uigaji.
• Vituo vya ukaguzi vya wakala: Mwombe Jev itambue kushindwa kunakorudiwa, itathmini ushahidi wa kukamilika, ichague njia, au ichunguze ikiwa kitendo kinachopendekezwa kinasogeza lengo mbele.
• Hukumu sambamba: Weka maswali kadhaa huru kuhusu hali iliyoshirikiwa katika ombi moja, au uruhusu wakala mwenyeji apange maombi huru kwa wakati mmoja kwa kiwango cha juu kilichowekwa.
• Uthibitishaji nje ya mtandao: Tumia --dry-run kuthibitisha ingizo bila kufanya mwito wa mtandao au kutoa uainishaji.
• Hali ya wazi ya uigaji: Ikiwa ufunguo wa OpenRouter haupatikani, wakala wako wa sasa anaweza kuiga hukumu hiyo hiyo baada tu ya kuidhinisha hali hiyo.

Kuchagua skill

• jev: Bainisha uamuzi maalum au ongeza kituo cha ukaguzi cha jumla cha wakala.
• jev-triage: Ainisha na panga kwa kipaumbele ujumbe, tiketi, au maoni.
• jev-documents: Chagua sehemu za chanzo na tathmini ushahidi unaounga mkono.
• jev-ui: Chagua kati ya vitendo vya kivinjari au eneo-kazi ambavyo tayari vimezingatiwa.
• jev-route: Pendekeza zana, modeli, au mtaalamu.
• jev-context: Tathmini umuhimu na bainisha wakati ambapo kufupisha muktadha kunaweza kufaa.
• jev-code-review: Panga kwa kipaumbele mabadiliko ya msimbo kwa ajili ya ukaguzi.
• jev-find-code: Chagua eneo linalofuata kutoka kwenye orodha ya faili iliyozingatiwa.
• jev-simulation: Chagua vitendo halali katika ulimwengu ulioigwa.

Usakinishaji

Usakinishaji unaopendekezwa kwa msaada wa wakala

Njia inayopendekezwa ni kumpa Codex, Claude Code, au OpenCode jukumu la usakinishaji. Bandika ombi lifuatalo katika wakala wako:

Sakinisha Jev Skills kwa wakala wangu wa sasa, ikijumuisha skill ya jumla na skills zote za hali. Soma na ufuate mwongozo huu wa usakinishaji, kisha uthibitishe usakinishaji:
https://raw.githubusercontent.com/wuyoscar/jev-skill/main/docs/install.md

Wakala hukagua mazingira yako, husakinisha katika mradi wa sasa kwa chaguo-msingi, na kuthibitisha usakinishaji nje ya mtandao. Njia ya kawaida ya usakinishaji haihitaji Node, npm, au akaunti ya Vercel. Shughulikia maombi yoyote ya idhini yatakayoibuliwa na wakala wako.

Kwa usakinishaji wa mikono au utatuzi wa matatizo, rejelea mwongozo wa usakinishaji wa mikono.

Sanidi ufikiaji halisi wa Jev

Miwito halisi ya Jev inahitaji OPENROUTER_API_KEY. Unda moja kupitia mipangilio ya OpenRouter na uisanidi kwenye kifaa chako. Usibandike kamwe ufunguo huo kwenye mazungumzo. Miwito ya moja kwa moja hutumia API na inaweza kuleta gharama za matumizi.

Ikiwa hakuna ufunguo unaopatikana, wakala lazima akuonye na asubiri uchague mojawapo ya chaguo hizi:

1. Chaguo A: Pata na usanidi ufunguo kwenye kifaa chako, kisha utumie Jev halisi.
2. Chaguo B: Ruhusu wakala wa sasa aige uainishaji kwa kutumia muktadha, watahiniwa, na vigezo vilevile.

Matokeo ya uigaji lazima yawekwe alama mode: agent_simulation na jev_called: false. Si majibu ya Jev wala uwezekano uliopimwa wa Jev, hivyo wakala hapaswi kubuni thamani za uwezekano.

Hali ya uigaji na hali ya dry-run ni tofauti. Uigaji hutoa hukumu ya wakala wa sasa. Dry run huthibitisha tu muundo wa ombi na haifanyi uainishaji wowote.

Matumizi ya Msingi

Jaribu mfano wa upangaji uliosakinishwa

Baada ya usakinishaji, mwombe wakala wako atumie mfano uliojumuishwa kwenye jev-triage. Zoezi hili huonyesha ingizo, huthibitisha hali ya utekelezaji, na humzuia wakala kuchukua hatua kwenye kikasha.

Tumia skill ya jev-triage na usome assets/example.json kutoka kwenye folda yake iliyosakinishwa. Onyesha muktadha, maswali na watahiniwa wake. Ikiwa OPENROUTER_API_KEY haipo, niombe nichague A: sanidi ufunguo kwa Jev halisi; au B: ruhusu wakala wa sasa aige. Subiri chaguo langu. Katika hali ya API, thibitisha kwa kutumia --dry-run, kisha fanya mwito mmoja wa Jev. Katika hali ya uigaji, weka alama "Uigaji wa wakala; Jev haikuitwa" kwenye matokeo na usibuni uwezekano. Onyesha ingizo kamili, matokeo na hali. Usifikie kikasha changu wala kutekeleza vitendo.

Ikiwa wakala hawezi kupata skill iliyosakinishwa hivi karibuni, mwombe akague saraka ya usakinishaji na apakie upya kipindi ikiwa mteja wako anahitaji hivyo.

Elewa muundo wa ombi

Ombi la Jev hutoa modeli, hali ya pamoja, na swali moja au zaidi. Kila swali hufafanua aina yake, maelekezo, na vigezo vya watahiniwa inapohitajika. Mfano huu mfupi unauliza wakala afanye nini baada ya hitilafu ileile ya kichanganuzi kujirudia:

{
  "model": "typesafe/jev-1.13",
  "state": {
    "goal": "Rekebisha kichanganuzi cha CSV na thibitisha majaribio kabla ya kutangaza kuwa imekamilika.",
    "recent_result": "UnicodeDecodeError ileile mara mbili; hakuna mabadiliko ya chanzo.",
    "observation": "Kichanganuzi hufungua faili bila usimbaji uliowekwa wazi."
  },
  "questions": {
    "next_step": {
      "type": "choice",
      "instructions": "Chagua hatua inayofuata yenye manufaa kulingana na ushahidi.",
      "criteria": {
        "inspect_input": "Kagua ingizo na msimbo wa kufungua faili.",
        "retry_unchanged": "Jaribu tena tu ikiwa hali ya muda imebadilika.",
        "report_done": "Tangaza kuwa imekamilika tu ikiwa majaribio yamefaulu.",
        "ask_user": "Uliza ikiwa mamlaka au taarifa muhimu haipo."
      }
    },
    "stuck": {
      "type": "noul",
      "instructions": "Je, majaribio yasiyobadilika yamerudia hitilafu ileile?"
    }
  }
}

Katika mfano wa API wa kubuniwa uliorekodiwa kwenye hazina, Jev ilichagua inspect_input na kurudisha stuck = true. Huu ni uamuzi unaotegemea ushahidi uliotolewa, si utekelezaji wa marekebisho.

Tumia mstari wa amri wa hiari

Ikiwa jev-decide imesakinishwa, hifadhi ombi kamili kama request.json. Lithibitishe kwanza nje ya mtandao:

jev-decide decide request.json --dry-run

Baada ya kukagua na kuidhinisha data itakayotumwa kwa OpenRouter, tuma ombi moja la moja kwa moja na uhifadhi matokeo:

jev-decide decide request.json > result.json

Ikiwa ujuzi wa jumla tu umesakinishwa na amri haipatikani, tumia hati yake ya Python:

python3 <actual-skill-directory>/scripts/jev.py decide request.json --dry-run

Kagua kila mara result.json. Msimbo wa kutoka 0 unamaanisha kuwa matokeo yalichaguliwa au kupewa alama, 2 inamaanisha ukaguzi unahitajika, na 1 inamaanisha hitilafu imetokea. Uchaguzi uliofaulu bado hautekelezi kitendo kilichochaguliwa.

Mtiririko wa Kivitendo: Ongeza Vituo vya Ukaguzi wa Maamuzi

Jev imeundwa kwa vituo vya maamuzi muhimu badala ya kila hatua ndogo ya wakala. Ongeza kituo cha ukaguzi wakati hitilafu zinajirudia, njia lazima ichaguliwe, au wakala anakaribia kutangaza kukamilika.

Tumia ujuzi wa jev kusaidia maamuzi unaporekebisha uchanganuzi wa CSV na kufaulu majaribio ya awali. Ikiwa ufunguo haupo, niulize nichague Jev halisi au uigaji wa wakala wa sasa. Tumia hali iliyochaguliwa hitilafu zinapojirudia, njia inapohitaji kuchaguliwa, au unapokaribia kutangaza kukamilika. Toa lengo, ukaguzi wa kukubali, historia inayohusika, matokeo mapya ya zana, ruhusa, na maana ya kila kitendo cha mgombea. Tenda tu ndani ya idhini iliyopo na thibitisha matokeo baadaye.

Kituo cha ukaguzi wa kukamilika kinapaswa kupokea ushahidi halisi kama vile vitambulisho vya vizalia, stakabadhi za majaribio, heshi za marekebisho, ukaguzi wa mfumo wa faili, na hali ya kazi. Jev inaweza kuhukumu ikiwa ushahidi uliotolewa unaunga mkono dai, lakini haiwezi kuthibitisha kwamba jaribio liliendeshwa kweli au kwamba faili ipo. Mambo hayo lazima yatokane na zana.

Panga Rekodi kwa Usalama

Kwa maoni, tiketi za usaidizi, au rekodi nyingine, anza na sampuli ndogo iliyofichwa taarifa nyeti. Kubaliana kuhusu kategoria, maswali, na data itakayotumwa nje kabla ya kuchakata kundi kubwa zaidi.

1. Chagua rekodi tatu zinazowakilisha nyingine.
2. Hifadhi kitambulisho cha kila rekodi, maandishi yake ya awali, na muktadha unaohusika.
3. Fafanua kategoria kama vile billing, bug, how-to, na other.
4. Kagua hasa kile ambacho kingetoka kwenye mashine yako.
5. Chagua hali ya API halisi au hali ya uigaji iliyoidhinishwa wazi.
6. Weka matokeo yasiyo na uhakika kando kwa ukaguzi wa binadamu.
7. Kagua sampuli kabla ya kuongeza ukubwa wa kundi au bajeti.

Unaweza kuuliza maswali mengi kuhusu kila rekodi katika ombi moja, kama vile kategoria na uharaka. Kwa maombi huru, wakala mwenyeji anaweza kutumia uendeshaji wa wakati mmoja wenye kikomo; CLI yenyewe haianzishi kazi sambamba.

Vidokezo vya Juu

Toa muktadha kamili

Jev hairithi mazungumzo ya wakala wako kiotomatiki. Jumuisha lengo, kanuni, historia inayohusika, ushahidi wa chanzo, uchunguzi wa sasa, ruhusa, maana za watahiniwa, na ukaguzi wa kukubali. Weka swali la uamuzi kuwa finyu, lakini usifanye ushahidi wake kuwa mdogo isivyo halisi.

Sasisha sehemu zote zinazohusiana

Unaporekebisha kiolezo, sasisha state, questions, na criteria pamoja. Kubadilisha maandishi ya mfano pekee kunaweza kuacha fasili za watahiniwa zikiwa haziendani na kazi halisi.

Tenganisha maamuzi na idhini

Kitendo kilicho na alama kubwa hakiruhusiwi kiotomatiki. Ruhusa zilizopo na vidhibiti vya usalama bado hutawala utekelezaji. Vivyo hivyo, ulinganifu kati ya mpango na mwito wa zana unaopendekezwa hauthibitishi kwamba mojawapo imeidhinishwa.

Tumia hali mpya kwa hatua tegemezi

Hukumu huru zinaweza kushiriki hali moja au kuendeshwa kwa wakati mmoja. Maamuzi tegemezi yanapaswa kutumia uchunguzi mpya baada ya kitendo kilichotangulia. Jev haichukui nafasi ya upangaji wa wazi, utekelezaji wa zana, au uzalishaji wa maandishi.

Tafsiri thamani kwa usahihi

Kwa swali la noul, probability inawakilisha uwezekano kwamba kauli hiyo ni ya kweli, hata thamani iliyochaguliwa ikiwa si ya kweli. Alama ya rubriki kama 1.29 / 2 ni alama ya tathmini, si uwezekano.

Hifadhi ushahidi na hali

Hifadhi ingizo kamili, matokeo yaliyosanifishwa, risiti ghafi inapopatikana, na hali ya utekelezaji. Hifadhi ushahidi unaokinzana badala ya kuubadilisha ili uendane na jibu lililochaguliwa. Usiwasilishe kamwe uigaji wa wakala kama jibu halisi la API.

Changanya Jev na zana za mwenyeji

Mibofyo ya kivinjari, uwasilishaji wa ujumbe, uhariri wa faili, uundaji wa muziki, na uonyeshaji wa video huhitaji zana tofauti. Jev inaweza kupanga watahiniwa au kuchagua miongoni mwa vitendo halali vilivyoonekana, huku programu mwenyeji ikitekeleza na kuthibitisha operesheni iliyochaguliwa.

Hitimisho

Jev Skills hutoa mifumo inayoweza kutumika tena ya kuongeza chaguo, uainishaji, alama, na ukaguzi wa ushahidi ulio wazi kwenye mtiririko wa kazi wa mawakala. Anza kwa usakinishaji unaosaidiwa na wakala, jaribu mfano uliotolewa, thibitisha maombi kwa --dry-run, na kagua sampuli ndogo kabla ya kupanua. Matokeo bora hutokana na muktadha kamili, watahiniwa waliofafanuliwa kwa uwazi, hali za utekelezaji zilizo wazi, na uthibitishaji huru baada ya kila hatua yenye madhara makubwa.