Mafunzo ya Agent Office 3D: Mgeuze AI Coding Agent kuwa mfanyakazi wa ofisi ya 3D

Agent Office 3D ni nini?

Agent Office 3D ni ofisi ya 3D yenye poligoni chache inayoendeshwa kwenye kompyuta yako, na kuwaonyesha AI Coding Agent kama wafanyakazi ndani ya ofisi. Unaweza kuona mara moja kila Agent akifanya kazi, akiwa bila shughuli, akiwa amekamilisha kazi na akisubiri, au akiwa amekwama kwenye ombi la ruhusa linalohitaji uthibitisho.

Mradi hutumia data ya onyesho kwa chaguo-msingi, kwa hiyo huhitaji kuunganisha Agent yoyote mapema. Wafanyakazi wasio na shughuli watatengeneza kahawa, kunywa maji, kutumia mashine ya kukimbia, kujinyoosha, kusinzia au kucheza michezo iliyojengwa ndani; Minecraft ikiwashwa, wafanyakazi wanaweza pia kuingia katika ulimwengu wa ndani kupitia roboti za Mineflayer.

Wafanyakazi, kazi, miradi na kiasi cha fedha kinachoonyeshwa ni data ya onyesho, si taarifa halisi za biashara.

Vipengele vikuu

• Hali ya wafanyakazi kwa wakati halisi: Kila Agent ana kiti, taa ya hali na beji ya jina lake; uthibitisho unapohitajika, beji nyekundu yenye alama ya mshangao itaonekana.
• Kituo cha kuonyesha tu: Bofya mfanyakazi ili kuona matokeo ya hivi karibuni ya kituo, lakini huwezi kutuma amri kupitia kiolesura cha ofisi.
• Ubao wa matangazo: Huonyesha malengo ya mwaka, KPI, vipaumbele vya wiki hii, mtiririko wa fedha na orodha ya kazi; kazi zinaweza kutiwa alama moja kwa moja.
• Hifadhidata ya miradi kwenye rafu za vitabu: Kila kitabu kinalingana na folda ya mradi, ambapo unaweza kusoma nyaraka za Markdown na picha za skrini.
• Orodha ya kazi: Tazama faili na maudhui kamili kutoka kwenye folda ya kazi upande wa kulia.
• Shughuli ya mapumziko ya Minecraft: Wafanyakazi wasio na shughuli wanaweza kutumia roboti zao za Mineflayer kuchimba madini, kukata miti na kujenga nyumba; mwonekano wa mtu wa kwanza huonyeshwa kwenye skrini za madawati yao.

Ukibofya ubao wa matangazo, kiolesura cha skrini nzima hufunguka ili kutazama taarifa za kampuni na kazi zinazosubiri.

Rafu za vitabu hutoa njia ya kuvinjari miradi kwa kusoma tu, inayofaa kwa kuangalia haraka nyaraka na nyenzo za miradi.

Mahitaji ya mazingira

• Node.js 20 au zaidi: Sharti la kuendesha ofisi.
• Java 21 au zaidi: Inahitajika tu unapowasha kipengele cha Minecraft.
• Kivinjari kinachotumia WebGL: Chrome, Edge, Safari na Firefox zote zinaweza kutumika.

macOS na Linux ndizo mifumo inayoungwa mkono zaidi. Windows kwa sasa inaungwa mkono kwa majaribio; ingawa CI huendesha usakinishaji, ukaguzi wa sintaksia na majaribio ya hali ya onyesho, mwandishi hajathibitisha programu katika mazingira halisi ya Windows, na Minecraft bado haijajaribiwa kwenye Windows.

Kusakinisha na kuanzisha ofisi ya onyesho

macOS na 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

Baada ya kuanzisha, programu itafungua http://127.0.0.1:4870/. Kwa chaguo-msingi hutumia hali ya demo, na hali za wafanyakazi hubadilika kiotomatiki, kwa hiyo huhitaji kuandaa au kuunganisha Agent mapema. Baada ya kumaliza kujaribu, bonyeza Ctrl+C kwenye kituo ili kusimamisha programu.

Usakinishaji kwa kutumia AI Coding Agent

Ukitumia AI Coding Agent kama Claude Code, Codex au Cursor, unaweza pia kuifungua kwanza katika folda ya mradi, kisha ubandike amri ifuatayo:

Soma AGENTS.md ya repo hii, nisaidie kusakinisha Agent Office na kufungua onyesho la Minecraft.

