Isifundo se-Agent Office 3D: Guqula i-AI Coding Agent ibe yisisebenzi sehhovisi esingu-3D

Yini i-Agent Office 3D?

I-Agent Office 3D yihhovisi le-3D elisebenza kukhompyutha yakho, elakhiwe nge-low-poly, elibonisa ama-AI Coding Agent njengabasebenzi ehhovisini. Ungabona ngokushesha ukuthi i-Agent ngayinye iyasebenza, ayisebenzi, isiqedile futhi ilindile, noma ibambeke esazisweni semvume esidinga ukuqinisekiswa.

Iphrojekthi isebenzisa idatha yokubonisa ngokuzenzakalela, ngakho akudingeki uxhume noma iyiphi i-Agent kuqala. Abasebenzi abangasebenzi bazokwenza ikhofi, baphuze amanzi, basebenzise i-treadmill, bazelule, balale isikhashana noma badlale imidlalo emincane eyakhelwe ngaphakathi; ngemva kokunika i-Minecraft amandla, abasebenzi bangangena nasemhlabeni wendawo besebenzisa amarobhothi e-Mineflayer.

Abasebenzi, imisebenzi, amaphrojekthi namanani aboniswa esikrinini kuyidatha yokubonisa kuphela, akuwona ulwazi lwebhizinisi lwangempela.

Izici eziyinhloko

• Isimo sabasebenzi esibukhoma: I-Agent ngayinye inesihlalo sayo, ilambu lesimo kanye ne-nameplate; uma kudingeka ukuqinisekiswa, kuzovela i-nameplate ebomvu enophawu lokumemeza.
• Isikrini setheminali sokufunda kuphela: Chofoza isisebenzi ukuze ubuke okukhiphayo kwakamuva kwetheminali, kodwa awukwazi ukuthumela imiyalo kusuka kusixhumi esibonakalayo sehhovisi.
• Ibhodi lezaziso: Libonisa imigomo yonyaka, ama-KPI, izinto ezibalulekile zaleli sonto, ukuhamba kwemali kanye nohlu lwezinto okufanele zenziwe; izinto zingamakwa ngokuqondile.
• Isizindalwazi samaphrojekthi eshalofini lezincwadi: Incwadi ngayinye ihambisana nefolda yephrojekthi, lapho ungafunda khona amadokhumenti e-Markdown nezithombe-skrini.
• Uhlu lwemisebenzi: Buka amafayela nokuqukethwe okugcwele kwamafolda emisebenzi ngakwesokudla.
• Umsebenzi wokuphumula we-Minecraft: Abasebenzi abangasebenzi bangasebenzisa amarobhothi abo e-Mineflayer ukumba, ukugawula izihlahla nokwakha izindlu, kuyilapho umbono womuntu wokuqala uboniswa esikrinini sedeski labo.

Uma uchofoza ibhodi lezaziso, kuzovuleka isixhumi esibonakalayo sesikrini esigcwele ukuze ubuke ulwazi lwenkampani nezinto okufanele zenziwe.

Ishalofu lezincwadi linikeza indlela yokuphequlula amaphrojekthi yokufunda kuphela, elungele ukubuka ngokushesha amadokhumenti nezinto zephrojekthi.

Izidingo zohlelo

• Node.js 20 noma ngaphezulu: Kuyimfuneko yokusebenzisa ihhovisi.
• Java 21 noma ngaphezulu: Kudingeka kuphela uma usebenzisa isici se-Minecraft.
• Isiphequluli esisekela i-WebGL: I-Chrome, Edge, Safari ne-Firefox zonke ziyasebenza.

i-macOS ne-Linux yizinkundla ezisekelwa kakhulu. I-Windows okwamanje isekelwa ngokuhlolwa; nakuba i-CI izosebenzisa ukufakwa, ukuhlolwa kwe-syntax kanye nokuhlolwa kwemodi yokubonisa, umbhali akakakuqinisekisi endaweni yangempela ye-Windows, futhi i-Minecraft ayikahlolwa ku-Windows.

Ukufaka nokuqalisa ihhovisi lokubonisa

macOS ne-Linux

git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d
cd agent-office-3d
npm ci
npm start

Windows PowerShell

git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d
cd agent-office-3d
npm ci
npm start

Ngemva kokuqala, uhlelo luzovula http://127.0.0.1:4870/. Ngokuzenzakalela lusebenzisa imodi ye-demo, futhi izimo zabasebenzi zizoshintshana ngokuzenzakalelayo, ngakho akudingeki ulungiselele noma uxhume ama-Agent kuqala. Ngemva kokuzama, cindezela Ctrl+C kutheminali ukuze ume.

Ukufaka usebenzisa i-AI Coding Agent

Uma usebenzisa i-Claude Code, i-Codex, i-Cursor noma enye i-AI Coding Agent, ungayivula kuqala kufolda yephrojekthi bese unamathisela lo myalo:

Funda i-AGENTS.md yale repo, ungifakele i-Agent Office bese uvula i-demo ye-Minecraft.

