Yakha futhi Usebenzise Amawebhusayithi Ahlelwayo Akhiqizwe yi-AI nge-EmDash Build

Yini i-EmDash Build?

I-EmDash Build ingumakhi wamasayithi we-AI onomthombo ovulekile oguqula incazelo ebhaliwe ibe iwebhusayithi ye-EmDash ehlelekayo. Esikhundleni sokukhiqiza kuphela ukumakwa kwekhasi okumile, idala imodeli yokuqukethwe ehlelekile, igcwalise leyo modeli ngeseva ye-EmDash's Model Context Protocol, bese ibhala amakhasi nezingxenye ze-Astro ezinezinhlobo ezichaziwe ukuze kuboniswe okuqukethwe.

Iphrojekthi ewumphumela ihlanganisa amakhasi anikezwa yiseva, okuqukethwe okuhlelekile, ukugcinwa kwemidiya, kanye nesixhumi esibonakalayo sokuphatha se-EmDash. Abahleli bangaqhubeka nokusebenzisa isayithi ngemva kokukhiqizwa kokuqala: bangabuyekeza umbhalo nemidiya, bengeze noma baphinde izingxenye, bahlele kabusha amabhulokhi okuqukethwe, bahlele isikhathi sokushicilelwa kokuthunyelwe, futhi bacele i-agent ukuthi yenze izinguquko ezinkulu kokuqukethwe noma ekwakhiweni.

Okubalulekile: I-EmDash Build iwuhlelo lwereferensi olusesigabeni se-alpha oluhloselwe abahlinzeki bokusingatha, abakhi bamawebhusayithi, namapulatifomu. Ukushicilela kukhutshaziwe kudemo esingathwa.

Ungahlola idemo esingathwa, nakuba ungeke ukwazi ukushicilela amasayithi kuyo.

Amakhono Abalulekile

• Ukucaciswa okuhlelekile: I-agent ibuza imibuzo egxile endabeni lapho incazelo ishiya isinqumo esibalulekile singaxazululiwe.
• Amamodeli okuqukethwe aklanywe yi-agent: Idala amaqoqo ezinto ezingasetshenziswa kabusha namabhulokhi ahlelekile ezigaba zamakhasi abahleli abangawahlela kabusha.
• Amasayithi e-Astro ahlelekayo: Ingaphambili lisebenzisa izingxenye ze-Astro ezinezinhlobo ezichaziwe, kuyilapho okuqukethwe okuvamile kuqhubeka nokuphathwa nge-EmDash.
• Ukuhlola bukhoma nokulungisa: Iphrojekthi inikezwa ku-Builder preview yangasese. I-agent ingaqinisekisa umphumela, ihlole ukwehluleka, futhi ikulungise emjikelezweni ofanayo.
• Ukugeleza komsebenzi wokuqukethwe: Abahleli bangaphatha umbhalo, imidiya, izigaba, amabhulokhi, nokuqukethwe okuhlelelwe isikhathi ngesixhumi esibonakalayo sokuphatha se-EmDash.
• Umlando ohlala isikhathi eside: Ikhodi yomthombo nesimo sendawo se-CMS kugcinwa njengama-commit e-Git ku-Cloudflare Artifacts.
• Ukushicilela okulawulwayo: Ukukhishwa okumile okuqinisekisiwe kungapakishwa ukuze kusetshenziswe ku-Workers for Platforms, kodwa kuphela lapho opharetha ekunika amandla futhi ekulungisa ngokusobala ukushicilela.

Indlela Esebenza Ngayo I-Architecture

Iphrojekthi ngayinye ekhiqiziwe ithola i-Cloudflare Sandbox equkethe iphrojekthi elungiselelwe ye-EmDash, Astro, ne-Tailwind. I-BuilderAgent Durable Object ilawula ingxoxo nomjikelezo wemodeli namathuluzi.

I-agent isebenzisa amathuluzi e-EmDash MCP ukuze idale ama-schema nokuqukethwe. Ibhala ingaphambili lomphakathi ngaphakathi kwe-Sandbox, iqale ukubuka kuqala okuyimfihlo, iqinisekise isayithi elinikeziwe, futhi ilungise amaphutha ngaphambi kokuqeda ithuba.

Cloudflare Artifacts igcina isimo ngasinye esihambisanayo sephrojekthi njengomlando we-Git. Uma i-Sandbox ilala, i-EmDash Build ingabuyisela kokubili ikhodi yomthombo nesimo sendawo se-CMS esitsheni esisha, bese iqala kabusha ukubuka kuqala.

