> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Felhőalapú sandbox

> Az alkalmazás kódját tároló privát felhőkörnyezet, és hogyan dolgozhat benne helyi másolat nélkül

Minden Base44-alkalmazásnak van egy sandboxa: egy privát felhőkörnyezet, amely az alkalmazás kódját tárolja, és futtatja a fejlesztői szerverét. Ez ugyanaz a környezet és ugyanaz a kód, amelyet az alkalmazásszerkesztő használ, nincs elágazás vagy másolat, amelyet szinkronban kellene tartani. A CLI-vel, egy MCP-klienssel vagy az API-val csatlakozhat hozzá, hogy bármelyik gépről olvasson, keressen, szerkesszen és parancsokat futtasson az alkalmazáson, helyi checkout és telepítés nélkül.

Ha a sandboxon keresztül ír egy fájlt, közvetlenül a valódi alkalmazást módosítja, ugyanúgy, ahogy az alkalmazásszerkesztő tenné. Ennek leggyakoribb oka, hogy [saját kódolóügynökét használja](https://docs.base44.com/hu/developers/app-code/sandbox/bring-your-own-agent.md) egy alkalmazásszerkesztőben épített alkalmazással.

> [!WARNING]
>
> Ahhoz, hogy az alkalmazásszerkesztőn kívülről elérje egy alkalmazás sandboxát, [**Builder csomagra**](https://docs.base44.com/hu/Account-and-billing/Billing-and-plans.md) vagy magasabbra van szüksége. Enélkül a parancsok `PREMIUM_REQUIRED` hibával hiúsulnak meg.

## Mikor használja a sandboxot

Egy alkalmazásszerkesztőben épített alkalmazás kódján a következő módokon dolgozhat:

| Lehetőség | Mikor használja | Szükséges beállítás |
| - | - | - |
| [Kód lap](https://docs.base44.com/hu/developers/app-code/editor/code-tab.md) | Gyors szerkesztést szeretne a böngészőben. | Nincs. |
| Felhőalapú sandbox | Azt szeretné, hogy saját kódolóügynöke vagy szkriptjei letöltés nélkül módosítsák az alkalmazást. | Bejelentkezés a CLI-vel, vagy csatlakozás MCP-n keresztül. |
| [GitHub-integráció](https://docs.base44.com/hu/developers/app-code/local-development/github.md) | A kódot saját tárolójában szeretné tartani, teljes helyi beállítással az IDE-jében. | Egy alkalmazástulajdonos egyszer csatlakoztat egy tárolót. Ezután minden gép klónozza, és telepíti a CLI-t. |
| [Eject](https://docs.base44.com/developers/references/cli/commands/eject.md) | A kód Base44-en kívüli másolatát szeretné, amely nem szinkronizálódik vissza. | Egyetlen parancs. |

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](https://docs.base44.com/developers/references/cli/get-started/overview.md):** 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](https://docs.base44.com/hu/developers/app-code/sandbox/bring-your-own-agent.md#connect-a-local-agent-with-the-cli).
* **[MCP-szerver](https://docs.base44.com/hu/developers/backend/overview/mcp-server.md):** 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](https://docs.base44.com/hu/developers/app-code/sandbox/bring-your-own-agent.md#connect-an-agent-over-mcp).
* **[App Management API](https://docs.base44.com/developers/references/apps-api/get-started/overview.md):** Saját integrációkhoz, az alább felsorolt végpontokkal.

| Művelet | CLI-parancs | MCP-eszköz | API-végpont |
| - | - | - | - |
| Könyvtár listázása | [`sandbox ls`](https://docs.base44.com/developers/references/cli/commands/sandbox-ls) | `list_directory` | [List app files](https://docs.base44.com/api-reference/list-app-files.md) |
| Fájlok olvasása | [`sandbox read`](https://docs.base44.com/developers/references/cli/commands/sandbox-read) | `read_file` | [Read app files](https://docs.base44.com/api-reference/read-app-files.md) |
| Keresés a fájlok tartalmában | [`sandbox grep`](https://docs.base44.com/developers/references/cli/commands/sandbox-grep) | `grep` | [Search app files](https://docs.base44.com/api-reference/search-app-files.md) |
| Fájl létrehozása | [`sandbox write`](https://docs.base44.com/developers/references/cli/commands/sandbox-write) | `write_file` | [Write an app file](https://docs.base44.com/api-reference/write-an-app-file.md) |
| Meglévő fájl módosítása | [`sandbox edit`](https://docs.base44.com/developers/references/cli/commands/sandbox-edit) | `edit_file` | [Edit an app file](https://docs.base44.com/api-reference/edit-an-app-file.md) |
| Shellparancs futtatása | [`sandbox run`](https://docs.base44.com/developers/references/cli/commands/sandbox-run) | `run_command` | [Run a sandbox command](https://docs.base44.com/api-reference/run-a-sandbox-command.md) |
| Visszaállítási pont mentése | [`sandbox checkpoint`](https://docs.base44.com/developers/references/cli/commands/sandbox-checkpoint) | `create_checkpoint` | [Create a sandbox checkpoint](https://docs.base44.com/api-reference/create-a-sandbox-checkpoint.md) |

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`](https://docs.base44.com/developers/references/cli/commands/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ás `main` ágát célozzák, hacsak mást nem ad meg. Ha egy másik [ágon](https://docs.base44.com/hu/Building-your-app/working-with-branches.md) szeretne dolgozni, a [`branches list`](https://docs.base44.com/developers/references/cli/commands/branches-list) paranccsal keresse meg a pontos nevét, majd minden sandbox-parancsnál adja meg a [`--branch <name>`](https://docs.base44.com/developers/references/cli/commands/introduction#target-a-branch) kapcsolót. Az olvasások és szerkesztések ekkor csak arra az ágra vonatkoznak.

## A módosítások automatikusan mentődnek

A [`sandbox write`](https://docs.base44.com/developers/references/cli/commands/sandbox-write) vagy a [`sandbox edit`](https://docs.base44.com/developers/references/cli/commands/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`](https://docs.base44.com/developers/references/cli/commands/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`](https://docs.base44.com/developers/references/cli/commands/entities-push) vagy a [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/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.

> [!WARNING]
>
> **Két szabály a sandboxban végzett szerkesztéshez:**
>
> * Ne futtassa a [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy), a [`functions deploy`](https://docs.base44.com/developers/references/cli/commands/functions-deploy), az [`entities push`](https://docs.base44.com/developers/references/cli/commands/entities-push) vagy a többi feltöltési parancsot olyan alkalmazáson, amelyet a sandboxában szerkeszt. Ezek a parancsok egy helyi projektet szinkronizálnak a Base44-gyel, sandboxszal dolgozva pedig nincs helyi projekt.
> * Ha az utolsó művelete nem `write` vagy `edit` hívás, hanem a `sandbox run` paranccsal futtatott shellparancs volt, annak véglegesítése még egy kicsit késik. A kapcsolat bontása előtt várjon néhány másodpercet.

## 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. A [`sandbox checkpoint`](https://docs.base44.com/developers/references/cli/commands/sandbox-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.

> [!WARNING]
>
> Nincs összefésülési lépés. Ha a kódolóügynök és az alkalmazásszerkesztő egyszerre módosítja ugyanazt a fájlt, az utolsóként beérkező írás nyer, a korábbi módosítás pedig elvész. Kerülje, hogy egy munkaszakaszban mindkét oldal ugyanazt a fájlt módosítsa.

## 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:

| Parancsok | Szükséges jogosultság |
| - | - |
| `sandbox ls`, `sandbox read`, `sandbox grep` | `apps:read`, alapértelmezés szerint megadva |
| `sandbox write`, `sandbox edit`, `sandbox run`, `sandbox checkpoint` | `sandbox:write` |

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`](https://docs.base44.com/developers/references/cli/commands/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ő útvonalakat `PATH_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](https://docs.base44.com/hu/developers/app-code/sandbox/bring-your-own-agent.md): Saját MI-kódolóügynök csatlakoztatása egy alkalmazás sandboxához
* [A CLI áttekintése](https://docs.base44.com/developers/references/cli/get-started/overview.md): A Base44 CLI telepítése és használata
* [Base44 MCP-szerver](https://docs.base44.com/hu/developers/backend/overview/mcp-server.md): MI-asszisztens csatlakoztatása a Base44-fiókjához
* [GitHub-integráció](https://docs.base44.com/hu/developers/app-code/local-development/github.md): Helyi fejlesztés kétirányú tárolószinkronizálással
* [Projektstruktúra](https://docs.base44.com/hu/developers/backend/overview/project-structure.md): A Base44 projektfájlok felépítése

> [!NOTE]
>
> 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](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.