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

# base44 agents push

> דחוף תצורות סוכני AI מקומיות ל-Base44. סוכנים הם עוזרי AI שיחתיים שיכולים לתקשר עם משתמשים, לגשת לישויות של האפליקציה שלך, ולקרוא לפונקציות backend.

<Warning>
  דף זה הוא חלק ממיומנות של סוכן קידוד AI ונכתב לסוכנים, לא לבני אדם. לתיעוד Base44 הקריא לבני אדם, ראה את [תיעוד המפתחים](/developers).
</Warning>

# base44 agents push

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

## תחביר

```bash theme={null}
npx base44 agents push
```

## אימות

**נדרש**: כן. אם לא מאומת, תתבקש להתחבר תחילה.

## מה זה עושה

1. קורא את כל קבצי הסוכן מתיקיית `base44/agents/`
2. מאמת תצורות סוכן
3. מציג את מספר הסוכנים לדחיפה
4. מעלה סוכנים ל-Base44 backend
5. מדווח על התוצאות: סוכנים שנוצרו, עודכנו ונמחקו

## דרישות מקדימות

* חייב לרוץ מתיקיית פרויקט Base44
* הפרויקט חייב לכלול הגדרות סוכן בתיקיית `base44/agents/`

## פלט

```bash theme={null}
$ npx base44 agents push

Found 2 agents to push
Pushing agents to Base44...

Created: support_agent
Updated: order_bot
Deleted: old_agent

✓ Agents pushed to Base44
```

## סנכרון סוכנים

פעולת ה-push מסנכרנת את הסוכנים המקומיים שלך עם Base44:

* **נוצר**: סוכנים חדשים שלא היו קיימים ב-Base44
* **עודכן**: סוכנים קיימים עם תצורה שהשתנתה
* **נמחק**: סוכנים שהוסרו מהתצורה המקומית שלך

**אזהרה**: זו פעולת סנכרון מלאה. סוכנים שהוסרו מקומית יימחקו מ-Base44.

## טיפול בשגיאות

אם לא נמצאו סוכנים בפרויקט שלך:

```bash theme={null}
$ npx base44 agents push
No local agents found - this will delete all remote agents
```

אם לסוכן יש שם לא תקף:

```bash theme={null}
$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores
```

## סכמת תצורת סוכן

כל קובץ סוכן צריך להיות קובץ `.jsonc` ב-`base44/agents/` עם המבנה הזה:

```jsonc theme={null}
{
  "name": "agent_name",              // Required: lowercase alphanumeric with underscores, 1-100 chars
  "description": "Brief description of what this agent does",  // Required: min 1 char
  "instructions": "Detailed instructions for the agent's behavior",  // Required: min 1 char
  "tool_configs": [                  // Optional: defaults to []
    // Entity tool - gives agent access to entity operations
    { "entity_name": "Task", "allowed_operations": ["read", "create", "update", "delete"] },
    // Backend function tool - gives agent access to a function
    { "function_name": "send_email", "description": "Send an email notification" }
  ],
  "whatsapp_greeting": "Hello! How can I help you today?"  // Optional
}
```

**כללי מתן שם:**

* **שמות סוכנים** חייבים להתאים לתבנית: `/^[a-z0-9_]+$/` (אלפאנומרי באותיות קטנות עם קווים תחתונים בלבד, 1-100 תווים)
  * תקף: `support_agent`, `order_bot`, `task_helper`
  * לא תקף: `Support-Agent`, `OrderBot`, `task helper`
* **שמות קבצי סוכן** חייבים להשתמש בקווים תחתונים (תואמים לשם הסוכן)
  * תקף: `support_agent.jsonc`, `order_bot.jsonc`
  * לא תקף: `support-agent.jsonc` (מקפים אינם מותרים)
* **שמות ישויות ב-`tool_configs`** חייבים להשתמש ב-PascalCase (תואמים לשדה `name` של הישות)
  * תקף: `"entity_name": "Task"`, `"entity_name": "TeamMember"`
  * לא תקף: `"entity_name": "task"`, `"entity_name": "team_member"`

**שדות נדרשים:**

* `name`: נדרש, חייב לעקוב אחר כללי מתן שמות למעלה
* `description`: נדרש, מינימום תו אחד
* `instructions`: נדרש, מינימום תו אחד
* `tool_configs`: אופציונלי, ברירת מחדל היא מערך ריק
* `whatsapp_greeting`: אופציונלי

### טעות נפוצה: פורמט tool\_configs שגוי

**שגוי** - אל תשתמש ב-`tools` עם `type` ו-`entity`:

```jsonc theme={null}
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
```

**נכון** - השתמש ב-`tool_configs` עם `entity_name` ו-`allowed_operations`:

```jsonc theme={null}
{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECT
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}
```

### שיטות עבודה מומלצות להוראות סוכן

כאשר אתה נותן לסוכנים גישה לישויות, היה מפורש בהוראות לגבי שימוש בכלים:

```jsonc theme={null}
{
  "name": "support_agent",
  "instructions": "You are a helpful support agent.\n\nIMPORTANT: You have access to customer data through entity tools. When users ask about their orders or account:\n1. ALWAYS use the Order entity tool to query their order history\n2. Use the Customer entity tool to look up account details\n3. Analyze the data and provide personalized responses\n\nAlways query the relevant entities first before answering questions about user data.",
  "tool_configs": [
    { "entity_name": "Order", "allowed_operations": ["read"] },
    { "entity_name": "Customer", "allowed_operations": ["read"] }
  ]
}
```

ללא הוראות מפורשות להשתמש בכלי הישות, הסוכן עשוי לא לשאול נתוני משתמש באופן יזום כאשר נשאל.

## מקרי שימוש

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

## הערות

* פקודה זו מסנכרנת את תצורת הסוכן, לא נתוני שיחה
* שינויים מיושמים לפרויקט Base44 שלך מיד
* ודא לבדוק שינויי סוכן בסביבת פיתוח תחילה
* הגדרות סוכן ממוקמות בתיקיית `base44/agents/`
* השתמש ב-`base44 agents pull` להורדת סוכנים מ-Base44

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