Indlela Yokufaka Nokusebenzisa Amakhono e-Jev Ezinqumweni Zama-ejenti

Okwenziwa yi-Jev Skills

I-Awesome Jev Skills iqoqo lamakhono ayisishiyagalolunye afakekayo okungeza izinqumo ezihlelekile ekugelezeni komsebenzi kwama-ejenti e-AI. I-Jev ikhetha phakathi kwabancintisanayo, ihlukanisa okokufaka ngezigaba, futhi inike amaphuzu ezimfanelweni ezichaziwe. I-ejenti yakho iyaqhubeka nokuba nesibopho sokuqoqa umongo, ukubiza amathuluzi, ukwenza umsebenzi, nokuqinisekisa imiphumela.

Indawo yokugcina inezimo ezingu-90 nezibonelo ezingu-14 ezirekhodiwe zokokufaka nokokukhipha. Izindlela zayo zokupheka zihlanganisa ama-ejenti asebenza isikhathi eside, ukuhlola, ukuqondisa, ukuphathwa komongo, ukusebenzisana nesiphequluli, ukuhlunga ibhokisi lokungenayo, ubufakazi bamadokhumenti, amathuluzi onjiniyela, ukulingisa, imidlalo, nokugeleza komsebenzi kokudala.

I-Jev iyakhetha noma inike amaphuzu. Ayichofozi izinkinobho, ayithumeli imilayezo, ayiguquli amafayela, ayikhiqizi imidiya, futhi ayenzi isenzo esikhethiwe.

Izici Ezibalulekile

• Izinhlobo zezinqumo ezihlelekile: Sebenzisa choice ukukhetha umuntu oyedwa kwabancintisanayo, noul ekwahluleleni okuzimele kweqiniso noma okungelona iqiniso, kanye ne-score emazingeni anikezwa amaphuzu.
• Amakhono akhethekile: Faka amakhono okuhlunga, amadokhumenti, izixhumanisi zabasebenzisi, ukuqondisa, umongo, ukubuyekezwa kwekhodi, ukuthola ikhodi, nokulingisa.
• Izindawo zokuhlola ze-ejenti: Cela i-Jev ukuthi ithole ukwehluleka okuphindaphindiwe, ihlole ubufakazi bokuqedwa, ikhethe indlela, noma ihlole ukuthi isenzo esihlongozwayo siyayiqhubekisela yini phambili injongo.
• Izahlulelo ezifanayo: Faka imibuzo eminingana ezimele ngesimo esabiwe esicelweni esisodwa, noma uvumele i-ejenti ephethe ihlele izicelo ezizimele ngokusebenza okufanayo okulinganiselwe.
• Ukuqinisekisa ngaphandle kwe-inthanethi: Sebenzisa --dry-run ukuqinisekisa okokufaka ngaphandle kokwenza ucingo lwenethiwekhi noma ukukhiqiza ukuhlukaniswa.
• Imodi yokulingisa ecacile: Uma ukhiye we-OpenRouter ungatholakali, i-ejenti yakho yamanje ingalingisa isahlulelo esifanayo kuphela ngemva kokuba uvumele leyo modi.

Ukukhetha ikhono

• jev: Chaza isinqumo sangokwezifiso noma ungeze indawo yokuhlola evamile ye-ejenti.
• jev-triage: Hlukanisa futhi ubeke phambili imilayezo, amathikithi, noma impendulo.
• jev-documents: Khetha izingxenye zemithombo futhi uhlole ubufakazi obusekelayo.
• jev-ui: Khetha phakathi kwezenzo zesiphequluli noma zedeskithophu esezibonwe ngaphambilini.
• jev-route: Ncoma ithuluzi, imodeli, noma uchwepheshe.
• jev-context: Hlola ukuhambisana futhi unqume ukuthi ukunciphisa umongo kungafaneleka nini.
• jev-code-review: Beka phambili izinguquko zekhodi ezizobuyekezwa.
• jev-find-code: Khetha indawo elandelayo ohlwini lwamafayela olubonwe.
• jev-simulation: Khetha izenzo ezisemthethweni emhlabeni olingiswayo.

Ukufakwa

Ukufakwa okunconywayo okusizwa yi-ejenti

Indlela enconywayo ukunikeza u-Codex, u-Claude Code, noma i-OpenCode umsebenzi wokufaka. Namathisela lo myalelo ku-ejenti yakho:

Fakela i-Jev Skills ye-ejenti yami yamanje, okuhlanganisa ikhono elivamile nawo wonke amakhono ezimo. Funda futhi ulandele lo mhlahlandlela wokufaka, bese uqinisekisa ukufakwa:
https://raw.githubusercontent.com/wuyoscar/jev-skill/main/docs/install.md

I-ejenti ihlola imvelo yakho, ifake ngokuzenzakalela kuphrojekthi yamanje, futhi iqinisekise ukufakwa ngaphandle kwe-inthanethi. Indlela yokufaka ezenzakalelayo ayidingi i-Node, i-npm, noma i-akhawunti ye-Vercel. Phatha noma yiziphi izicelo zokugunyazwa eziphakanyiswa yi-ejenti yakho.

Ukuze ufake ngesandla noma uxazulule izinkinga, bheka umhlahlandlela wokufaka ngesandla.

Lungiselela ukufinyelela kwangempela ku-Jev

Izingcingo zangempela ze-Jev zidinga i-OPENROUTER_API_KEY. Dala owodwa nge-izilungiselelo ze-OpenRouter bese uwulungiselela endaweni yakho. Ungalokothi unamathisele ukhiye engxoxweni. Izingcingo ezibukhoma zisebenzisa i-API futhi zingase zibangele izindleko zokusetshenziswa.

Uma kungatholakali ukhiye, i-ejenti kufanele ikuxwayise bese ilinda okukodwa kwalokhu okukhethwayo:

1. Inketho A: Thola futhi ulungiselele ukhiye endaweni yakho, bese usebenzisa i-Jev yangempela.
2. Inketho B: Vumela i-ejenti yamanje ilingise ukuhlukaniswa ngomongo, abancintisanayo, kanye nezimfanelo ezifanayo.

Imiphumela yokulingisa kufanele ibhalwe mode: agent_simulation kanye ne-jev_called: false. Akuyona impendulo ye-Jev noma amathuba alinganisiwe e-Jev, ngakho i-ejenti akufanele isungule amanani amathuba.

Imodi yokulingisa nemodi ye-dry-run yehlukene. Ukulingisa kukhiqiza isahlulelo se-ejenti yamanje. I-dry run iqinisekisa kuphela ifomethi yesicelo futhi ayenzi ukuhlukaniswa.

Ukusetshenziswa Okuyisisekelo

Zama isibonelo sokuhlunga esifakiwe

Ngemva kokufaka, cela i-ejenti yakho ukuthi isebenzise isibonelo esifakwe ku-jev-triage. Lo msebenzi ubonisa okokufaka, uqinisekisa imodi yokwenza, futhi uvimbela i-ejenti ekwenzeni izenzo ebhokisini leposi.

Sebenzisa ikhono le-jev-triage bese ufunda i-assets/example.json kufolda yalo efakiwe. Bonisa umongo wayo, imibuzo nabancintisanayo. Uma i-OPENROUTER_API_KEY ingekho, ngicele ngikhethe u-A: lungiselela ukhiye we-Jev yangempela; noma u-B: vumela i-ejenti yamanje ilingise. Linda ukukhetha kwami. Kumodi ye-API, qinisekisa nge---dry-run, bese wenza ucingo olulodwa lwe-Jev. Kumodi yokulingisa, bhala umphumela ngokuthi "Agent simulation; Jev not called" futhi ungasunguli amathuba. Bonisa okokufaka okuphelele, okukhiphayo nemodi. Ungangeni ebhokisini lami leposi noma wenze izenzo.

Uma i-ejenti ingakwazi ukuthola ikhono elisanda kufakwa, yicele ihlole ifolda yokufaka futhi ilayishe kabusha iseshini uma iklayenti lakho likudinga.

Qonda isakhiwo sesicelo

Isicelo se-Jev sihlinzeka ngemodeli, isimo esabiwe, kanye nombuzo owodwa noma eminingi. Umbuzo ngamunye uchaza uhlobo lwawo, imiyalelo, kanye nemibandela yabakhethi lapho kudingeka. Isibonelo esifushanisiwe esilandelayo sibuza ukuthi i-agent kufanele yenzeni ngemva kokuba iphutha elifanayo le-parser liphindeke:

{
  "model": "typesafe/jev-1.13",
  "state": {
    "goal": "Lungisa i-CSV parser futhi uqinisekise izivivinyo ngaphambi kokumemezela ukuthi sekuqediwe.",
    "recent_result": "I-UnicodeDecodeError efanayo yenzeke kabili; alukho ushintsho kumthombo.",
    "observation": "I-parser ivula amafayela ngaphandle kokucacisa i-encoding."
  },
  "questions": {
    "next_step": {
      "type": "choice",
      "instructions": "Khetha isinyathelo esilandelayo esiwusizo ngokusekelwe ebufakazini.",
      "criteria": {
        "inspect_input": "Hlola i-input kanye nekhodi evula amafayela.",
        "retry_unchanged": "Zama futhi kuphela uma isimo esishintshashintshayo sesishintshile.",
        "report_done": "Bika ukuthi sekuqediwe kuphela uma izivivinyo ziphumelela.",
        "ask_user": "Buza uma igunya noma ulwazi olubalulekile lungekho."
      }
    },
    "stuck": {
      "type": "noul",
      "instructions": "Ingabe imizamo engashintshile iphinde yaveza iphutha elifanayo?"
    }
  }
}

Esibonelweni se-API sokwenziwa esigciniwe se-repository, u-Jev ukhethe inspect_input futhi wabuyisa stuck = true. Lesi yisinqumo esisekelwe ebufakazini obunikeziwe, hhayi ukwenziwa kokulungisa.

Sebenzisa umugqa womyalo ongawukhetha

Uma i-jev-decide ifakiwe, gcina isicelo esiphelele njenge-request.json. Qinisekisa kuqala ungaxhunyiwe ku-inthanethi:

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

Ngemva kokubuyekeza nokuvuma idatha ezothunyelwa ku-OpenRouter, yenza isicelo esisodwa esibukhoma bese ugcina umphumela:

jev-decide decide request.json > result.json

Uma kufakwe ikhono elijwayelekile kuphela futhi umyalo ungatholakali, sebenzisa iskripthi salo se-Python:

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

Hlala uhlola i-result.json. Ikhodi yokuphuma engu-0 isho ukuthi kukhethwe noma kwatholakala amaphuzu omphumela, u-2 usho ukuthi kudingeka ukubuyekezwa, kanti u-1 usho ukuthi kwenzeke iphutha. Ukukhetha okuphumelele akusho ukuthi isenzo esikhethiwe senziwe.

Ukuhamba Komsebenzi Okusebenzayo: Engeza Izindawo Zokuhlola Izinqumo

I-Jev yakhelwe izindawo ezibalulekile zokuthatha izinqumo, hhayi zonke izinyathelo ezincane ze-agent. Engeza indawo yokuhlola lapho amaphutha ephindeka, kufanele kukhethwe indlela, noma i-agent isizomemezela ukuthi umsebenzi usuqediwe.

Sebenzisa ikhono le-jev ukweseka izinqumo ngenkathi ulungisa i-CSV parsing futhi uphasisa izivivinyo zokuqala. Uma ukhiye ungekho, ngicele ukuthi ngikhethe i-Jev yangempela noma ukulingisa kwe-current-agent. Sebenzisa imodi ekhethiwe lapho amaphutha ephindeka, kudingeka kukhethwe indlela, noma usuzomemezela ukuthi umsebenzi usuqediwe. Nikeza umgomo, ukuhlolwa kokwamukelwa, umlando ofanele, imiphumela emisha yamathuluzi, izimvume, kanye nencazelo yesenzo ngasinye esingakhethwa. Yenza kuphela ngaphakathi kwegunya elikhona futhi uqinisekise umphumela kamuva.

Indawo yokuhlola ukuqedwa kufanele ithole ubufakazi bangempela obufana nezihlonzi zama-artifact, amarekhodi ezivivinyo, ama-hashi ezinguqulo, ukuhlolwa kwesistimu yamafayela, kanye nesimo somsebenzi. I-Jev ingahlulela ukuthi ubufakazi obunikeziwe buyasisekela yini isimangalo, kodwa ayikwazi ukuqinisekisa ukuthi isivivinyo sagijima ngempela noma ukuthi ifayela likhona. Lawo maqiniso kufanele avele kumathuluzi.

Hlukanisa Amarekhodi Ngokuphepha

Ngempendulo, amathikithi osizo, noma amanye amarekhodi, qala ngesampula encane esuswe imininingwane ebucayi. Vumelanani ngezigaba, imibuzo, kanye nedatha ephumayo ngaphambi kokucubungula iqoqo elikhulu.

