Yakha Ukugeleza Komsebenzi Kwe-AI Agent Okungavumelanisiwe Nokuqinile nge-Unreal Agent

Yini i-Unreal Agent?

I-Unreal Agent iyiharness ye-agent egxile ekusebenzeni okungavumelanisi kusukela ekuqaleni, evela kwa-Unreal Labs. Ihlinzeka ngengqalasizinda ehlanganisekayo yokwamukela okokufaka, ukugcina umlando weseshini, ukulungisa umongo wemodeli, ukuxhumanisa izikhathi zokusebenza ze-LLM, ukuhumusha izingcingo zamathuluzi, kanye nokusabalalisa imisebenzi eqinile engavumelanisi.

Le phrojekthi ihlukanisa ukuxhumanisa okuvumelanayo nokwenziwa kwemisebenzi okungavumelanisi. Abahumushi bamathuluzi baqinisekisa izicelo ezikhiqizwe imodeli futhi bakhiqize izincazelo zemisebenzi ezingase zihlukaniswe, ngaphandle kokwenza i-I/O. Umphathi wemisebenzi ube esenza imisebenzi eqinisekisiwe ngaphandle kwe-event loop yomxhumanisi.

Ukwakheka Kwendawo Yokugcina Ikhodi

Indawo yokugcina ikhodi ihlelwe yaba izindawo ezintathu eziyinhloko:

• harness/: Ilabhulali ye-agent harness engasetshenziswa kabusha.
• cmd/: Ama-executable akhiwe ngale labhulali.
• benchmarks/: Abaqalisi bama-benchmark bokuhlola le phrojekthi.

Qala nge-harness/ lapho uhlanganisa le framework kolunye uhlelo. Hlola i-cmd/ ukuze ubone izindawo zangempela okuqalwa kuzo ama-executable, bese usebenzisa i-benchmarks/ lapho udinga ukuhlola noma ukukala ukuziphatha kwesikhathi sokusebenza.

Imiqondo Eyinhloko

Okokufaka ne-Inbox

Okokufaka umcimbi ophethe isikhombi esihlukile emhlabeni wonke esinikezwa oshayayo. Leso sikhombi kufanele sihlale singashintshiwe uma umcimbi ulethwa futhi.

I-inbox yeseshini isebenzisa lezi zikhombi ukususa ukuphindwa kokokufaka kwangaphandle, kokulawula, nokokuphahlazeka enkumbulweni. Lokhu kungaphindwa ngokuphepha kugxile eseshini futhi kuyashesha ukuphela, ngakho oshayayo kufanele baqhubeke nokunikeza ama-ID azinzile ngokungaguquguquki.

{
  "id": "globally-unique-and-stable-id",
  "type": "external-input",
  "payload": "Example request"
}

Lesi sakhiwo siyisibonelo somqondo, hhayi uhlobo lwe-API ye-Unreal Agent olubhalwe ngokusemthethweni. Okubalulekile imfuneko ye-ID yokokufaka ezinzile nehlukile emhlabeni wonke.

Amaseshini

Iseshini umlando ogcinwayo owengezwa kuwo kuphela. Amaseshini angaqalwa kabusha futhi ahlukaniswe abe amagatsha, okwenza uhlelo luqhubeke nomsebenzi okhona noma lwakhe igatsha emlandweni wangaphambilini ngaphandle kokubhala kabusha ukulandelana kwasekuqaleni.

Isitolo seseshini siphethe umlando oyisisekelo nesimo semisebenzi. Siphinde siqophe ngokuhlanganyela isimo sokuhunyushwa kocingo lwethuluzi kanye nanoma yimiphi imisebenzi ekhiqizwe yilokho kuhumusha.

Izikhathi Zokusebenza ze-LLM

Isikhathi sokusebenza se-LLM ukulandelana okulawulwa umxhumanisi okuzungeze isicelo semodeli esisodwa esinengqondo. Umxhumanisi ugcina okokufaka okwamukelwe, ulungisa isikhathi sokusebenza, uthola abahumushi bamathuluzi, uqopha umsebenzi ovelayo, bese usabalalisa imisebenzi eqinisekisiwe.

Amathuluzi, Abahumushi, Nemisebenzi

Ithuluzi lihlanganisa i-schema nomhumushi. Lapho imodeli ikhiqiza ucingo lwethuluzi, umhumushi uyaluqinisekisa bese eluguqula lube umsebenzi owodwa noma eminingi.

Umhumushi wethuluzi usebenza ngokuvumelanayo ku-event loop yomxhumanisi. Akufanele enze i-I/O noma amise i-loop.

Umphumela wokuhumusha ubizwa ngokuthi isimo socingo lwethuluzi. Uqukethe iphutha lokuqinisekisa noma izinkomba zemisebenzi ethunyelwe. Lesi simo sihlukile esimweni sokwenziwa kwaleyo misebenzi.

