Setha futhi Usebenzise i-dsh-superagent Emisebenzini Yokubhala Ikhodi ye-GitHub Eqhubekayo

Yini i-dsh-superagent?

dsh-superagent iyi-ejenti yokubhala ikhodi esebenza ngokuqhubekayo, eyakhelwe ukusebenza nendawo yokugcina ikhodi eyodwa ku-GitHub. Isatshalaliswa njengephakheji ye-DeepSeek Harness futhi ilalela izicelo ezivela ku-GitHub kanye, ngokuzikhethela, ku-Feishu.

Uma umsebenzisi ogunyaziwe eyicela ukuba yenze umsebenzi, uhlelo luvula into yomsebenzi, ludale iseshini nefolda ezinikezelwe ye-ejenti, luqede umsebenzi, bese luphendula engxoxweni yokuqala. Umphumela ungase uhlanganise i-pull request. Iphaneli yewebhu ibonisa izinto ezidinga ukunakwa ngumuntu.

dsh-superagent iyisibonelo socwaningo esenzelwe ukubhekiselwa kuso, akuwona umkhiqizo osemthethweni we-DeepSeek noma uhlelo olulungele ukusetshenziswa ekukhiqizeni.

Indawo yokugcina ikhodi eshicilelwe ihlukile enguqulweni yangaphakathi yeqembu kanye nokuqalisweni okuxoxwe ngakho ku-Exploring Super-agent Design: Towards a More Autonomous Agent System. Eminye imibono ekuleso sihloko ichaza izinkomba zesikhathi esizayo futhi ayikakaqaliswa kulesi sibonelo.

Umgomo Oyinhloko Wokuklama

Le phrojekthi ihlose ukusebenzisa ukunakwa kwabantu okuncane ngangokunokwenzeka, kodwa ilethe inani elikhulu ngangokunokwenzeka. Ngenxa yokuthi i-ejenti esebenzela iqembu lonke nayo ingase idle ukunakwa kweqembu, i-dsh-superagent ilandela imikhawulo emibili ebalulekile:

• Yenza okuthile kuphela lapho othile eyicela ukuba yenze kanjalo noma lapho umthetho ochazwe yiqembu uvumela leso senzo.
• Ikhuluma kuphela lapho othile kufanele athathe isinyathelo noma engasebenzisa umphumela oqediwe.

Ngaphambi kokusebenzisa i-ejenti, funda idokhumenti yefilosofi. Ichaza lo mgomo wokusebenza kanye nezibopho zomuntu osebenzisa uhlelo.

Izici Ezibalulekile

• Ukugxila endaweni eyodwa yokugcina ikhodi: Ukufakwa ngakunye kusebenza nendawo eyodwa yokugcina ikhodi ku-GitHub.
• Ukuhlanganiswa ne-GitHub: I-ejenti ilalela izicelo ezigunyaziwe ezivela ku-GitHub.
• Ukuhlanganiswa ne-Feishu ngokuzikhethela: Amaqembu angasebenzisa ne-Feishu njengomthombo wezicelo.
• Ukulandelela izinto zomsebenzi: Isicelo esamukelwe siba yinto yomsebenzi.
• Ukwenza umsebenzi okuhlukanisiwe: Umsebenzi ngamunye usebenza eseshini nefolda yawo ye-ejenti.
• Izimpendulo eziqaphela ingxoxo: Imiphumela ibuyiselwa engxoxweni lapho isicelo siqale khona.
• Iphaneli yokunakwa ngabantu: Iphaneli yewebhu ikhomba umsebenzi odinga ukubandakanyeka komuntu.
• Ukuziphatha okulawulwa yimithetho: I-ejenti yenza okuthile kuphela ngenxa yesicelo noma umthetho weqembu ocacile.

Ngaphambi Kokufaka

Phatha indawo yokugcina ikhodi njengekhodi yocwaningo. Kungenzeka ibe namaphutha, izitayela zokubhala ikhodi ezingahambisani, noma izinqumo zobunjiniyela ezingafanele indawo yakho. Hlola ukuqaliswa kwayo bese uyivumelanisa nezidingo zakho ngaphambi kokuyithemba.

Ukusetha kunezinyathelo eziningi, ngakho iphrojekthi incoma ukuthi ukuqede ngokubambisana ne-ejenti yokubhala ikhodi kunokuzama ukuqagela mathupha ukucushwa okudingekayo.

Ukufaka Nokusetha Okuqondiswayo

Isinyathelo 1: Vula Indawo Yokugcina Ikhodi Nge-ejenti Yakho Yokubhala Ikhodi

Yenza indawo yokugcina ikhodi oyiklone noma oyikhiphile itholakale ku-ejenti yakho yokubhala ikhodi. Bese uyinika umyalelo wokusetha onconywe yiphrojekthi:

Read SETUP.md in this repository and set up dsh-superagent with me.

I-ejenti yokubhala ikhodi kufanele ilandele SETUP.md njengomthombo wayo oyinhloko wolwazi.

Isinyathelo 2: Phendula Imibuzo Yokusetha

