Webhely készítése és közzététele a Paperclip Agents segítségével17 min read

A gemkapocs koordinálja az AI webhely csapatát; nem a webhely nyilvános tárhelye. Használja a tájékoztató felosztására, elszámoltatható munka kiosztására, minőségbiztosítási bizonyítékok gyűjtésére és útvonal-jóváhagyásra. Ezután helyezze üzembe az ellenőrzött kódot egy tárhelyszolgáltatón keresztül, vagy tegyen közzé egy megfelelő alkalmazásterméket a AgentGrid.io-en keresztül. A Kész állapotba kerülő feladat nem nyilvános telepítés.

Vegyük fontolóra egy háromoldalas termékbemutató webhelyet kezdőlappal, szolgáltatásoldallal és kapcsolatfelvételi útvonallal. A tervező, a kódoló, a minőségbiztosítási ügynök és a marketingellenőr csak akkor dolgozhat párhuzamosan, ha megosztják egymással az elfogadási feltételeket, és tudják, hogy melyik verziót vizsgálják felül. Ez az útmutató bemutatja, hogyan strukturálhatja ezt az átadást anélkül, hogy az ügynökrendezést varázslatos egykattintásos webhelykészítőként kezelné.

Webhely közzététele a Paperclip és a AgentGrid.io segítségével

A gemkapocs képes az ügynöki munkát megbízásokként szervezni, a kimeneteket pedig műtermékként követni. A AgentGrid.io lehet az a külön hely, ahol a létrejövő weboldalt vagy dokumentumot megtekintik, és jóváhagyás esetén közzéteszik. Ne csukja össze ezeket a szerepköröket: a iratkapocs-feladat vagy annak műtermékrekordja nem automatikusan AgentGrid melléktermék, és ezeket a termékeket nem szabad úgy leírni, mint amelyek natív kapcsolattal rendelkeznek ellenőrzött integráció nélkül.

1. Először hozza létre a cél munkaterületet

A AgentGrid-ben hozzon létre vagy válasszon ki egy munkaterületet a kimenetet áttekintő csapat számára. Mielőtt bárkit meghívna, ellenőrizze a csapattagságot. Megtarthatja a Paperclip ügynökét a meglévő végrehajtási útvonalon, és hagyhatja, hogy egy személy átadja a szállítmányt. A AgentGrid ügynöki meghívása egy opcionális útvonal egy kompatibilis, szándékosan konfigurált asszisztens számára, nem pedig annak bizonyítéka, hogy a Paperclip ügynöklistája vagy jóváhagyási lánca megjelenik a AgentGrid-ben. Ha meghív egy ügynököt, használja a AgentGrid meghívási utasításait, és törölje a szükségtelen megosztási és közzétételi lehetőségek jelölését, mielőtt elküldi az egyszeri hivatkozást.

A Paperclipben adjon meg egy szigorú elfogadási tájékoztatót a feladatnak: a céloldal koncepciója, a szükséges szakaszok, a tényszerű állítások forráshivatkozásai és egy megnevezett emberi felülvizsgáló. A feladat belső állapotát tartsa külön a közzétételi engedélytől. A befejezettként megjelölt feladat azt jelenti, hogy a kért munkát ellenőrzésre átadták, nem azt, hogy a nyilvánosságra hozatal engedélyezett.

2. A tényleges kimenet átvitele

Amikor az ügynök végzett, ellenőrizze az általa készített fájlokat vagy írott műtermékeket. Egy kis webhely esetén csomagolja a megfelelő fájlokat ZIP-fájlba, és használja a AgentGrid ZIP-importálását. Szöveges jelentéshez importálja a támogatott dokumentumot, vagy hozzon létre egy új dokumentumot. Nevezze el, hogy a lektorok összekapcsolhassák a gemkapocs feladattal, és mellékeljen egy rövid megjegyzést arról, hogy mi van készen, mi az ideiglenes, és hol találhatók a forrásanyagok. Ellenőrizze a AgentGrid előnézetet, ahelyett, hogy feltételezné, hogy a fájlok pontosan úgy jelennek meg, mint az ügynök környezetében.

3. Különítse el a feladat áttekintését a kiadás áttekintésétől

Használja a iratkapcsot a feladat és állapotának nyomon követéséhez. Kérje meg az érdekelt felet, hogy vizsgálja meg magát a AgentGrid műterméket, és írjon megjegyzéseket a tartalomra, a linkekre, a hozzáférhetőségre és a külső állításokra. A AgentGrid támogatja a műtermékhez fűzött megjegyzéseket, így a végrehajtható visszajelzés utalhat a közzétett dologra. Szerelje be a változatokat, és ellenőrizze az új előnézetet. Ha a feladat hatóköre megváltozik, frissítse a iratkapocs-hozzárendelést is, de ne kezelje a jóváhagyást egyik eszközben sem a másik eszközzel való varázslatos szinkronizálásként.

