Mikor használja a sandboxot
Egy alkalmazásszerkesztőben épített alkalmazás kódján a következő módokon dolgozhat:
A sandbox és a GitHub-integráció fedi át egymást a leginkább, mert mindkettővel saját eszközeivel dolgozhat. A különbség az, hogy munka közben hol van a kód. A GitHub-integrációval egy helyi klónban fejleszt, és a módosítások akkor jutnak el a Base44-be, amikor a
main ágba olvasztják őket. A sandboxszal helyben dolgozik az alkalmazás kódján. Nincs mit letölteni, webes asszisztens is használhatja, és minden módosítás azonnal megjelenik az alkalmazásszerkesztő élő előnézetében.
Csatlakozási módok
A sandboxot a következő módokon érheti el:- CLI: A saját gépén futó kódolóügynökhöz vagy szkriptekhez. Nincs szükség helyi projektre. A beállításhoz lásd: Helyi ügynök csatlakoztatása a CLI-vel.
- MCP-szerver: MCP-n keresztül csatlakozó MI-asszisztenshez, beleértve a CLI futtatására nem képes webes asszisztenseket is. A beállításhoz lásd: Ügynök csatlakoztatása MCP-n keresztül.
- App Management API: Saját integrációkhoz, az alább felsorolt végpontokkal.
Az összekötők nem a sandbox fájlrendszerén keresztül működnek, ezért nem szerepelnek a fenti táblázatban. Ha összekötőt szeretne beállítani egy így használt alkalmazáson, használja inkább a
connectors initiate parancsot. Ez közvetlenül ugyanazt az alkalmazásazonosítót célozza, sandbox és helyi projekt nélkül.
Ágak
A sandbox-parancsok az alkalmazásmain ágát célozzák, hacsak mást nem ad meg. Ha egy másik ágon szeretne dolgozni, a branches list paranccsal keresse meg a pontos nevét, majd minden sandbox-parancsnál adja meg a --branch <name> kapcsolót. Az olvasások és szerkesztések ekkor csak arra az ágra vonatkoznak.
A módosítások automatikusan mentődnek
Asandbox write vagy a sandbox edit hívás ugyanannak a kérésnek a részeként, a parancs visszatérése előtt véglegesíti a módosítást, így nincs külön mentési, telepítési vagy feltöltési lépés. A sandbox run paranccsal végzett fájlmódosítás, például rm vagy mv, néhány másodperccel később véglegesítődik, amint lezárul egy rövid késleltetési időszak. Ha azelőtt ír vagy szerkeszt újra, hogy egy korábbi késleltetett véglegesítés befejeződött volna, az új hívás megvárja azt, és COMMIT_FLUSH_PENDING hibával hiúsul meg, ha nem tudja időben megerősíteni a véglegesítést.
A strukturált erőforrások ugyanígy szinkronizálódnak. Helyi projektben egy fájl hozzáadása után futtatná az entities push vagy a functions deploy parancsot. A sandboxban a base44/functions/send-email/entry.ts létrehozása elég a függvény hozzáadásához.
Szerkesztés és közzététel
A sandboxon keresztüli szerkesztés nem azonos a közzététellel. A szerkesztés azonnal az alkalmazás kódjának része lesz, és megjelenik az alkalmazásszerkesztőben és annak élő előnézetében. Ahhoz, hogy az alkalmazás nyilvános webhelyén is megjelenjen, ugyanaz a közzétételi lépés kell, mint az alkalmazásszerkesztőben végzett módosításoknál.Ellenőrzőpontok
Az ellenőrzőpont egy visszaállítási pont az alkalmazás verzióelőzményeiben, egy adott commithoz rögzítve. Asandbox checkpoint paranccsal hozhat létre egyet egy ismert, jó állapot megjelölésére, majd ha egy későbbi módosítás elront valamit, visszaállíthatja az alkalmazásszerkesztőből. A függőben lévő módosítások az ellenőrzőpont létrehozása előtt véglegesítődnek, így mindig a legfrissebb kódot rögzíti.
Munka az alkalmazásszerkesztővel párhuzamosan
A kódolóügynöke és a Base44 alkalmazásszerkesztő egyszerre dolgozhat ugyanazon az alkalmazáson. Nincs zárolás, amelyet meg kellene szerezni, és nincs munkamenet, amelyet fel kellene oldani. Mindkét oldal módosításai ugyanoda kerülnek, ezért kezelje úgy, mintha egy kolléga szerkesztené ugyanazt a projektet.Indítás és leállítás
A sandbox futó folyamat, nem csak tárhely. Ha egy ideig tétlen, leáll, és a következő parancsra újraindul. A kódot ez egyik esetben sem érinti. A véglegesített módosítások a gitben vannak, és egy újraindított sandbox mindig a legutóbbi commitból indul. Ha a sandbox nem fut, az első parancs elindítja, ezért ez a hívás valószínűleg tovább tart, mint az utána következők.Jogosultságok
A sandbox elérését két külön ellenőrzés szabályozza. Az egyik, hogy egyáltalán hozzáfér-e az alkalmazáshoz, a másik, hogy az aktuális munkamenete kapott-e írási hozzáférést.Hozzáférés az alkalmazáshoz
Adminisztrátori hozzáférésre van szüksége magához az alkalmazáshoz, munkaterület-adminisztrátorként vagy az adott alkalmazás közreműködőjeként. A hozzáférést minden hívásnál ellenőrizzük, így a munkaterületi szerepkör módosítása azonnal érvényes. Egy egyszerű munkaterületi megtekintő egyáltalán nem érheti el a sandboxot. Az egyetlen kivétel az a megtekintő, akinek egy régi, alkalmazásonkénti szerkesztői szerepköre is van abból az időből, mielőtt a munkaterület szerepköralapú hozzáférésre váltott. Ez a kombináció továbbra is olvashat a sandboxból, de semmit sem módosíthat. A Superagentek nem támogatják a sandbox-parancsokat.A munkamenet hatóköre
Az alkalmazáshoz való hozzáférésen túl a sandbox olvasása és módosítása eltérő jogosultságokat igényel a munkamenettől:
A munkamenet jogosultságai a létrehozáskor rögzülnek, és később nem bővíthetők. A CLI a
base44 login során kéri a sandbox:write jogosultságot, MCP-n keresztül pedig az OAuth hozzájárulási lépésnél adja meg. Egy meglévő munkamenet megújítása nem adja hozzá.
Ha tehát az olvasási parancsok működnek, de a módosítók NOT_AUTHORIZED hibával hiúsulnak meg, olyan munkamenetet használ, amely soha nem kapott sandbox:write jogosultságot. Futtassa újra a base44 login parancsot, vagy csatlakoztassa újra az MCP-szervert, és hagyja jóvá a sandbox-hozzáférést, hogy ezzel rendelkező munkamenetet indítson.
Korlátok és védőkorlátok
A fájlparancsok az alkalmazás gyökérkönyvtárára korlátozódnak. Az abszolút útvonalakat és a gyökér fölé vezető útvonalakatPATH_OUTSIDE_SANDBOX hibával utasítja el a rendszer. Az .agents és a .git könyvtár nem érhető el a fájlparancsokkal, és PROTECTED_PATH hibát ad, mert az alkalmazás titkos adatait és a tároló hitelesítő adatait tartalmazzák. Az egyetlen kivétel az .agents/skills, amelyet olvashat és írhat.
A teljes funkcióra vonatkozóan alkalmazásonként percenként legfeljebb 120 olvasási kérés, 60 módosítási kérés és 30 futtatási parancs engedélyezett. Bármelyik túllépése RATE_LIMITED hibát ad. Az egyes parancsok saját referenciaoldala ismerteti a méret- és darabszámkorlátokat, például hogy hány útvonalat fogad el a sandbox read, vagy mekkora fájlt enged a sandbox write.
Lásd még
- Saját ügynök használata: Saját MI-kódolóügynök csatlakoztatása egy alkalmazás sandboxához
- A CLI áttekintése: A Base44 CLI telepítése és használata
- Base44 MCP-szerver: MI-asszisztens csatlakoztatása a Base44-fiókjához
- GitHub-integráció: Helyi fejlesztés kétirányú tárolószinkronizálással
- Projektstruktúra: A Base44 projektfájlok felépítése
Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.