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

# הבא את הסוכן שלך

> כוון את סוכן הקוד AI שלך, או את הסקריפטים שלך, לסביבת הענן המחזיקה את הקוד של האפליקציה שלך

הבא את סוכן הקוד AI שלך, או את הסקריפטים שלך, לאפליקציית Base44 על ידי התחברות ל-sandbox שלה. ה-sandbox היא סביבת ענן פרטית המחזיקה את הקוד עבור הענף שפעיל כרגע בעורך האפליקציה, ומריצה את שרת הפיתוח שלו. זו אותה סביבה, ואותו קוד, שעורך האפליקציה של Base44 עצמו עורך, בלי fork או עותק לשמור מסונכרן. כשאתה כותב קובץ דרך פקודת sandbox, אתה משנה את האפליקציה האמיתית שלך ישירות, על הענף הפעיל שלה, באותה דרך שעורך האפליקציה היה עושה.

זה מאפשר לך לפתח אפליקציה עם הכלים שלך במקום עם עורך האפליקציה, בלי checkout מקומי ובלי שום דבר להתקין. עבוד על אפליקציה ממחשב שאין לו עותק שלה, או כתוב סקריפט לשינוי על פני אפליקציה שבנית לגמרי בעורך האפליקציה.

<Note>
  עריכה דרך ה-sandbox אינה זהה לפרסום. העריכה שלך הופכת לחלק מקוד האפליקציה מיד ומופיעה בעורך האפליקציה ובתצוגה המקדימה החיה שלו, אבל הגעה לאתר הציבורי של האפליקציה עדיין לוקחת את אותו שלב פרסום שהיא הייתה לשינוי שנעשה בעורך האפליקציה.
</Note>

<Warning>
  אתה צריך [**Builder plan**](/Account-and-billing/Billing-and-plans) או גבוה יותר כדי להגיע ל-sandbox של אפליקציה מחוץ לעורך האפליקציה. בלעדיו, פקודות נכשלות עם `PREMIUM_REQUIRED`.
</Warning>

ה-sandbox עצמה היא תהליך מחשוב חי, לא רק אחסון: היא נכבית כשהיא יושבת סרק לזמן מה, ומתעוררת שוב על הפקודה הבאה. הקוד שלך אינו מושפע בשני המקרים, מכיוון שהוא חי ב-git ולא בתהליך הזה. אם ה-sandbox אינה פועלת כרגע, הפקודה הראשונה מפעילה אותה, וקריאה זו לוקחת יותר זמן מאלה שאחריה.

## שתי דרכים להתחבר

ה-sandbox חושפת את אותה קבוצה של פעולות דרך שני משטחים, הנתמכים על ידי אותה מימוש. השתמש במה שמתאים להגדרה שלך.