Inqubo yokusetha yakhelwe ukubuza umbuzo owodwa omfushane ngesikhathi. Nikeza ulwazi oluceliwe mayelana nendawo yakho yokugcina ikhodi, ukuhlanganiswa, kanye nemvelo yakho. Gwema ukweqa izinyathelo zokubuyekeza ngoba nje le nqubo isizwa yi-ejenti.

Isinyathelo 3: Buyekeza Uhlelo Oluphelele

Ngemva kokuqoqa ulwazi oludingekayo, i-ejenti yokubhala ikhodi izokwethula uhlelo oluphelele kanye. Luhlole ngokucophelela ngaphambi kokuvumela izinguquko zokufaka noma zokucushwa. Ikakhulukazi, qinisekisa ukuthi uhlelo luhambisana nendawo yokugcina ikhodi ohlose ukuthi i-ejenti iyiphathe kanye nemithombo yezicelo ohlose ukuyivula.

Isinyathelo 4: Vumela I-ejenti Ifake Futhi Ilungise Iphrojekthi

Uma usuvumile uhlelo, i-ejenti yokubhala ikhodi ifaka futhi ilungise uhlelo ngokwe-SETUP.md. Ngenxa yokuthi i-README idlulisela inqubo enemininingwane yokusetha kulelo fayela, landela imiyalelo yalo yamanje kunokuthembela emiyalweni engabhaliwe.

Isinyathelo 5: Qinisekisa Iphrojekthi

Ukuze uqinisekise ukuthuthukiswa, sebenzisa:

pnpm check

Lo myalo usebenzisa ukuhlolwa kwezinhlobo, izivivinyo, nokwakha. Ukusebenza ngempumelelo kunikeza ukuhlolwa okuhlangene kwezinhlobo zephrojekthi, iqoqo lezivivinyo, kanye nenqubo yokwakha.

Qonda Amadokhumenti Ngaphambi Kokusebenzisa I-ejenti

Amadokhumenti anezinombolo ahloswe ukufundwa ngokulandelana. Wafunde ngokulandelana kwawo ngoba idokhumenti ngayinye ithatha kuphela izinto ezethulwe ngaphambi kwayo:

1. 000 Ifilosofi: Qonda umgomo wokusebenza onciphisa isidingo sokunakwa kanye nezibopho zomqhubi.
2. 001 Imodeli yesizinda: Funda imiqondo eyisisekelo yephrojekthi nokuthi ihlobene kanjani.
3. 002 Ukugunyazwa: Thola ukuthi ubani ovunyelwe ukucela i-ejenti ukuthi yenze umsebenzi.
4. 003 Ukwenziwa komsebenzi: Qonda ukuthi imisebenzi eyamukelwe yenziwa kanjani.
5. 004 Imiyalelo: Buyekeza imiyalelo eqondisa ukuziphatha kwe-ejenti.
6. 005 Iphaneli: Funda ukuthi iphaneli yewebhu iziveza kanjani izinto ezidinga ukunakwa ngumuntu.
7. 006 Ukufakwa nokuphathwa: Landela iziqondiso zokusetha ngesandla, ukumisa, ukuthuthukisa, nokuxazulula izinkinga.
8. 007 Ukwakhiwa kohlelo: Funda ngesakhiwo sobuchwepheshe besistimu.
9. 008 Incwadi yezindlela: Funda ukuthi ungayengeza kanjani i-Source.

Ukusetshenziswa Okuyisisekelo

Thumela Isicelo Esigunyaziwe

Ngemva kokusetha, umsebenzisi ovunyelwe angacela i-ejenti ukuthi yenze umsebenzi endaweni yokugcina ikhodi nge-GitHub noma nge-Feishu uma lokho kuhlanganiswa okukhethwayo kuvuliwe. Isicelo esivamile kufanele sichaze ushintsho olufunwayo endaweni yokugcina ikhodi kanye nanoma yiziphi izindlela ezifanele zokwamukela umsebenzi.

Ngokwesibonelo, umsebenzisi ogunyaziwe angacela i-ejenti ukuthi iphenye udaba lwendawo yokugcina ikhodi, yenze ushintsho olufanele kukhodi, bese ibuyisa umphumela. Indlela eqondile yokuthumela isicelo kanye nabasebenzisi abavunyelwe kuncike ku-Source oyimisile kanye nemithetho yokugunyaza.

Vumela I-ejenti Idale Futhi Isebenze Entweni Yomsebenzi

Lapho isicelo samukelwa, i-dsh-superagent ivula into yomsebenzi bese yenza umsebenzi eseshini yayo ye-ejenti nakumkhombandlela wayo. Le modeli yokwenza umsebenzi igcina umongo womsebenzi uhlukile.

Thola Umphumela Kumongo

I-ejenti iphendula engxoxweni yokuqala kunokuphoqa abasebenzisi ukuthi bafune imiphumela kwesinye isiteshi. Kuya ngomsebenzi owenziwe, impendulo ingafaka i-pull request.

Sebenzisa Iphaneli Ukulandelela Komuntu

