Yakha futhi Uziqhubele Wena Abasebenzi Abambisene be-AI nge-useAgent

Isexwayiso sokuqala: useAgent isathuthukiswa ngenkuthalo. Ama-API nama-schema angashintsha phakathi kwezinguqulo, ngakho-ke khetha i-release tag lapho ukuzinza kubalulekile.

Yini i-useAgent?

useAgent iyinkundla esebenza njengozakwethu we-AI yomthombo ovulekile, yokusebenzisa ama-agent afana noClaude Code, uCodex, ne-OpenCode. Esikhundleni sokubuyisa izimpendulo zengxoxo kuphela, ama-agent asebenza ezindaweni ze-Linux ezihlukanisiwe futhi angaletha amawebhusayithi aqediwe, izethulo, amaspredishithi, imibiko yocwaningo, nama-pull request ahloliwe.

Intambo ngayinye ithola indawo yokusebenza enetheminali, ama-repository, isiphequluli, nedeskithophu ebonakalayo nge-noVNC. Ukusebenza kumelwe njengemigqa yesikhathi esekelwe emicimbini ku-Postgres, okwenza ihlale ikhona, idlalwe kabusha, futhi ihlolwe ngemva kokuqedwa.

Izici ezibalulekile

• Isixhumi esibonakalayo esisodwa sama-agent amaningi: Izinjini ezithile zabahlinzeki zixhumana ngenkontileka yemicimbi ejwayelekile.
• Ukusebenza okuqinile: Ukusebenza kuyaqhubeka ngisho noma ama-backend eqala kabusha, kanti ukubuyiselwa kungaphinda kuhlolisise amasesshini asebenzayo futhi kwamukele umsebenzi oqediwe.
• Ama-sandbox e-Linux ahlukanisiwe: Intambo ngayinye ithola indawo yokusebenza ehlukile. I-Daytona ne-CubeSandbox zisebenzisa inkontileka yesandbox efanayo.
• Isango lamathuluzi elithembekile: Imininingwane yokufinyelela ihlala ku-control plane esikhundleni sokungena ku-agent sandbox.
• Ukuvunywa umuntu: Izingcingo zamathuluzi ezilimazayo ziyama ukuze zivunywe kusixhumi esibonakalayo sewebhu noma ku-Slack ngaphambi kokuqhubeka ngekhono eliboshwe empikiswaneni, elisetshenziswa kanye kuphela.
• Amakhono asekelwe ku-GitHub: Amaqembu angangenisa amafayela e-SKILL.md anezinguqulo, avumelanise izinguquko, futhi ahlele amakhono afanele abe ama-agent turn.
• Umongo wenhlangano: Ukutholwa kolwazi kuhlanganisa izingcaphuno, kanti inkumbulo yeqembu isebenzisa indlela yokufunda ebuyekezwa umuntu.
• Artifacts zomdabu: Inkundla isekela amafayela e-DOCX, XLSX, PPTX, ne-PDF anezinguqulo, kanye nama-renderer omdabu.
• Iziteshi eziningi zokungena: Umsebenzi ungafika ngohlelo lwewebhu, ku-Slack, nge-REST API, noma ngamashejuli.

Indlela isakhiwo esisebenza ngayo

useAgent ihlukanisa i-control plane yayo ezisingathwa nguwe endaweni lapho i-agent isebenzela khona. Iziteshi zokungena zakha ukusebenza ngendlela efanayo. Ama-adapter enjini ahumusha umsebenzi oqondene nomhlinzeki ube yimicimbi ejwayelekile, kuyilapho intambo ngayinye inikezwa i-sandbox ehlukanisiwe.

Izici ezintathu zesakhiwo zibaluleke kakhulu:

1. Izinjini ziyashintshana: Ukushintsha injini akudingi ukushintsha indlela evamile yokumela imicu, ama-artifact, noma inkumbulo.
2. IPostgres ingumthombo weqiniso: Konke ukusebenza kugcinwa njengelogi yemicimbi, okuvumela ukudlalwa kabusha nokuhlolwa okunembile ngemva kokuqala kabusha.
3. Izimfihlo zihlala ngaphandle kwama-sandbox: Ukuhlanganiswa kuvezwa njengamathuluzi anohlobo ngesango elithembekile, kanti imininingwane yokufinyelela igcinwa kuphela ku-control plane.