Agent itafuata AGENTS.md kuendesha npm run doctor, kusaidia kusakinisha na kuanzisha onyesho, na kuuliza ikiwa ungependa kuunganisha Herdr na jinsi ya kubinafsisha kampuni na wafanyakazi. Kabla ya kusakinisha programu ya mfumo kama Node.js au Java, itakuuliza; EULA ya Minecraft lazima isomwe na kukubaliwa na wewe mwenyewe kwa kuingiza yes, na AI Agent haitakubali kwa niaba yako. Watumiaji wa Claude Code wanaweza pia kuingiza /setup-office.

Kuweka kampuni, wafanyakazi na chanzo cha data

Kwanza nakili faili la mfano la mipangilio:

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

Windows PowerShell inaweza kutumia:

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

office.config.json halitawekwa kwenye udhibiti wa matoleo. Ikiwa faili hilo halipo, programu itatumia mipangilio ya mfano moja kwa moja. Sehemu zinazotumiwa mara nyingi ni hizi:

• port: Mlango wa huduma, chaguo-msingi ni 4870.
• openBrowser: Ikiwa kivinjari kifunguke kiotomatiki baada ya kuanzisha.
• company.name: Jina linalotumika kwenye upau wa kichwa na bango la kampuni.
• company.currency: Alama ya sarafu inayoonyeshwa kwenye ubao wa matangazo, kwa mfano $ au NT$.
• company.logo na company.mark: Njia za Logo pana ya kampuni na ikoni ndogo.
• owner.name, owner.title: Jina na cheo cha mtu kwenye dawati la msimamizi; dawati la msimamizi ni mapambo tu na halipokei hali za Agent.
• cat.name: Jina la paka wa ofisini.
• staff[]: Orodha ya wafanyakazi iliyo na id, title na color ya sare, hadi watu 8.
• source.type: Chanzo cha hali, ambacho kinaweza kuwa demo au herdr.
• data.board, data.projects, data.tasks: Maeneo ya data ya ubao wa matangazo, miradi na kazi.

staff[].id ya mfanyakazi lazima ilingane na jina la Agent katika chanzo cha hali. Kwa miundo ya data ya ubao wa matangazo na rafu za vitabu, tazama docs/board-format.md.

Kuunganisha Agent halisi: Hali ya Herdr

Herdr ni zana ya kuzidisha vituo inayotumiwa na Coding Agent. Ili kuunganisha Herdr, kwanza anzisha Agent yako kwa Herdr, kisha badilisha mipangilio:

{
  "source": {
    "type": "herdr"
  },
  "staff": [
    {
      "id": "Jina la Herdr Agent yako",
      "title": "Cheo",
      "color": "#4f8cff"
    }
  ]
}

Kisha endesha:

npm start

Ofisi itaita tu amri za Herdr za kusoma pekee, herdr agent list na herdr agent read. Orodha ya ndani ya amri zinazoruhusiwa itazuia amri nyingine, kwa hiyo ofisi haitakutumia vitufe wala kuthibitisha ruhusa kwa niaba yako.

Ukitaka kuunganisha zana nyingine ya hali, unaweza kuongeza adapter katika lib/sources.js ili irudishe muundo huo huo wa orodha ya wafanyakazi, ukiwa na majina, hali na mistari ya mwisho ya matokeo ya kituo.

Kuwasha onyesho la Minecraft

Ukitaka tu kutazama wafanyakazi wa onyesho wakicheza Minecraft, unaweza kuendesha:

npm run demo:minecraft

Kipengele hiki kinahitaji Node.js 20 au zaidi na Java 21 au zaidi. Mara ya kwanza kinapoendeshwa, kitakagua Java, kukuomba usome na ukubali Minecraft EULA, kipakue faili la seva la toleo 1.21.4 kutoka kwenye orodha rasmi ya matoleo ya Mojang na kuthibitisha SHA-1. Kwa kawaida ulimwengu huchukua takriban dakika 1 hadi 2 kuundwa.

Lazima uingize yes mwenyewe ili eula=true iandikwe. Kuingiza kitu kingine kutaghairi mchakato, na hakuna faili la Mojang litakalopakuliwa. Hii ni kwa sababu EULA ya programu ya seva ya Minecraft lazima ikubaliwe na mtu anayeiendesha mwenyewe.

Ili kuwezesha Minecraft katika hali ya kawaida ya ofisi, kwanza endesha:

npm run minecraft:setup

Baada ya kumaliza, badilisha minecraft.enabled katika faili la mipangilio kuwa true, kisha endesha npm start. Seva ya Minecraft itafungwa kwenye 127.0.0.1 na kutumia orodha ya kuruhusiwa kudhibiti miunganisho. Mfanyakazi anaporejea kazini, roboti husika itaacha shughuli; roboti hufanya kazi tu mfanyakazi akiwa bila shughuli na mtu akiwa amefungua ofisi.