Hlola iphaneli yewebhu ukuze ubone umsebenzi odinga umuntu. Iphaneli isekela umgomo wephrojekthi wokuphatha ukunakwa ngokubonisa izinto ezidinga isenzo somuntu, kunokudala ukuxhumana okungadingekile mayelana nazo zonke izinyathelo zangaphakathi.

Ukugunyaza Nokusebenza Ngokuphepha

Ukugunyaza kusemqoka ekwakhiweni kohlelo. I-ejenti esebenza ngokuzimela futhi ekwazi ukwenza izenzo endaweni yokugcina ikhodi yeqembu akufanele yamukele izicelo ezingahleliwe. Sebenzisa imibhalo yokugunyaza ukuze uchaze ukuthi ubani ongaqalisa umsebenzi nokuthi ngaphansi kwaziphi izimo.

• Khawulela abaceli: Vumela abantu noma amasistimu ahlosiwe kuphela ukuthi bakhe izicelo ezingenziwa.
• Buyekeza imithetho yeqembu: Qinisekisa ukuthi izenzo ezizenzakalelayo zenzeka kuphela ngaphansi kwemithetho ebhalwe ngokucacile yiqembu.
• Gcina ukubuyekezwa komuntu: Phatha izinguquko ezidalwe yi-ejenti njengomsebenzi ongadinga ukuhlolwa nokulungiswa.
• Hlola ngaphambi kokusetshenziswa kabanzi: Sebenzisa pnpm check ngemva kwezinguquko zentuthuko futhi uqinisekise ukuziphatha endaweni yakho.

Amathiphu Athuthukile

Sebenzisa Umhlahlandlela Wokufakwa Ukuze Wenze Imisebenzi Ngesandla

Uma udinga ukusetha ngesandla, ukushintsha ukumiswa, ukuthuthukisa iphrojekthi, noma ukuxazulula izinkinga zayo, bheka 006 Ukufakwa nokuphathwa. I-README ikhomba lo mbhalo njengomthombo onemininingwane walezo zinqubo zokusebenza.

Buyekeza Imiyalelo Lapho Ulungisa Ukuziphatha

Funda 004 Imiyalelo ngaphambi kokushintsha indlela i-ejenti ehumusha noma eyenza ngayo umsebenzi. Izinguquko emiyalelweni zingathinta ukuthi i-ejenti ixhumana nini, iwubhekana kanjani umsebenzi, nokuthi ilandela eduze kangakanani ifilosofi yephrojekthi yokunciphisa isidingo sokunakwa.

Funda Ukwenziwa Komsebenzi Ngaphambi Kokushintsha Ukuhlukaniswa Komsebenzi

Isistimu inika into ngayinye yomsebenzi iseshini yayo ye-ejenti kanye nomkhombandlela wayo. Ngaphambi kokushintsha lokhu kuziphatha, buyekeza 003 Ukwenziwa komsebenzi kanye 007 Ukwakhiwa kohlelo ukuze izinguquko zihlale zihambisana namamodeli wokwenziwa komsebenzi kanye nowesistimu wephrojekthi.

Engeza I-Source Ngokuqaphela

I-Source iwukuhlanganiswa lapho isistimu ingamukela khona umsebenzi. Uma ufuna ukwengeza enye ngaphandle kwezindlela ezinikeziwe ze-GitHub ne-Feishu okukhethwayo, landela 008 Incwadi yezindlela. Ungadluli imodeli yokugunyaza lapho wethula isiteshi esisha sezicelo.

Hlela Ukuthula Okunenzuzo

Lapho ulungisa isistimu, hlola kokubili ukubaluleka kwesenzo kanye nezindleko zokunakwa ezibangelwa izaziso zaso. Khetha ukuxhumana lapho umuntu kufanele enze okuthile noma lapho umphumela osebenzisekayo usulungile. Lokhu kwenza izandiso nemithetho yokusebenza kuhambisane nefilosofi emaphakathi yephrojekthi.

Ukuhamba Komsebenzi Wokuthuthukisa

Ngemva kokushintsha ikhodi, sebenzisa umyalo wokuhlola ohlanganisiwe wephrojekthi:

pnpm check

Ngenxa yokuthi usebenzisa ukuhlolwa kwezinhlobo, izivivinyo, nokwakhiwa, kufanele ube yisinyathelo esivamile sokuhlola ngaphambi kokwabelana noma ukufaka izinguquko. Ukuphumelela kwalo myalo akwenzi i-prototype yocwaningo ilungele ukusetshenziswa ekukhiqizeni; kusafanele ubuyekeze ukuziphatha kwayo, okucatshangwa ngokuphepha, ukugunyaza, nokufaneleka kwayo endaweni yakho.

Isiphetho

i-dsh-superagent inikeza imodeli egxile ocwaningweni yokwabela umsebenzi endaweni eyodwa yokugcina ikhodi ye-GitHub, ngesikhathi inciphisa izidingo zokunakwa komuntu. Qala ngokuhamba komsebenzi okuqondisiwe kwe-SETUP.md, funda imibhalo enezinombolo ngokulandelana, lungiselela ukugunyaza ngokucophelela, qinisekisa izinguquko nge-pnpm check, bese usebenzisa iphaneli ukuze ugxilise umzamo womuntu lapho udingeka khona ngempela.