Ukuhlelwa kwe-repository

• frontend/ iqukethe isixhumi esibonakalayo somkhiqizo samaseshini, amakhono, ama-playbook, i-wiki, ama-artifact, ama-automation, nezilungiselelo.
• backend/ iqukethe ukuqinisekiswa, ukuhlelwa kokusebenza, ama-adapter enjini, ama-sandbox, ulwazi, inkumbulo, ama-artifact, nezixhumi.
• packages/ iqukethe izinkontileka zemicimbi ezabiwe, ama-workpiece, amafomethi ama-artifact, ama-renderer, namaphakheji ahlobene.
• docs-site/ iqukethe iwebhusayithi yamadokhumenti.
• infra/self-host/ iqukethe amathuluzi okuphaka angancikile kumhlinzeki kanye nereferensi ye-Hetzner Terraform.
• memory/ iqukethe isevisi yokuzikhethela yenkumbulo yeqembu.

Okudingekayo ngaphambi kokuqala

Ukufakwa kwendawo yokuthuthukisa kudinga i-Bun ne-Postgres 16 noma entsha ene-pgvector extension. Ama-container ajwayelekile e-Postgres awanayo i-pgvector, ngakho-ke sebenzisa isithombe esifanele esine-pgvector.

Kufanele futhi ube ne-Docker etholakalayo uma uhlela ukuqala umyalo we-container yesizindalwazi onikeziwe. Sebenzisa lezi zinyathelo ezilandelayo usuka empandeni ye-repository ye-useAgent.

Isinyathelo 1: Qala i-Postgres ene-pgvector

Uma ungenayo isizindalwazi esihambisanayo, qala esisodwa ku-Docker:

docker run -d --name useagent-pg -p 5432:5432 \
  -e POSTGRES_HOST_AUTH_METHOD=trust pgvector/pgvector:pg16
export DATABASE_URL=postgres://postgres@localhost:5432/postgres

Umyalo wokuqala uveza i-Postgres ethekwini 5432. Owesibili usetha iyunithi yokuxhuma esetshenziswa uhlelo. Ukucushwa kwe-trust kulula ekuthuthukiseni kwasendaweni; izindawo zokukhiqiza kufanele zisebenzise imininingwane yesizindalwazi evikelwe ngokufanele.

Isinyathelo 2: Faka okuncikile kwendawo yokusebenza

Okuncikile kufakwa ngokuzimela kuma-workspace amaphakheji abiwe, e-backend, nawe-frontend:

for workspace in \
  packages/agent-harness packages/artifact-workspace \
  packages/agent-client packages/artifact-formats packages/conformance \
  backend frontend; do
  (cd "$workspace" && bun install)
done

Isinyathelo 3: Qala i-backend ne-frontend

Vula amasesshini etheminali ahlukene bese uqala izinqubo ezimbili zokuthuthukisa:

bun run dev:backend

bun run dev:frontend