* **[CLI](/developers/references/cli/get-started/overview):** מתאים לכל דבר שרץ על המחשב שלך, כולל סוכן קוד מקומי והסקריפטים שלך. אמת פעם אחת עם [`base44 login`](/developers/references/cli/commands/login), ואז כוון לאפליקציה עם [`--app-id`](/developers/references/cli/commands/introduction#select-a-target-app) או משתנה הסביבה `BASE44_APP_ID`. אין דרישה לפרויקט מקומי.
* **[MCP server](/developers/backend/overview/mcp-server):** מתאים לעוזר AI המתחבר דרך MCP, כולל עוזרים מבוססי ווב שאינם יכולים להריץ CLI כלל. חבר אותו פעם אחת ואשר עם OAuth.

| פעולה             | פקודת CLI                                                                      | כלי MCP             |
| ----------------- | ------------------------------------------------------------------------------ | ------------------- |
| רשימת ספרייה      | [`sandbox ls`](/developers/references/cli/commands/sandbox-ls)                 | `list_directory`    |
| קריאת קבצים       | [`sandbox read`](/developers/references/cli/commands/sandbox-read)             | `read_file`         |
| חיפוש בתוכן קבצים | [`sandbox grep`](/developers/references/cli/commands/sandbox-grep)             | `grep`              |
| יצירת קובץ        | [`sandbox write`](/developers/references/cli/commands/sandbox-write)           | `write_file`        |
| שינוי קובץ קיים   | [`sandbox edit`](/developers/references/cli/commands/sandbox-edit)             | `edit_file`         |
| הרצת פקודת shell  | [`sandbox run`](/developers/references/cli/commands/sandbox-run)               | `run_command`       |
| שמירת נקודת שחזור | [`sandbox checkpoint`](/developers/references/cli/commands/sandbox-checkpoint) | `create_checkpoint` |

מחברים אינם עוברים דרך מערכת הקבצים של ה-sandbox, ולכן הם אינם בטבלה למעלה. כדי להגדיר מחבר על אפליקציה שאתה עובד איתה בדרך זו, השתמש ב-[`connectors initiate`](/developers/references/cli/commands/connectors-initiate) במקום. הוא מכוון לאותו מזהה אפליקציה ישירות, בלי sandbox או פרויקט מקומי.

<Tip>
  הדרך המהירה ביותר להתחיל עם סוכן הקוד שלך היא להשתמש ב-**Send to Coding Agent** בעורך האפליקציה של Base44. בדסקטופ, פתח **More actions** (שלוש הנקודות ליד **Publish**, בפינה הימנית העליונה) ובחר **Send to Coding Agent**. בחר סוכן CLI מקומי או צ'אט ווב, והוא מוסר לך הנחיה מוכנה להדבקה, כך שאינך צריך להגדיר את זה ביד. הוא אינו מוצע לאפליקציות מובייל או אפליקציות עם קוד מקור לא מנוהל.
</Tip>

## השינויים נשמרים אוטומטית

קריאת [`sandbox write`](/developers/references/cli/commands/sandbox-write) או [`sandbox edit`](/developers/references/cli/commands/sandbox-edit) מבצעת commit של השינוי עבורך כחלק מאותה בקשה, לפני שהפקודה מסתיימת, כך שאין שלב שמירה, פריסה או push נפרד. שינוי קובץ שנעשה דרך [`sandbox run`](/developers/references/cli/commands/sandbox-run), כמו `rm` או `mv`, מבצע commit כמה שניות מאוחר יותר במקום, לאחר שחלון debounce קצר נסגר. אם אתה כותב או עורך שוב לפני ש-commit מוקדם יותר בהשהיה הגיע, הקריאה החדשה ממתינה לו ונכשלת עם `COMMIT_FLUSH_PENDING` אם היא אינה יכולה לאשר שה-commit הזה הסתיים בזמן. לאחר ש-commit מגיע:

* השינוי גלוי בעורך האפליקציה של Base44.
* הוא בטוח גם אם סביבת המחשוב של ה-sandbox ממוחזרת לאחר ישיבה סרק, מכיוון שסביבה חדשה תמיד מתחילה מה-commit האחרון שלך ולא מתמונת מצב ישנה יותר.
* הוא כלול בפעם הבאה שאתה מפרסם את האפליקציה.

משאבים מובנים מסתנכרנים באותה דרך: בניגוד לפרויקט מקומי, שבו היית מריץ [`entities push`](/developers/references/cli/commands/entities-push) או [`functions deploy`](/developers/references/cli/commands/functions-deploy) לאחר הוספת קובץ, יצירת `base44/functions/send-email/entry.ts` ב-sandbox היא כל מה שדרוש להוסיף את הפונקציה הזו.

<Warning>
  * אל תריץ [`deploy`](/developers/references/cli/commands/deploy), [`functions deploy`](/developers/references/cli/commands/functions-deploy), [`entities push`](/developers/references/cli/commands/entities-push), או פקודות ה-push האחרות מול אפליקציה שאתה עורך ב-sandbox שלה. הפקודות האלה מסנכרנות פרויקט מקומי ל-Base44, ואין פרויקט מקומי כשעובדים עם sandbox.
  * אם הפעולה האחרונה שלך הייתה פקודת shell שרצה דרך `sandbox run` ולא קריאת `write` או `edit`, ה-commit שלה עדיין רגע מאחור. תן לו כמה שניות לפני שאתה מתנתק.
</Warning>

## Checkpoints

Checkpoint היא נקודת שחזור בהיסטוריית הגרסאות של האפליקציה, מעוגנת ל-commit ספציפי. צור אותה עם [`sandbox checkpoint`](/developers/references/cli/commands/sandbox-checkpoint) כדי לסמן מצב ידוע-טוב, ואז שחזר אותה מעורך האפליקציה אם שינוי מאוחר יותר משתבש. שינויים ממתינים מבוצעים commit לפני שה-checkpoint נלקח, כך שהוא תמיד תופס את הקוד העדכני שלך.

## עבודה לצד עורך האפליקציה

סוכן הקוד שלך ועורך האפליקציה של Base44 יכולים לעבוד על אותה אפליקציה באותו זמן. אין lock לרכוש ואין sessions לשחרר. שינויים משני הצדדים מגיעים לאותו מקום, אז התייחס לזה כפי שהיית מתייחס לעמית העורך את אותו פרויקט.

<Warning>
  אין שלב מיזוג. אם סוכן הקוד שלך ועורך האפליקציה משנים את אותו קובץ באותו זמן, מי שהכתיבה שלו מגיעה אחרון מנצח, והשינוי המוקדם יותר נעלם. הימנע מהמצב שבו שני הצדדים נוגעים באותו קובץ באותו קטע של עבודה.
</Warning>

## הרשאות

שתי בדיקות נפרדות שולטות בגישה ל-sandbox: האם אתה יכול לגשת לאפליקציה הזו בכלל, והאם ה-session הנוכחי שלך קיבל גישת כתיבה אליה.

### גישה לאפליקציה

אתה צריך גישת admin לאפליקציה עצמה, בין אם כמנהל של מרחב עבודה או כמשתף פעולה על האפליקציה הספציפית הזו. הגישה נבדקת בכל קריאה, כך ששינוי בתפקיד מרחב העבודה שלך נכנס לתוקף מיד.

צופה רגיל של מרחב עבודה אינו יכול להגיע ל-sandbox כלל. היוצא מן הכלל הוא צופה שמחזיק גם בתפקיד עורך לגאסי לכל אפליקציה מלפני שמרחב העבודה שלך עבר לגישה מבוססת-תפקיד. השילוב הזה עדיין יכול לקרוא מה-sandbox, אך לא לשנות שום דבר. Superagents אינם תומכים בפקודות sandbox.

### היקף Session

מעבר לגישה לאפליקציה, קריאה ושינוי של ה-sandbox דורשים הרשאות שונות ב-session שלך:

| פקודות                                                               | הרשאה נדרשת                    |
| -------------------------------------------------------------------- | ------------------------------ |
| `sandbox ls`, `sandbox read`, `sandbox grep`                         | `apps:read`, מוענק כברירת מחדל |
| `sandbox write`, `sandbox edit`, `sandbox run`, `sandbox checkpoint` | `sandbox:write`                |

ההרשאות של ה-session שלך קבועות בעת יצירתו ולא ניתנות להרחבה מאוחר יותר. ה-CLI מבקש `sandbox:write` במהלך `base44 login`, ומעל MCP אתה מעניק אותו בשלב הסכמת OAuth. חידוש session קיים אינו מוסיף אותו.

אז אם פקודות הקריאה עובדות אך פקודות השינוי נכשלות עם `NOT_AUTHORIZED`, אתה על session שמעולם לא היה לו `sandbox:write`. הרץ [`base44 login`](/developers/references/cli/commands/login) שוב, או חבר מחדש את ה-MCP server ואשר גישת sandbox, כדי להתחיל session שיש לו אותו.

## גבולות ומגני בטיחות

פקודות קבצים מוגבלות לשורש האפליקציה. נתיבים מוחלטים ונתיבים המטפסים מעל השורש נדחים עם `PATH_OUTSIDE_SANDBOX`. הספריות `.agents` ו-`.git` אינן ניתנות להשגה מפקודות הקבצים, ונכשלות עם `PROTECTED_PATH`, מכיוון שהן מחזיקות את הסודות של האפליקציה ואת פרטי המאגר. היוצא מן הכלל הוא `.agents/skills`, שתוכל לקרוא ולכתוב כך שהסוכן שלך יוכל לעבוד עם ה-[skills](/developers/backend/overview/skills) שהאפליקציה התקינה.

בכל התכונה, אתה מוגבל ל-120 בקשות קריאה, 60 בקשות שינוי, ו-30 פקודות run בדקה, לכל אפליקציה. חריגה מכל אחד מאלה נכשלת עם `RATE_LIMITED`. דף העזר של כל פקודה מכסה את מגבלות הגודל והספירה שלה, כמו כמה נתיבים `sandbox read` מקבל או כמה גדול קובץ ש-`sandbox write` מאפשר.

## ראה גם

* [Base44 MCP server](/developers/backend/overview/mcp-server): חבר עוזר AI לחשבון Base44 שלך
* [סקירת CLI](/developers/references/cli/get-started/overview): התקן והשתמש ב-CLI של Base44
* [מבנה פרויקט](/developers/backend/overview/project-structure): איך קבצי פרויקט Base44 מאורגנים
* [פיתוח מקומי](/developers/backend/overview/local-dev/local-development-overview): הרץ פרויקט Base44 על המחשב שלך במקום
* [Skills](/developers/backend/overview/skills): למד סוכני קוד AI איך לעבוד עם Base44
* [`connectors initiate`](/developers/references/cli/commands/connectors-initiate): הגדר מחבר על אפליקציה בלי sandbox או פרויקט מקומי

<Note>דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](/). </Note>