Umsebenzi uyincazelo yomsebenzi ongavumelanisi, engahlukaniswa futhi enenguqulo. Abahumushi bachaza umsebenzi; umphathi wemisebenzi uyawenza.

Izingxenye Eziyinhloko

• I-inbox yeseshini: Ihlinzeka ngokuvimbela ukuphindwa kokokufaka okwesikhashana, okugxile eseshini.
• Umxhumanisi: Ugcina okokufaka okwamukelwe, uphatha izikhathi zokusebenza ze-LLM, uthola abahumushi bamathuluzi, futhi usabalalisa imisebenzi eqinisekisiwe.
• Isitolo seseshini: Sigcina umlando oyisisekelo weseshini nesimo semisebenzi, sisekela ukubuyiselwa nokwakhiwa kwamagatsha, futhi siqopha ngokuhlanganyela isimo socingo lwethuluzi nemisebenzi.
• Umakhi womongo: Uhlanganisa okokufaka kwemodeli enkumbulweni futhi ubika okuqukethwe okushiyiwe, okunqanyuliwe, noma okuhlanganisiwe. Awenzi i-I/O futhi awunakho ukuncika ekugcinweni kwedatha.
• I-adapter ye-LLM: Ithumela okokufaka okulungisiwe kumhlinzeki wemodeli futhi ibuyise impendulo eqediwe ejwayelekile. Iphethe ukuqinisekiswa, ukukhansela, namaphutha omhlinzeki.
• Registry yamathuluzi: Iphethe izincazelo nabahumushi bamathuluzi e-Bash, ViewImage, kanye ne-skill-use, ngenkathi iveza iqoqo elikhethwe yihost.
• Umhumushi wethuluzi: Uqinisekisa izingcingo, ukhiqiza izimo nemisebenzi, futhi ufometha izimo eziqoshiwe kanye nomphumela womsebenzi olungiselelwe wemodeli.
• Umphathi wemisebenzi: Uhlinzeka nge-actor runtime yemisebenzi eqinile. Ukuqaliswa kwasendaweni kungashintshwa.

Ukufaka Nokulungisa

I-README ayicacisi umphathi wamaphakheji, umyalo wokufaka oqondene nolimi, noma i-API yomphakathi ezinzile. Ngakho-ke, ukusetha kufanele kuqale nge-checkout yendawo yendawo yokugcina ikhodi ye-Unreal Agent kanye namafayela ayo okwakha, hhayi ngomyalo wephakheji oqageliwe.

1. Clone noma landa indawo yokugcina ikhodi ye-Unreal Agent.
2. Vula impande yendawo yokugcina ikhodi bese uhlola amafayela okwakha nawokuncika ukuze uthole i-toolchain esekelwayo.
3. Yakha noma faka ilabhulali engaphansi kwe-harness/ usebenzisa amathuluzi amisiwe endaweni yokugcina ikhodi.
4. Hlola i-cmd/ ukuze ubone izibonelo zama-executable ezihlanganisa izingxenye ze-harness.
5. Sebenzisa i-benchmarks/ kuphela ngemva kokuba iphrojekthi eyinhloko yakheke ngempumelelo.

cd <unreal-agent-repository>

# Hlola izinkomba zelabhulali, ama-executable, nama-benchmark.
ls harness
ls cmd
ls benchmarks

Uhlelo lwehost luzodinga futhi i-adapter ye-LLM elungiselelwe umhlinzeki olikhethile. Ukuqinisekisa, indlela yokukhansela, nokuphathwa kwamaphutha aqondene nomhlinzeki kufanele kube kuleyo adapter.

Ukusetshenziswa Okuyisisekelo: Ukulandela Isicelo Esisodwa Se-Agent

Ngenxa yokuthi i-README ayishicileli amagama abakhi noma ezindlela eziqondile, indlela ephephe kakhulu yokuqonda ukusetshenziswa ukulandela ukuhamba kwezingxenye okubhaliwe.