I-Agent izosebenzisa AGENTS.md ukuze iqhube npm run doctor, isize ngokufaka nokuqala i-demo, bese ikubuza ukuthi uyafuna yini ukuxhuma i-Herdr nokuthi ufuna ukwenza kanjani inkampani nabasebenzi kube ngokwakho. Ngaphambi kokufaka isofthiwe yesistimu efana ne-Node.js noma i-Java, izokubuza; i-Minecraft EULA yona kufanele uyifunde wena uqobo bese ufaka yes, i-AI Agent ngeke ikuvumele esikhundleni sakho. Abasebenzisi be-Claude Code bangafaka futhi /setup-office.

Ukumisa inkampani, abasebenzi nemithombo yedatha

Qala ngokukopisha ifayela lokumisa lesibonelo:

cp office.config.example.json office.config.json

Kwi-Windows PowerShell ungasebenzisa:

Copy-Item office.config.example.json office.config.json

office.config.json ngeke ifakwe ekulawulweni kwezinguqulo. Uma ifayela lingekho, uhlelo luzosebenzisa ukumisa kwesibonelo ngokuqondile. Izinkambu ezisetshenziswa kakhulu yilezi:

• port: Imbobo yokuxhuma isevisi, ezenzakalelayo ngu-4870.
• openBrowser: Ukuthi isiphequluli sivulwe ngokuzenzakalelayo yini ngemva kokuqala.
• company.name: Igama elisetshenziswa kubha yesihloko nasophawini lwenkampani.
• company.currency: Uphawu lwemali oluboniswa ebhodini lezaziso, njengo-$ noma NT$.
• company.logo ne-company.mark: Izindlela ze-logo ebanzi yenkampani nesithonjana esincane.
• owner.name, owner.title: Igama nesikhundla somuntu osebenzisa ideski lomphathi; ideski lomphathi lingelokuhlobisa kuphela futhi ngeke lamukele isimo sama-Agent.
• cat.name: Igama lekati lehhovisi.
• staff[]: Uhlu lwabasebenzi, oluhlanganisa id, title kanye nombala womfaniswano othi color, lufike kubasebenzi abangu-8.
• source.type: Umthombo wesimo, ongaba demo noma herdr.
• data.board, data.projects, data.tasks: Izindawo zedatha yebhodi lezaziso, amaphrojekthi nemisebenzi.

staff[].id yesisebenzi kufanele ifane negama le-Agent emthonjeni wesimo. Ukuze ubone amafomethi edatha ahlobene nebhodi lezaziso neshalofu lezincwadi, bheka docs/board-format.md.

Ukuxhuma i-Agent yangempela: imodi ye-Herdr

I-Herdr iyithuluzi le-terminal multiplexer elisetshenziswa ama-Coding Agent. Ukuze uxhume i-Herdr, qala i-Agent yakho nge-Herdr bese ushintsha ukumisa:

{
  "source": {
    "type": "herdr"
  },
  "staff": [
    {
      "id": "Igama le-Herdr Agent yakho",
      "title": "Isikhundla",
      "color": "#4f8cff"
    }
  ]
}

Bese uqhuba:

npm start

Ihhovisi lizobiza kuphela imiyalo ye-Herdr yokufunda kuphela ethi herdr agent list kanye ne-herdr agent read. Uhlu olwakhelwe ngaphakathi lwemiyalo evunyelwe luzovimba eminye imiyalo, ngakho ihhovisi ngeke likuthumele okhiye noma liqinisekise izimvume esikhundleni sakho.

Uma ufuna ukuxhuma elinye ithuluzi lesimo, engeza i-adapter ku-lib/sources.js ukuze ibuyise ifomethi efanayo yohlu lwabasebenzi, ehlanganisa igama, isimo nemigqa yokugcina yokukhiphayo kwetheminali.

Ukuvula i-demo ye-Minecraft

Uma ufuna ukubuka ngokushesha abasebenzi be-demo bedlala i-Minecraft, ungaqhuba:

npm run demo:minecraft

Lesi sici sidinga i-Node.js 20 noma ngaphezulu kanye ne-Java 21 noma ngaphezulu. Ekuqaliseni kokuqala kuzohlolwa i-Java, ucelwe ukuba ufunde futhi wamukele i-Minecraft EULA, kulandwe ifayela leseva lenguqulo 1.21.4 ohlwini lwezinguqulo olusemthethweni lwe-Mojang, bese kuqinisekiswa i-SHA-1. Ukwakhiwa komhlaba kuvame ukuthatha cishe umzuzu ongu-1 kuya kwemi-2.

Kufanele ufake yes wena uqobo ukuze kubhalwe eula=true. Okunye okuqukethwe kuzokhansela inqubo, futhi awekho amafayela e-Mojang azokulandwa. Lokhu kungenxa yokuthi i-EULA yesofthiwe yeseva ye-Minecraft kufanele yamukelwe umuntu oyisebenzisayo uqobo.

Ukuvula i-Minecraft kwimodi evamile yehhovisi, qala uqhube:

npm run minecraft:setup