Ukugeleza Komsebenzi Kwe-Agent

1. Qonda: Funda incazelo bese ukhomba izinqumo ezibalulekile zempahla ezishodayo.
2. Yenza imodeli: Nquma ukuthi iyiphi idatha okufanele ibe amaqoqo angasetshenziswa kabusha nokuthi yimaphi amakhasi adinga amabhulokhi ahlelekile.
3. Yakha: Dala i-schema ye-EmDash, uvuselele izinhlobo ezikhiqiziwe, bese ubhala abahlinzeki be-Astro abanezinhlobo ezichaziwe.
4. Gcwalisa: Faka okuqukethwe nemidiya emelela okuqukethwe usebenzisa amathuluzi e-EmDash MCP.
5. Qinisekisa: Hlola izinhlobo zephrojekthi, unikeze imizila yomphakathi, uhlole ukubuka kuqala, bese ulungisa ukwehluleka.
6. Londoloza: Yenza i-commit yesimo esiphelele sephrojekthi ku-Cloudflare Artifacts.

Izidingo Zokuqala

Ukuthuthukiswa kwendawo kuncike kokubili kumathuluzi endawo nasekufinyeleleni ezinsizeni eziningana ze-Cloudflare. Ngaphambi kokuqhubeka, lungisa okulandelayo:

• Node.js 24 noma kamuva
• pnpm 11.9
• I-daemon esebenzayo ehambisana ne-Docker
• i-Wrangler eqinisekiswe ku-akhawunti ye-Cloudflare
• Ukufinyelela ku-Cloudflare Workers
• Ukufinyelela kuma-Durable Objects
• Ukufinyelela ku-Cloudflare Sandbox
• Ukufinyelela ku-Workers AI ne-AI Gateway
• Ukufinyelela ku-Cloudflare Artifacts
• Ukufinyelela ku-Workers for Platforms

Ngenxa yokuthi izinsiza zomhlinzeki nemingcele yokwethembana kudinga ukulungiswa ngokucophelela, funda umhlahlandlela wokuzisingatha wekhosombe ngaphambi kokuphaka uhlelo.

Faka Futhi Lungisa I-EmDash Build

1. Faka Okuncikile

Kusuka empandeni yekhosombe, faka izinhlobo ezikhiyiwe zokuncika:

pnpm install --frozen-lockfile

2. Dala Ukucushwa Komhlinzeki

Kopisha provider.config.example.json uye kufayela elingalandelwa yi-Git elithi provider.config.json:

cp provider.config.example.json provider.config.json

Vula provider.config.json bese ushintsha lonke inani lesibonelo ufake izinsiza ze-akhawunti yakho ye-Cloudflare. Dala izinsiza ezidingekayo ngokulandela umhlahlandlela wokuzisingatha, kunokuthembela kumanani ezibonelo.

3. Qinisekisa Futhi Nikeza Ukucushwa

Qalisa ukuhlola kwangaphambi kokuqalisa, bese ukhiqiza ukucushwa kwe-Wrangler okuqondene nomhlinzeki:

pnpm preflight
pnpm configure

Ukucushwa okukhiqiziwe okusetshenziswa umyalo wokuqalisa wendawo obhalwe kumadokhumenti yi-wrangler.provider.jsonc. Hlola leli fayela eliqondene nomhlinzeki ngaphambi kokuphaka noma ukusebenzisa izindawo ezibucayi.

4. Lungisa Izimfihlo Zasendaweni

Kopisha ithempulethi yezimfihlo zentuthuko:

cp .dev.vars.example .dev.vars

Faka ku-.dev.vars imininingwane ye-AI Gateway edingwa umakhi. I-UNSPLASH_ACCESS_KEY iyazikhethela; ukuyengeza kunika amandla ukusesha izithombe zesitoko ngesikhathi sokukhiqiza.

Ungafaki imininingwane yomhlinzeki ngaphakathi kwamaphrojekthi akhiqiziwe. Ukushicilela kulawulwa yiseva, futhi amasayithi akhiqiziwe awanikezwa imininingwane yomhlinzeki.

5. Qalisa Uhlelo Olugcwele Lwendawo

Qalisa i-EmDash Build ngokusebenzisa ukucushwa komhlinzeki okwenziwe:

EMDASH_WRANGLER_CONFIG=wrangler.provider.jsonc pnpm dev

Uma iseva yokuthuthukisa isilungile, vula http://localhost:5173.

6. Qalisa Imodi Ye-UI Kuphela Lapho Kufanele

Uma udinga ukusebenza kusixhumi esibonakalayo kuphela, sebenzisa:

pnpm dev:ui

Le modi ayiqali ukwakhiwa kwamasayithi okusekelwe ku-Sandbox. Sebenzisa umyalo ophelele wokuthuthukisa lapho udinga ukuhlola i-agent yokwakha, ukudalwa kwephrojekthi, noma ukubuka kuqala okukhiqizwayo bukhoma.

Ukusetshenziswa Okuyisisekelo: Khiqiza Isayithi Ngencazelo

1. Bhala Incazelo Ewusizo

Chaza iwebhusayithi ehlosiwe, izethameli zayo, amakhasi abalulekile, okuqukethwe okungasetshenziswa kabusha, kanye nendlela ebonakalayo oyifunayo. Isibonelo:

Create a portfolio website for an Icelandic landscape photographer.
Include a home page, reusable photo collections, an about page,
and structured page sections that editors can reorder.

I-agent ingabuza imibuzo ecacisayo egxile endabeni uma incazelo ishiya izinqumo ezibalulekile zingaxazululiwe. Phendula le mibuzo ngaphambi kokulindela i-schema ne-frontend ehambisanayo.

2. Vumela I-agent Imodele Futhi Yakhe Isayithi

Ngemva kokucacisa, i-agent inquma ukuthi yiluphi ulwazi olungena emaqoqweni angasetshenziswa kabusha nokuthi yimaphi amakhasi alandisayo okufanele asebenzise amabhulokhi ahlelekile. Bese idala i-schema ye-EmDash, ivuselele izinhlobo ezikhiqiziwe, ibhale ama-renderer e-Astro, futhi yengeze okuqukethwe okumele kusetshenziswe ngamathuluzi e-MCP.

3. Buyekeza Ukubuka Kuqala Kwangasese

Sebenzisa ukubuka kuqala bukhoma kwe-Builder ukuze uhlole imizila ekhiqiziwe kanye nomklamo uwonke. I-EmDash Build iqinisekisa iphrojekthi ekhiqiziwe futhi ingalungisa ukwehluleka okutholiwe phakathi komjikelezo we-agent.

4. Qhubeka Nokuhlela Ku-EmDash

Uma iphrojekthi yokuqala isisebenziseka, phatha okuqukethwe okujwayelekile ngesixhumi esibonakalayo sokuphatha se-EmDash. Ungahlela umbhalo nemidiya, ungeze noma uphindaphinde izigaba, uhlele kabusha amabhulokhi, futhi uhlele isikhathi sokushicilelwa kokuthunyelwe. Buyela ku-agent lapho udinga izinguquko ezibanzi zesakhiwo, zokuqukethwe, noma zomklamo.

5. Londoloza Futhi Buyisela Isimo Sephrojekthi

Izimo zephrojekthi ezihambisanayo zigcinwa ku-Cloudflare Artifacts njengomlando we-Git. Lokhu kugcinwa kwenza i-EmDash Build ikwazi ukubuyisela umthombo wephrojekthi kanye nesimo se-CMS sendawo lapho i-Sandbox ilele futhi kudingeka ikhonteyina entsha.

Imiyalo Yokuqinisekisa Neyokuthuthukisa

Sebenzisa imiyalo yenqolobane efanele uhlobo loshintsho olwenzayo:

• pnpm dev iqala i-EmDash Build ngokucushwa okuzenzakalelayo.
• pnpm dev:ui iqala isixhumi esibonakalayo ngaphandle kwamakhonteyina e-Cloudflare Sandbox.
• pnpm check ihlola izinhlobo zohlelo kanye nezivivinyo ze-Worker.
• pnpm test isebenzisa iqoqo lezivivinyo zohlelo.
• pnpm test:worker isebenzisa iqoqo lokuhlanganisa lama-Workers.
• pnpm build yakha i-EmDash Build ngokucushwa okuzenzakalelayo.
• pnpm build:provider yakha kusetshenziswa wrangler.provider.jsonc.
• pnpm format ifometha inqolobane nge-oxfmt.