1. Dala noma uqhubeke neseshini. Isitoreji seseshini sigcina umlando ogciniwe futhi sisekele ukubuyiselwa.
2. Thumela okokufaka okunomazisi ozinzile. Sebenzisa kabusha umazisi ofanayo lapho uphinda uthumela umcimbi ofanayo ngokomqondo.
3. Susa okuphindaphindiwe ngebhokisi lokungenayo leseshini. Ibhokisi lokungenayo liyenqaba noma lingakunaki okokufaka okuphindiwe ngaphakathi kweseshini esebenzayo, ngokuvumelana nokuziphatha kokusetshenziswa.
4. Gcina okokufaka okwamukelwe. Umxhumanisi ukurekhoda emlandweni weseshini ogunyaziwe, onamathiselwayo kuphela.
5. Yakha umongo wemodeli. Umakhi womongo uhlanganisa okokufaka kwemodeli okusememori futhi ubika noma yikuphi okuqukethwe akushiyile, akusike, noma akuhlanganisile.
6. Qalisa ithuba le-LLM. I-adaptha ye-LLM ithumela okokufaka okulungiselelwe kumhlinzeki bese ibuyisa impendulo eqediwe nejwayelekile.
7. Xazulula izingcingo zamathuluzi. Umxhumanisi ubheka ithuluzi ngalinye elivunyelwe kurejista.
8. Humusha ngokuvumelanayo. Umhumushi okhethiwe uqinisekisa ucingo bese ekhiqiza iphutha lokuqinisekisa noma imisebenzi egcinwa njengedatha.
9. Yenza ukuzibophezela nge-athomu. Isitoreji seseshini sigcina isimo socingo lwethuluzi nemisebenzi ndawonye.
10. Thumela ngokungavumelanayo. Umphathi wemisebenzi wenza imisebenzi ezibophezele kuyo futhi ulandelela isimo sokwenziwa kwayo ngokuhlukile esimweni sokuhumusha.
11. Fometha imiphumela yemodeli. Umhumushi uhlanganisa isimo socingo esirekhodiwe nokukhishwa komsebenzi okulungiselelwe ukuze akhiqize umphumela obhekiswe kumodeli.

Isibonelo Somjikelezo Wocingo Lwethuluzi

Okokufaka okunomazisi ozinzile
  -> ukususa okuphindaphindiwe ebhokisini lokungenayo
  -> umcimbi weseshini ogciniwe
  -> ukwakhiwa komongo
  -> impendulo ye-LLM ejwayelekile
  -> ukubheka kurejista yamathuluzi
  -> ukuqinisekiswa nokuhunyushwa ngokuvumelanayo
  -> ukuzibophezela nge-athomu kwesimo nemisebenzi
  -> ukwenziwa kwemisebenzi ngokungavumelanayo
  -> ukufomethwa komphumela obhekiswe kumodeli

Uma ukuqinisekisa kwehluleka, umhumushi urekhoda iphutha lokuqinisekisa esikhundleni sokukhiqiza imisebenzi. Uma ukuqinisekisa kuphumelela, isimo sibhekisa emisebenzini ethunyelwe, kuyilapho umphathi wemisebenzi elandelela ngokuzimela ukuthi leyo misebenzi isalindile, iyasebenza, iqediwe, noma iphathwe ngenye indlela ngokusetshenziswa kwakhe.

Ukukhetha Amathuluzi

Rejista yamathuluzi iphethe izincazelo nabahumushi be-Bash, ViewImage, kanye nokusetshenziswa kwamakhono. Umsingathi ukhetha ukuthi yimaphi kulawa mathuluzi azowadalula.

Dala obala kuphela amakhono adingekayo ekusetshenzisweni okuthile. I-README ayichazi izinqubomgomo zokugunyazwa noma zokuhlukanisa indawo, ngakho lezi zindaba kufanele ziphathwe yindawo yomsingathi kanye nesendlalelo sokwenziwa kwemisebenzi.

Ukwandisa I-Harness

Izingxenye ze-Unreal Agent zenzelwe ukwakhiwa ndawonye. Okunye ukusetshenziswa kungathatha indawo yezingxenye ezisekelwe ezibonakalayo, uma kugcinwa izibopho nemithetho engaguquki ebhaliwe.

Ukusebenzisa Umhumushi Wethuluzi

Umhumushi wangokwezifiso kufanele alandele lolu chungechunge:

1. Qinisekisa izimpikiswano ezikhiqizwe yimodeli ngokuqhathanisa nohlelo lwethuluzi.
2. Buyisa iphutha lokuqinisekisa lapho isicelo singavumelekile.
3. Uma sivumelekile, dala incazelo eyodwa noma eziningi zemisebenzi egcinwa njengedatha futhi enenguqulo.
4. Buyisa isimo esibhekisa emisebenzini ethunyelwe.
5. Hlinzeka ngomqondo wokufometha oguqula isimo esirekhodiwe nokukhishwa komsebenzi okulungiselelwe kube umphumela obhekiswe kumodeli.

Gcina ukuhumusha kunqunywa ngendlela efanayo futhi kushesha. Ungenzi izicelo zenethiwekhi, ungafinyeleli kumafayela, ungalindi izinqubo ezingaphansi, futhi ungenzi okunye okokufaka nokukhipha ngaphakathi kumhumushi.

Ukushintsha Umphathi Wemisebenzi

Umphathi wemisebenzi wendawo ungashintshwa. Okunye ukunwetshwa okubhaliwe ngumphathi wommeleli owenza imisebenzi ibe uchungechunge futhi ayithumele komunye umphathi wemisebenzi wendawo osebenza ngaphakathi kwenqubo yesandbox ekude.

