Skip to main content
דף זה הוא חלק ממיומנות של סוכן קידוד AI ונכתב לסוכנים, לא לבני אדם. לתיעוד Base44 הקריא לבני אדם, ראה את תיעוד המפתחים.

base44 agents push

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

תחביר

npx base44 agents push

אימות

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

מה זה עושה

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

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

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

פלט

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

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

אם לא נמצאו סוכנים בפרויקט שלך:
$ npx base44 agents push
No local agents found - this will delete all remote agents
אם לסוכן יש שם לא תקף:
$ npx base44 agents push
Error: Agent name must be lowercase alphanumeric with underscores

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

כל קובץ סוכן צריך להיות קובץ .jsonc ב-base44/agents/ עם המבנה הזה:
{
  "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:
{
  "name": "my_agent",
  "tools": [                                    // ❌ WRONG
    { "type": "entity_query", "entity": "Task" }
  ]
}
נכון - השתמש ב-tool_configs עם entity_name ו-allowed_operations:
{
  "name": "my_agent",
  "tool_configs": [                             // ✅ CORRECT
    { "entity_name": "Task", "allowed_operations": ["read"] }
  ]
}

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

כאשר אתה נותן לסוכנים גישה לישויות, היה מפורש בהוראות לגבי שימוש בכלים:
{
  "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
דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.