1. Khetha amarekhodi amathathu amele iqoqo.
2. Gcina isihlonzi serekhodi ngalinye, umbhalo wokuqala, kanye nomongo ofanele.
3. Chaza izigaba ezifana ne-billing, bug, how-to, kanye ne-other.
4. Buyekeza ngqo lokho obekuzophuma emshinini wakho.
5. Khetha imodi ye-API yangempela noma imodi yokulingisa evunywe ngokusobala.
6. Gcina imiphumela engaqinisekile ihlukile ukuze ibuyekezwe umuntu.
7. Hlola isampula ngaphambi kokwandisa usayizi weqoqo noma ibhajethi.

Ungabuza imibuzo eminingi mayelana nerekhodi ngalinye esicelweni esisodwa, njengokuthi isigaba nokuphuthuma. Ezicelweni ezizimele, i-agent ephethe ingasebenzisa concurrency elinganiselwe; i-CLI ngokwayo ayiqali imisebenzi ehambisanayo.

Amathiphu Athuthukile

Nikeza umongo ophelele

I-Jev ayizizuzeli ngokuzenzakalelayo izingxoxo ze-agent yakho. Faka umgomo, imithetho, umlando ofanele, ubufakazi bomthombo, okubhekiwe manje, izimvume, izincazelo zabakhethi, kanye nokuhlolwa kokwamukelwa. Gcina umbuzo wesinqumo unomkhawulo, kodwa ungabunciphisi ngokungeyikho ubufakazi bawo.

Buyekeza zonke izinkambu ezihlobene

Lapho ulungisa isifanekiso, buyekeza i-state, i-questions, kanye ne-criteria ndawonye. Ukushintsha umbhalo wesibonelo kuphela kungashiya izincazelo zabakhethi zingahambisani nomsebenzi wangempela.

Hlukanisa izinqumo negunya

Isenzo esinamaphuzu aphezulu asivunyelwe ngokuzenzakalelayo. Izimvume ezikhona kanye nezilawuli zokuphepha zisabusa ukwenziwa. Ngokufanayo, ukuvumelana phakathi kohlelo kanye nocingo lwethuluzi oluhlongozwayo akufakazeli ukuthi noma yikuphi kwalokho kugunyaziwe.

Sebenzisa isimo esisha ezinyathelweni ezincike komunye nomunye

Izahlulelo ezizimele zingabelana ngesimo esisodwa noma zisebenze ngesikhathi esisodwa. Izinqumo ezincike komunye nomunye kufanele zisebenzise okubhekiwe okusha ngemva kwesenzo sangaphambilini. I-Jev ayithathi indawo yokuhlela okuvulekile, ukwenziwa kwamathuluzi, noma ukukhiqizwa kombhalo.

Humusha amanani ngendlela efanele

Embuzweni we-noul, i-probability imele amathuba okuthi isitatimende siyiqiniso, ngisho nalapho inani elikhethiwe lingelona iqiniso. Amaphuzu e-rubric afana no-1.29 / 2 angamaphuzu ahleliwe, hhayi amathuba.

Gcina ubufakazi namamodi

Gcina konke okufakiwe, okukhiphayo okujwayelekile, irisidi eluhlaza uma lutholakala, kanye nemodi yokwenza. Londoloza ubufakazi obuphikisanayo esikhundleni sokububhala kabusha ukuze buhambisane nempendulo ekhethiwe. Ungalokothi wethule ukulingisa kwe-agent njengempendulo yangempela ye-API.

Hlanganisa i-Jev namathuluzi e-host

Ukuchofoza esipheqululini, ukulethwa kwemilayezo, ukuhlelwa kwamafayela, ukwenziwa komculo, kanye nokunikezwa kwamavidiyo kudinga amathuluzi ahlukene. I-Jev ingalinganisa amakhandidethi noma ikhethe phakathi kwezenzo ezisemthethweni ezibonwe, kuyilapho uhlelo lwe-host lusebenzisa futhi luqinisekise umsebenzi okhethiwe.

Isiphetho

Amakhono e-Jev ahlinzeka ngamaphethini angasetshenziswa kabusha okungeza izinketho ezicacile, ukuhlukanisa ngezigaba, amaphuzu, kanye nokuhlolwa kobufakazi ekugelezeni komsebenzi kwama-agent. Qala ngokufakwa okusizwa yi-agent, hlola isibonelo esinikeziwe, qinisekisa izicelo usebenzisa i---dry-run, bese ubuyekeza isampula encane ngaphambi kokwandisa. Imiphumela emihle kakhulu itholakala ngomongo ophelele, amakhandidethi achazwe ngokucacile, izindlela zokwenza ezicacile, kanye nokuqinisekiswa okuzimele ngemva kwesenzo ngasinye esibalulekile.