Lolu hlelo lugcina umxhumanisi nabahumushi begxile ekuqinisekiseni nasekugcineni inhloso, kuyilapho ukwenziwa kwenzeka endaweni ehlukanisiwe.

Ukusebenzisa Isitoreji

Izitolo zeseshini ezihlukile kufanele zigcine amandla okugcina njengedatha, ukwenziwa kwezinguqulo, ukuziphatha kokubuyiselwa, kanye nobudlelwano be-athomu phakathi kwesimo socingo lwethuluzi nemisebenzi ekhiqiziwe.

Iphrojekthi ihlose ukugcina ukuhambisana kwezikhathi ezedlule kwamaseshini. Uma inguqulo yeseshini ingasekelwa, ukuyiqhubekisa kufanele kwehluleke ngephutha elicacile kunokufunda idatha ngokungaqondile.

Amasu Athuthukile

• Khiqiza ama-ID okufakwayo emngceleni womshayi. Gcina i-ID nomcimbi oyidalile ukuze ukuzama futhi nokulethwa kabusha kugcine ubuwena obufanayo.
• Ungaphambanisi ukususwa kokuphindaphindwa kwebhokisi lokungenayo nomlando oqinile. Ibhokisi lokungenayo liyaguquguquka futhi lisebenza ngesikhathi seseshini kuphela, kanti isitolo seseshini sigcina imicimbi esemthethweni.
• Gcina abahumushi bemsulwa futhi bevumelanisiwe. Humusha izicelo zibe yimisebenzi esikhundleni sokwenza umsebenzi ngokuqondile.
• Faka inguqulo kuzo zonke izakhiwo zemisebenzi. Imisebenzi ingaphila isikhathi eside kunenqubo eyidalile noma iweqe imingcele yezinqubo neyama-sandbox.
• Gcina ukuzibophezela kwe-athomu. Ukurekhoda isimo sokuphumelela kocingo lwethuluzi ngaphandle kwemisebenzi yalo kungashiya iseshini ingahambisani ngemva kokuphahlazeka.
• Landela ukuhumusha nokwenza ngokuzimela. Ucingo oluvumelekile lungakhiqiza umsebenzi ozibophezele kuwo kodwa ongakaqedi.
• Sebenzisa imethadatha yomakhi wokuqukethwe. Gada lokho okushiywe ngaphandle, okunqanyuliwe, noma okuhlanganisiwe ukuze kuhlonzwe ukuziphatha kwemodeli.
• Hlanganisa ukukhathazeka komhlinzeki endaweni eyodwa. Gcina iziqinisekiso, ukukhansela, namaphutha omhlinzeki ngaphakathi kwe-adaptha ye-LLM.
• Hlukanisa amaseshini ukuze uzame. Ukuhlukanisa kungahlola ukuqhubeka okuhlukile ngenkathi kugcinwa umlando weseshini yomthombo ongeke wengezwe emuva.
• Sebenzisa umphathi wemisebenzi wommeleli ukuze uhlukanise. Imisebenzi eyenziwe yaba uchungechunge ingadluliselwa ku-runtime engaphakathi kwe-sandbox ekude ngaphandle kokuyisa ukuhumusha okuvumelanisiwe lapho.

Imithetho Ebalulekile Engaguquki

Izandiso kufanele zigcine lezi ziqinisekiso ezilandelayo:

• Izinto zesitolo seseshini zihlala zikwazi ukwenziwa uchungechunge.
• Ifomethi yesitoreji ihlala inenguqulo.
• Izinhlobo zamasession ezingasekelwa zikhiqiza amaphutha acacile okuqalisa kabusha.
• Imisebenzi ihlala ikwazi ukwenziwa uchungechunge futhi inenguqulo.
• Ukwakhiwa kokuqukethwe akwenzi i-I/O futhi akwamukeli ukuncika ekugcinweni kwedatha.
• Ukuhumusha kwamathuluzi akwenzi i-I/O futhi akumisi i-event loop yomxhumanisi.

Isiphetho

I-Unreal Agent inikeza isisekelo esiyimojuli sama-agent adinga amaseshini aqhubekayo, okokufaka okususwe ukuphindaphindwa, izikhathi ze-LLM ezihlanganisiwe, izingcingo zamathuluzi eziqinisekisiwe, nomsebenzi ongavumelanisiwe ogcinwa isikhathi eside. Umgomo wayo omkhulu wokuklama uwumngcele ocacile phakathi kokuhumusha okuvumelanisiwe nokwenza okungavumelanisiwe. Qala ngezinto ezisebenzisekayo ezikhona, landela ukuhamba komcimbi okubhaliwe, futhi ugcine ukwenziwa uchungechunge, ukwenziwa kwenguqulo, kanye nobuqotho be-athomu lapho ushintsha noma unweba izingxenye.