4. Tegye közzé az ellenőrzött verziót

Csak miután egy emberi tulajdonos engedélyezte a nyilvános kiadást, használja a AgentGrid közzétételi folyamatát. Nyissa meg az eredményül kapott oldalt látogatóként, és hasonlítsa össze a jóváhagyott műtermékkel. A AgentGrid megkülönbözteti a szerkeszthető munkaterület-műterméket a nyilvános telepítéstől; a későbbi módosítások újabb közzétételi műveletet igényelnek. Rögzítse vissza a nyilvános URL-t a Paperclip feladatban átadási megjegyzésként, ha a folyamat ezt igényli, anélkül, hogy igényt tartana az automatikus integrációra vagy a rejtett jóváhagyási hídra.

Adjon meg a csapatnak egy webhelycélt, ne egy homályos utasítást

Kezdje egy szűk összefoglalóval: közönség, konverziós cél, szükséges oldalak, vizuális referenciák, tartalomtulajdonos, elérhetőségi elvárások és a domain vagy a tárhely célhelye. Az első kiadáshoz adja meg az adaptív elrendezéseket, a metaadatokat, a működő kapcsolatfelvételi útvonalat, és azt, ami nem tartozik a hatókörbe.

A Paperclipben hozzon létre egy projektet és egy célt, majd bontsa fel a munkát saját feladatokra. Feladatmodellje egyetlen felelős tulajdonost támogat, blokkolva a kapcsolatokat, a szálakat és a felülvizsgálati szakaszokat. Rendeljen ki egy stratégát vagy PM-ügynököt a tervezéshez, egy tervezőt a vizuális irányítás elkészítéséhez, egy kódoló ügynököt a megvalósításhoz, egy minőségbiztosítási ügynököt a teszteléshez és egy embert az indítás jóváhagyásához. Ezek az Ön által konfigurált szerepkörök, nem előre csomagolt webhelykészítők. Saját gémkapocs webhely-csapat példa megjeleníti a szolgáltatás oldalait, a megvalósítás által blokkolt minőségbiztosítást, valamint a felülvizsgálaton áthaladó előzetes telepítést.

Tervezési felszólítás: „Tervezzen meg egy háromoldalas webhelyet a [közönség] számára, amely segíti a látogatókat [cél]. Készítsen webhelytérképet, oldalszintű elfogadási feltételeket, tartalmi hiányosságokat, képkövetelményeket és egy feladatfüggőségi térképet. Ne helyezzen üzembe semmit. Rendeljen hozzá minden szállítmányhoz egy tulajdonost, és határozza meg azokat a döntéseket, amelyeket egy embernek kell meghoznia.”

Az ügynökök hozzárendelése előtt határozza meg a kiadási szerződést

Állítsa be a közönséget, az elsődleges konverziót, a jóváhagyott példányt, az oldalkészletet, a vizuális eszközöket, a szükséges töréspontokat, a célállomást és az indítás tulajdonosát. Tartalmazzon kifejezett, nem célokat, például a fizetés hiányát vagy a fiók létrehozását az első verzióban. Adjon minden oldalnak mérhető elfogadási feltételt: a jellemző oldal elmagyarázza az ajánlatot, a kapcsolattartó link egy működő célhoz ér, és minden útvonalnak értelmes címe van.

Tartsa együtt a forrást, a tervet és a bizonyítékokat

Adjon meg az építtetőnek egy adattárat vagy megosztott projekthelyet. A tervező megadja az elrendezési specifikációt és az eszközöket; a kódoló ugyanazzal a rövidítéssel szemben valósítja meg. A feladat megjegyzésének hivatkoznia kell az ágra, a lekérésre, az előnézetre és a teszteredményekre. A gemkapocs gyűjthet feladathoz kapcsolódó kimeneteket és áttekintheti a bizonyítékokat, de a feladatmelléklet nem automatikusan az élő webhely vagy a kanonikus forrástár.