Ngaphambi kokuthumela umnikelo, sebenzisa ukulandelana okuphelele kokuqinisekisa okunconywe yiphrojekthi:

pnpm format
pnpm check
pnpm test
pnpm test:worker
pnpm build

Amathiphu Athuthukile

Khetha Imodi Efanele Yokuthuthukisa

Sebenzisa pnpm dev:ui emsebenzini ohlukanisiwe wesixhumi esibonakalayo ngoba ugwema ukuqala amakhonteyina e-Sandbox. Ungayisebenzisi ukuqinisekisa ukuhamba komsebenzi wokukhiqiza: ukukhiqiza okusekelwe ku-Sandbox akutholakali kwimodi ye-UI kuphela.

Hlukanisa Ukuhlela Okuqukethwe Kwezinguquko Zesakhiwo

Sebenzisa isixhumi esibonakalayo sokuphatha se-EmDash emsebenzini ojwayelekile wokuhlela, njengokushintsha umbhalo, imidiya, izigaba, nokulandelana. Sebenzisa i-agent ezinguqukweni ezinkulu zomklamo noma zemodeli yokuqukethwe. Lokhu kugcina ukuhlukaniswa kwephrojekthi phakathi kwedatha ehlelekile ye-CMS nekhodi yokunikezela ye-Astro enezinhlobo.

Hlola Ukucushwa Komhlinzeki

Thatha ukucushwa komhlinzeki okuyisibonelo njengethempulethi kuphela. Faka esikhundleni sawo wonke amanani esibonelo, sebenzisa pnpm preflight, khiqiza ukucushwa kwe-Wrangler nge-pnpm configure, bese uhlola okukhiphayo kwe-akhawunti ye-Cloudflare ehlosiwe.

Gcina Ukushicilela Kulawulwa Ngokucacile

Ukushicilela esidlangalaleni kuphethwe yiseva futhi kukhutshazwe ngokuzenzakalelayo. Kwenze kusebenze futhi ukulungise kuphela lapho umhlinzeki osebenzayo eselungele ukupakisha ukukhishwa okumile okuqinisekisiwe kwe-Workers for Platforms. Idemo esingathwa nayo igcina ukushicilela kukhutshaziwe.

Buyekeza Imingcele Yokuphepha Ngaphambi Kokuphakela

Bheka imodeli yezinsongo yenqolobane ukuze uthole imininingwane ngamathuluzi emodeli, ukusetshenziswa kwe-Sandbox, izimfihlo, ukubuka kuqala kwangasese, ukugcinwa, kanye nokushicilela. Sebenzisa umhlahlandlela wokusebenza ekuhloleni kokusebenza.

Zulazula Enqolobaneni Ngempumelelo

• src/worker iqukethe imizila ye-Worker, i-BuilderAgent, imiyalelo, amathuluzi, ukugcinwa, nezilawuli zokushicilela.
• src/client iqukethe isixhumi esibonakalayo se-React Builder, ingxoxo, ukubukwa komsebenzi, nokubuka kuqala bukhoma.
• prototype/builder-cloudflare iqukethe i-EmDash engenalutho elungiselelwe kanye ne-scaffold ye-Astro esetshenziselwa amaphrojekthi amasha.
• migrations iqukethe ama-migration esizindalwazi okuqinisekisa nobulawuli bomhlinzeki.
• scripts iqukethe ukucushwa komhlinzeki, izivivinyo ze-smoke, nabasizi bokusebenza.
• test iqukethe ukumbozwa kohlelo nokwe-Worker.
• docs iqukethe imibhalo yokuzibambela, ukuphepha, ukusebenza, nokusetshenziswa.

Isiphetho

I-EmDash Build ihlanganisa ukukhiqizwa okusizwa yi-AI nokugeleza komsebenzi okuqinile, okuhlelekayo kwe-CMS. Idala okuqukethwe kwe-EmDash okuhlelekile nezingxenye ze-Astro ezinezinhlobo, iqinisekise umphumela ekubukeni kuqala okuyimfihlo kwe-Cloudflare Sandbox, futhi igcine umlando wephrojekthi ku-Cloudflare Artifacts. Njengoba iwuhlelo oluyisibonelo lwesigaba se-alpha olunezidingo ezinkulu zengqalasizinda, lungiselela izinsiza zomhlinzeki ngokucophelela, buyekeza imibhalo yezokuphepha, futhi ugcine ukushicilela esidlangalaleni kulawulwa ngokusobala.