Kuangalia wafanyakazi ndani ya mchezo wa Minecraft

Ikiwa una Minecraft Java Edition, unaweza kuongeza jina lako la mchezaji kwenye minecraft.guests:

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

Unaweza pia kutumia kigezo cha mazingira:

MC_GUESTS=YourName npm run demo:minecraft

Windows PowerShell inaweza kutumia:

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

1. Fungua Minecraft Java Edition 1.21.4 kwenye kompyuta hiyo hiyo.
2. Ingia kwenye mchezo wa wachezaji wengi, chagua kuunganisha moja kwa moja, kisha uingize localhost:25570.
3. Baada ya kuingia, utabadilishwa kiotomatiki kuwa hali ya mtazamaji, ambapo unaweza kuruka na kupita kwenye kuta bila kubadilisha ulimwengu.
4. Bonyeza kitufe cha nambari 1 au tumia kitufe cha katikati cha kipanya kufungua menyu ya mtazamaji, kisha uchague mfanyakazi wa kumtazama.

Majina ya wachezaji yaliyo katika mipangilio yataongezwa kwenye orodha ya kuruhusiwa pamoja na roboti; wachezaji wengine hawawezi kuingia. Seva hutumia hali ya nje ya mtandao na inasikiliza kwenye kompyuta ya ndani pekee; usibadilishe anwani ya kufunga wala kuifungua kwa mitandao ya nje.

Amri za uundaji na uchunguzi

Mradi hutoa amri kadhaa zinazofaa kwa kukagua mazingira na kuthibitisha marekebisho:

npm run doctor  # Ukaguzi wa mazingira wa kusoma pekee
npm run check   # Ukaguzi wa sintaksia ya JavaScript na muundo wa JSON
npm run smoke   # Jaribio la haraka la hali ya onyesho

npm run doctor hurudisha msimbo wa kutoka 0 vipengele vyote vinapokuwa tayari; hurudisha 2 Minecraft ikiwa bado haijawa tayari; na hurudisha 1 ikiwa ofisi haiwezi kuendeshwa. Ongeza -- --json ili kutoa matokeo katika muundo wa JSON.

Wakati wa kutengeneza, unaweza pia kutumia vigezo vya URL, kwa mfano ?fast ili kuharakisha vitendo, ?idle=coffee ili kuwafanya wafanyakazi wasiotenda wafanye kitendo maalum, na ?cat=nap ili kurekebisha ratiba ya paka. Majina ya vitendo vinavyopatikana yanapaswa kurejelewa katika public/behavior.js.

Tahadhari za Usalama

• Ofisi husoma matokeo ya terminal ya Agent, ambayo yanaweza kuwa na msimbo, njia za faili au taarifa nyeti.
• Seva hufungamana na 127.0.0.1 pekee na hukagua kichwa cha Host; usifichue huduma kupitia seva mbadala, tunnel au mtandao wa umma.
• Kipengele pekee cha kuandika cha ofisi ni kuweka alama kwenye vipengee vya kufanya vya ubao wa matangazo; hali nyingine za Agent na data za terminal ni za kusomwa pekee.
• Rafu ya vitabu husoma tu folda iliyosanidiwa na huzuia mashambulizi ya kuvuka njia pamoja na viungo vya mfano vinavyotoka nje ya saraka; hata hivyo, haipendekezwi kuweka nywila au tokeni katika folda ya mradi.
• Seva ya Minecraft husikiliza kwenye mashine ya ndani pekee na huwezesha orodha ya walioidhinishwa; tafadhali usiibadilishe iweze kuunganishwa kutoka nje.

Hitimisho

Agent Office 3D hubadilisha hali za Agent ambazo awali zilitawanyika kwenye terminal kuwa ofisi ya 3D iliyo rahisi kueleweka. Unaweza kuanza kwa kutumia npm start kujaribu hali ya onyesho, kisha ubinafsishe kampuni na wafanyakazi kupitia office.config.json, na hatimaye uunganishe Herdr ili kuona hali halisi za Agent. Ikiwa ungependa kuongeza mwingiliano, tumia npm run demo:minecraft kutazama wafanyakazi wasiotenda wakifanya shughuli katika ulimwengu wa Minecraft wa ndani.

Tafadhali kumbuka kuwa mradi huu umepewa leseni ya MIT na hauhusiani na Mojang au Microsoft; unapotumia Minecraft, bado unapaswa kusoma na kukubali EULA yake mwenyewe.