A hozzáférés megadása előtt állítson be határokat. Ha egy ügynök kódot tud átküldeni egy GitHub identitáson keresztül a héjában, a Paperclip eszközönkénti Kérdezzen először vezérlői nem szabályozzák ezeket a shell Git-parancsokat. Korlátozza a tárhoz való hozzáférést, és kérjen leágazásvédelmet és PR-ellenőrzést a GitHub-en. Telepítési összekötő esetén különböztesse meg az összeállítási naplók olvasását az éles telepítés megkezdésétől; A Paperclip Netlify útmutatása az Ask first (Kérdezzen először) vagy Off (Ki) lehetőséget ajánlja a telepítéshez és a konfigurációs módosításokhoz. Tartsa távol a hitelesítő adatokat a webhely forrásától, és minden ügynöknek csak a feladatához szükséges hozzáférést adja meg.

Build prompt: „Valósítsa meg a jóváhagyott webhelytérképet a [repository]-ban. Őrizze meg a megállapodás szerinti kialakítást, tegye működőképessé a navigációt és az űrlapokat, és adjon hozzá cím és leírás metaadatokat minden oldalhoz. Dolgozzon egy ágon, futtassa a projekt ellenőrzéseit, csatolja a PR és előnézeti URL-t a Paperclip feladathoz, és állítsa le az éles üzembe helyezés előtt.”

Külön problémaállapot, forrásvezérlés és közzététel

A gémkapocs rögzíti, hogy kié az egyes kiadások, és milyen bizonyítékok kísérik az átadást. A tárhely továbbra is tartalmazza a megvalósítást, és egy tárhelyszolgáltató futtatja a telepített webhelyet. Kapcsolja össze az egyes kiadásokat a pontos ághoz, PR-hez, előnézethez, tesztnaplóhoz és képernyőképekhez. Ha a feladat csak a „legutóbbi” elemre vonatkozik, az ellenőrök véletlenül jóváhagyhatnak egy olyan előnézetet, amely nem egyezik a végül telepített ággal.

Legyen az áttekintés egy kapu, ne egy üzenet, amely azt mondja, hogy „késznek tűnik”

Kérje meg a QA-t, hogy nyissa meg a tényleges előnézetet asztali számítógépen és mobileszközön. Ellenőrizze az első képernyőn megjelenő ígéretet, a billentyűzet navigációját, az alternatív szöveget, a hibás hivatkozásokat, az űrlap viselkedését, a betöltést, a konzolhibákat és az oldal metaadatait. A marketing ellenőrzi a termékre vonatkozó állításokat és a CTA-t. Jegyezze fel reprodukálható bizonyítékokat. Ha egy űrlapnak háttérprogramra van szüksége, tesztelje a benyújtást a végek között.

A iratkapocs végrehajtási szabályzata átirányíthatja a problémát egy felülvizsgálóhoz, majd egy jóváhagyóhoz, amikor végrehajtója megpróbálja készként megjelölni a feladatot. A kért változtatások visszakerülnek az eredeti végrehajtóhoz. Használjon emberi jóváhagyási szakaszt a nyilvános kiadáshoz, és adja meg, hogy a feladat jóváhagyása nem jelent engedélyt a közzétételre mindaddig, amíg az ellenőr meg nem vizsgálta a végső előnézetet és a céltartományt.

QA felszólítás: „Tesztelje az előnézetet az elfogadási feltételekhez képest szűk mobil nézetablakon és asztalon. Adja vissza a sikeres, sikertelen, bizonyíték URL-t vagy képernyőképet, valamint a reprodukálási lépések táblázatát. Ne hagyja jóvá vagy telepítse; küldje vissza a hibákat a megvalósítás tulajdonosának.”

Gyakorlati átvételi ellenőrző lista az indításhoz

• Termék: Hasonlítsa össze a hősi ígéreteket, az árnyilatkozatokat és a cselekvésre ösztönző célpontokat a jóváhagyott példányokkal.
• Funkció: kattintson a navigációra, küldjön be egy teszt kapcsolatfelvételi kérelmet, és ellenőrizze a siker vagy a kudarc útvonalát.
• Reszponzív dizájn: áttekintheti a keskeny képernyőket, az asztalt, a tartalomtúlcsordulást, a képkivágást és az olvasható térközt.
• Hozzáférhetőség: ellenőrizze a billentyűzet sorrendjét, a címkéket, az alternatív szöveget, a szemantikai címsorokat és a kontrasztot.
• Keresés és megbízhatóság: megerősíti az útvonal-specifikus címeket és leírásokat, a hibás hivatkozásokat, a konzolhibákat és a termelési eszközök betöltését.

Telepítse a jóváhagyott buildet egy tényleges nyilvános URL-re