I-backend inikeza i-API nesevisi yokuhlela ukusebenza ethekwini 3201. I-frontend isebenza ethekwini 3400 futhi idlulisela izicelo ezingaphansi kwe-/api/* ku-backend.

Vula http://localhost:3400 esipheqululini ukuze ufinyelele kusixhumi esibonakalayo. Ukucushwa komhlinzeki kanye ne-sandbox kungahluka, ngakho landela imibhalo ye-useAgent yamanje lapho uxhuma injini ye-agent noma ulungiselela indawo yayo yokusebenza.

Isinyathelo 4: Qinisekisa i-codebase

Qalisa isihloli sezinhlobo kuyo yonke i-repository ngemva kokufaka noma ngaphambi kokuthumela ushintsho:

bun run typecheck

Lo myalo uhlanganisa wonke amaphakheji aku-repository futhi usize ukuthola izinguquko ezingahambisani phakathi kwezinkontileka ezabiwe, i-backend, ne-frontend.

Ukusetshenziswa okuyisisekelo

Dala ukuqaliswa kwe-agent

1. Vula isixhumi esibonakalayo sewebhu ku-port 3400.
2. Sebenzisa umqambi we-agent ukuchaza umphumela ophelele owudingayo.
3. Qala ukuqaliswa bese ulandela umugqa wesikhathi wemicimbi ebukhoma.
4. Hlola umsebenzi wetheminali, wesiphequluli, wedeskithophu, noma we-workspace njengoba i-agent iqhubeka.
5. Buyekeza noma yiliphi ikhadi lokugunyaza ngaphambi kokuvumela umsebenzi wethuluzi obhubhisayo.
6. Qoqa i-artifact eqediwe noma umsebenzi we-repository obuyiswe yiseshini.

Umsebenzi ungahlelwa uzungeze okuthile okulethwayo, isibonelo:

Yenza ucwaningo ngesihloko, caphuna imithombo efanele, bese ubuyisa umphumela njengombiko ohlelekile.

Emsebenzini wesoftware, chaza ukuqaliswa nokuqinisekiswa okulindelekile:

Qalisa ushintsho oluceliwe ku-repository, sebenzisa izivivinyo ezifanele, bese ulungiselela umsebenzi ophelile ukuze ubuyekezwe.

Lezi yizibonelo zemisebenzi ngolimi lwemvelo, hhayi i-syntax ekhethekile yemiyalo. Amathuluzi atholakalayo ekuqalisweni ancike enjini, ku-sandbox, emithonjeni yolwazi, kumakhono, nasekuhlanganisweni okumisiwe.

Sebenza nge-Slack

Uma ukuhlanganiswa komdabu kwe-Slack kumisiwe, abasebenzisi bangasho i-agent ukuze baqale umsebenzi. Izimpendulo, okunamathiselwe, ama-artifact, nezicelo zokugunyaza kuhlala kuchungechungeni lwe-Slack. Lokhu kunikeza indlela efanayo yokuqalisa neyesixhumi esibonakalayo sewebhu, kuyilapho ukusebenzisana kugcinwa esiteshini lapho kuqale khona.

Sebenzisa ulwazi namakhono enhlangano

Ulwazi, okuqukethwe kwe-wiki, nenkumbulo yeqembu kunganikeza umongo oqondene nenhlangano onezicaphuno. Imiyalelo esebenza kabusha ingangeniswa futhi isuka ku-GitHub njengamakhono ane-version e-SKILL.md. I-useAgent ingavumelanisa kabusha la makhono ngokuzenzakalela futhi iklelise afanele ekujikeni ngakunye.

Ukusingatha i-useAgent ngokwakho

I-useAgent ingasebenza kunoma yimuphi umsingathi we-Linux, okuhlanganisa i-AWS, Google Cloud, Azure, Hetzner, noma i-bare metal. I-repository ihlanganisa imibhalo yokuphaka engancikile kumhlinzeki kanye nomsunguli wereferensi we-Hetzner osebenzisa i-Terraform, osebenza ngomyalo owodwa.

Ngemva kokulungiselela umsingathi we-Linux namanani adingekayo, sebenzisa umbhalo wokuphaka ovela ku-repository:

SERVER_IP=<host-ip> PG_PASSWORD=... OPENROUTER_API_KEY=... \
  infra/self-host/deploy-app.sh /path/to/this/repo

Inqubo yokulungiselela ixhumana nomshini okuqondiswe kuwo nge-SSH. Bheka infra/self-host/README.md ukuze uthole umhlahlandlela ophelele wokukhiqiza nemininingwane edingekayo yemvelo, kunokuba ubheke lesi sibonelo esifushane njengokucushwa okuphelele kokuphepha.

Khetha i-sandbox runtime

• Daytona: Isevisi ye-sandbox ephethwe engabhangqwa nomsunguli we-control plane kunoma yiliphi ifu. I-README iyichaza njengenketho elula yokuqala.
• CubeSandbox: I-runtime ezisingathwa ngokwakho yezinhlangano ezifuna ama-sandbox ku-hardware yazo futhi ezidinga ukuthi yonke idatha ihlale endaweni yazo.

Ama-runtime womabili asebenza ngemuva kwenkontileka efanayo ye-sandbox, okwenza i-control plane ihlele umsebenzi we-agent ngaphandle kokwenza imodeli yayo eyinhloko incike kumhlinzeki oyedwa we-sandbox.

Amathiphu okusebenza athuthukile

• Namathisela i-release tag: Ngenxa yokuthi iphrojekthi isesigabeni se-alpha, ukunamathisela i-tag eyaziwayo kunciphisa ukuphazamiseka okungalindelekile okubangelwa ama-API noma ama-schema ashintshayo.
• Gcina i-Postgres: Ilogi yemicimbi iwumthombo weqiniso wokuqaliswa. Yenza ikhophi eyisipele futhi usebenzise i-database ngendlela efanele.
• Gcina iziqinisekiso ku-gateway: Ungaphambuki ekwakhiweni ngokukopisha izimfihlo zokuhlanganiswa zesikhathi eside kuma-sandbox.
• Sebenzisa izimvume ngokuqaphela: Gcina izilawuli zokubandakanya umuntu zisebenza ezenzweni ezibhubhisayo, ikakhulukazi lapho ukuqaliswa kuqala nge-Slack noma ngamashejuli.
• Khetha ama-sandbox ngokuvumelana nokusebenza: I-Daytona inikeza indlela ephethwe, kuyilapho i-CubeSandbox isekela ukuqaliswa okusingathwa ngokwakho nokugcinwa kwedatha endaweni.
• Qalisa ukuhlolwa kwezinhlobo ngokungaguquki: Izinkontileka ezabiwe zisabalala kuma-workspace amaningi, ngakho sebenzisa bun run typecheck ngemva kwezinguquko eziwela amaphakheji.
• Buyekeza imizila yokukhiqiza: Isiqondiso esiphelele sokuphaka sitholakala ngaphansi kwe-infra/self-host/, kanti umzila wokukhishwa kweziqukathi ezingaguquki, owengezayo, ubhalwe ku-docs/operations/immutable-releases.md.
• Hlola ukugeleza kwesicelo: I-repository ihlanganisa umdwebo osebenzisanayo ku-docs/architecture/request-flow.html wokutadisha ngokujulile ukwakhiwa kwesistimu.

Ukuhlanganiswa nezindawo zokulethwa

Ngaphezu kokusekelwa komdabu kwe-Slack ne-GitHub, inkundla ibala i-Gmail, i-Linear, i-Notion, ne-HubSpot ngama-connector. I-OAuth iphathwa yi-broker, futhi ama-token avalwa ohlangothini lweseva. Izindawo ze-workspace zihlanganisa isizindalwazi solwazi, inkumbulo yeqembu, amakhono, ama-playbook, nama-automation ahleliwe.

Ukuhlanganiswa kwe-GitHub kusekela ukuqinisekiswa kwe-App, ukwenziwa kwe-clone ye-repository, nemisebenzi ye-pull request. Kungakhathaliseki ukuhlanganiswa, izingcingo zamathuluzi zidlula ku-gateway ethembekile kunokuba ziveze iziqinisekiso ngokuqondile ku-workstation ye-agent.

Okucatshangelwayo ngamalayisense

useAgent isatshalaliswa ngaphansi kwelayisensi ye-GNU AGPL v3.0-only. Ingase isetshenziswe, iguqulwe, futhi izisingathwe ngokwakho ngaphansi kwaleyo migomo. Ilayisensi yezohwebo iyatholakala ukuze ishumekwe emikhiqizweni yobunikazi, emikhiqizweni ye-OEM noma ye-white-label, ekusabalalisweni ngaphandle kwezibopho ze-AGPL, noma kwezinye izidingo zamalayisensi.

Isiphetho

useAgent ihlanganisa izinjini zama-agent eziningi, ukuqalisa okuhlala isikhathi eside okusekelwe ku-Postgres, ama-sandbox e-Linux ahlukanisiwe, umongo wenhlangano, ukuhlanganiswa okuvikelekile, ukugunyazwa, kanye nama-artifact ahlelekayo endaweni eyodwa engazisingathwa. Qala endaweni yangakini nge-Bun ne-pgvector, qinisekisa i-monorepo ngesihloli sayo sezinhlobo, bese usebenzisa indlela yokuzisingatha ebhalwe emibhalweni lapho uthuthela ku-host yokukhiqiza ye-Linux.