Ngemva kokuqeda, shintsha minecraft.enabled efayeleni lokumisa ibe true, bese uqhuba npm start. Iseva ye-Minecraft izobophezela ku-127.0.0.1 futhi isebenzise uhlu oluvunyelwe ukukhawulela ukuxhumana. Lapho umsebenzi womsebenzi ubuyela, irobhothi elihambisana naye lizomisa umsebenzi; irobhothi lizosebenza kuphela lapho umsebenzi engasebenzi futhi othile evule isikrini sehhovisi.

Ukubuka abasebenzi ngaphakathi komdlalo we-Minecraft

Uma unenguqulo ye-Minecraft Java, ungangeza igama lakho lomdlali ku-minecraft.guests:

{
  "minecraft": {
    "guests": ["YourName"]
  }
}

Ungasebenzisa futhi okuguquguqukayo kwemvelo:

MC_GUESTS=YourName npm run demo:minecraft

Kwi-Windows PowerShell ungasebenzisa:

$env:MC_GUESTS="YourName"; npm run demo:minecraft

1. Vula i-Minecraft Java 1.21.4 kukhompyutha efanayo.
2. Ngena kumdlalo wabadlali abaningi, khetha ukuxhumana okuqondile, bese ufaka localhost:25570.
3. Ngemva kokungena, uzoshintshela ngokuzenzakalelayo kwimodi yokubuka; ungandiza futhi udlule ezindongeni ngaphandle kokushintsha umhlaba.
4. Cindezela inkinobho yenombolo 1 noma usebenzise inkinobho ephakathi yegundane ukuvula imenyu yokubuka, bese ukhetha umsebenzi ofuna ukuwubuka.

Amagama abadlali akusethingi azofakwa ohlwini oluvunyelwe kanye namarobhothi, futhi abanye abadlali ngeke bakwazi ukuxhuma. Iseva isebenzisa imodi engaxhunyiwe ku-inthanethi futhi ilalela kuphela kukhompyutha yendawo; ungashintshi ikheli elibophayo noma uyivulele ngaphandle.

Imiyalo yokuthuthukisa nokuxilonga

Iphrojekthi inikeza imiyalo eminingana efanele ukuhlola indawo nokuqinisekisa izinguquko:

npm run doctor  # Ukuhlola indawo yokufunda kuphela
npm run check   # Ukuhlola i-JavaScript syntax nefomethi ye-JSON
npm run smoke   # Ukuhlolwa kwe-smoke kwemodi ye-demo

npm run doctor ibuyisa ikhodi yokuphuma engu-0 lapho zonke izinto sezilungile; ibuyisa u-2 lapho i-Minecraft ingakalungi; futhi ibuyisa u-1 lapho ihhovisi lingakwazi ukusebenza. Faka -- --json ukuze ukhiphe imiphumela ngefomethi ye-JSON.

Ngesikhathi sokuthuthukisa ungasebenzisa namapharamitha e-URL, isibonelo ?fast ukusheshisa izenzo, ?idle=coffee ukwenza abasebenzi abangasebenzi benze isenzo esithile, kanye ne-?cat=nap ukulungisa uhlelo lwekati. Amagama ezenzo atholakalayo kufanele abhekwe ku-public/behavior.js.

Izinyathelo Zokuphepha

• Ihhovisi lifunda okukhiphayo kwetheminali ye-Agent, okungase kuqukathe ikhodi, izindlela zamafayela noma ulwazi olubucayi.
• Iseva ibophelelwe kuphela ku-127.0.0.1 futhi ihlola unhlokweni we-Host; ungayivezi isevisi nge-reverse proxy, umhubhe noma inethiwekhi yomphakathi.
• Okuwukuphela komsebenzi wokubhala oseHhovisi ukumaka imisebenzi okufanele yenziwe ebhodini lezaziso; ezinye izimo ze-Agent nedatha yetheminali zifundeka kuphela.
• Ishelufu lezincwadi lifunda kuphela ifolda emisiwe, futhi livimbela ukudlula kwemizila kanye nezixhumanisi ezingokomfanekiso eziphuma ngaphandle kwefolda; nokho akukhuthazwa ukufaka amaphasiwedi noma ama-token kufolda yephrojekthi.
• Iseva ye-Minecraft ilalela kuphela emshinini wendawo futhi inohlu lwabadlali abagunyaziwe olusebenzayo; ungayishintshi ibe uxhumano oluvulekele ngaphandle.

Isiphetho

Agent Office 3D iguqula izimo zama-Agent ebezisakazeke kumatheminali zibe yihhovisi le-3D eliqondakala kalula. Ungaqala ngokusebenzisa npm start ukuze uzame imodi yedemo, bese usebenzisa office.config.json ukwenza inkampani nabasebenzi ngendlela oyifunayo, ekugcineni uxhume ku-Herdr ukuze ubuke izimo zangempela zama-Agent. Uma ufuna ukwengeza ukusebenzisana, sebenzisa npm run demo:minecraft ukuze ubuke abasebenzi abangasebenzi benza imisebenzi emhlabeni we-Minecraft wendawo.

Khumbula ukuthi le phrojekthi inikezwa ngaphansi kwe-MIT License futhi ayihlobene ne-Mojang noma i-Microsoft; uma usebenzisa i-Minecraft, kusadingeka uzifundele futhi wamukele i-EULA yayo.