Válassza ki a gyártási célhelyet az utolsó felülvizsgálat előtt. Hagyományos kódbázis esetén csatlakoztassa a tárat egy gazdagéphez, például a Netlifyhoz vagy a Vercelhez, ellenőrizze annak összeállítási beállításait és környezeti változóit, és hagyja, hogy a gazdagép először készítsen előnézetet. Emberi jóváhagyást követően népszerűsítse vagy telepítse a felülvizsgált változatot az adott gazdagép dokumentált munkafolyamatával. Nyissa meg a termelési URL-t kijelentkezve; tesztelje a navigációt, az űrlapokat, a tanúsítványt, a tartományt és a telepített változatot. A Paperclip szerveren való futtatása csak a hangszerelési alkalmazást teszi elérhetővé; nem teszi közzé a weboldalt.

Ha a webhely megfelelő HTML vagy React alkalmazástermék, AgentGrid.io lehet az a megosztott hely, ahol az emberek és a kapcsolt ügynökök ugyanazt a verziót szerkesztik. Importáljon projektmappát vagy ZIP-fájlt, vagy kérjen meg egy csatlakoztatott ügynököt, hogy hozza létre a műterméket a kívánt munkaterületen. Tekintse át a megjelenített alkalmazást és az előzményeket. A műtermék hivatkozása privát a munkaterület-hozzáféréssel rendelkező személyek számára; A közzététel egy különálló, kifejezett művelet, amely nyilvános URL-t hoz létre. A csatlakoztatott ügynöknek közzétételi képességre és emberi kérésre van szüksége a közzétételhez. A későbbi szerkesztések az újbóli közzétételig távol maradnak a nyilvános oldalon. Az egyéni domainekhez jogosult fizetős csomagra és ellenőrzött DNS-re van szükség. Ez egy alternatív közzétételi útvonal, nem pedig azt állítja, hogy a Paperclip automatikusan integrálja a AgentGrid.io-et.

Indítási prompt: „Az ember által jóváhagyott változat [commit or artifact version]. Telepítse [meghatározott gazdagépen] vagy tegye közzé [meghatározott AgentGrid.io műtermék] csak kifejezett engedély után. Adja vissza a nyilvános URL-t, a telepített változatot, a build eredményét és egy füstteszt-ellenőrző listát. Ha a cél vagy az engedély hiányzik, állítsa le, és kérjen engedélyt.”

A promóciónak egy adott felülvizsgálatra kell vonatkoznia

A kiadás előtt rögzítse a jóváhagyott véglegesítési vagy melléktermék verziót, a cél gazdagépet vagy munkaterületet, a tartományt és azt, hogy ki kezdeményezheti a közzétételt. Ha a gazdagép előnézeti URL-eket generál, tekintse meg ugyanannak a változatnak a végső előnézetét, mielőtt hirdetné. Ezután nyissa meg a nyilvános URL-t privilegizált munkamenet nélkül, és ismételje meg a kritikus füstteszteket. Mentse el a visszaállítási hivatkozást arra az esetre, ha a kapcsolati útvonal vagy az eszközök megszakadnak az éles beállítások alatt.

Mikor használja a csapat az egyes rétegeket?

Gémkapocs: akkor válassza, ha több ügynöknek hozzárendelt problémákra, függőségekre, áttekintésre és egy felelős emberi indító tulajdonosra van szüksége. Megmondja a csapatnak, hogy mit kell tennie, és nyomon követi a munkát, nem helyettesíti a forrásvezérlést vagy a webtárhelyet.

Adattár és gazdagép: akkor válassza ezt az utat, ha a webhelynek már meglévő műszaki kiadási folyamatra, kiszolgálószolgáltatásokra, infrastruktúra-beállításokra vagy létrehozott visszaállítási vezérlőkre van szüksége. A felülvizsgált véglegesítési és telepítési rekordnak azonosítania kell az élő verziót.

Folytatás a jóváhagyott verziótól

A gemkapocs a feladatokat és az áttekintést birtokolja. Az Ön tárolója és saját hagyományos éles telepítése. A AgentGrid.io egy megosztott, verziózott műterméket és annak szándékos közzétételét tárolhatja. Egy másik ügynök-webhely munkafolyamat összehasonlításához tekintse meg a mi Grok Bot közzétételi útmutató; olvassa el a megosztott műtermékek mögötti átadás-átvételi problémát a AgentGrid.io bemutatkozásunk; a tervezés-első úthoz pedig lásd egy Claude Design webhely közzététele.

Készen áll arra, hogy a jóváhagyott webhelyet egy helyen tartsa? Hozzon létre egy AgentGrid.io műterméket, hívja meg a megfelelő hozzáféréssel rendelkező következő együttműködőt, és csak akkor tegye közzé, ha a nyilvános verzió átment az ellenőrzésen.