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

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# מידע על סוכנים

> הגדר סוכני AI באמצעות קובצי תצורה מקומיים

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      אתה צופה בתיעוד למפתחים
    </div>

    <div className="dev-docs-banner-text">
      תיעוד זה מיועד למפתחים העובדים עם פלטפורמת המפתחים של Base44. למידע על סוכני AI בעורך האפליקציות, ראה <a href="/he/Building-your-app/AI-agents-for-apps">הגדרת סוכן AI</a>.
    </div>
  </div>
</div>

[סוכני AI](/he/Building-your-app/AI-agents-for-apps) הם עוזרי AI הניתנים להתאמה אישית. הם מבצעים פעולות ומתחברים לכלים כדי לעזור לחברי צוות ולמשתמשי קצה. אפשר להגדיר את ההתנהגות, ההרשאות והכלים של כל סוכן בקובצי תצורה מקומיים בפורמט JSONC.

## יצירת סוכנים

צור קובצי תצורה בפורמט JSONC בתיקייה `base44/agents/`, קובץ אחד לכל סוכן. לאחר מכן הרץ את [`agents push`](/he/developers/references/cli/commands/agents-push) כדי לסנכרן אותם ל-Base44.

## דוגמה

```jsonc theme={null}
{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "claude-sonnet-5",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"],
    },
    {
      "entity_name": "customers",
      "allowed_operations": ["read"],
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer",
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent",
    },
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?",
  "selected_skill_names": ["refund-policy", "brand-voice"],
}
```

## מדריך שדות

תצורות הסוכנים משתמשות ב-JSONC. כל סוכן מוגדר בקובץ נפרד בתיקייה `base44/agents/`.

### שדות חובה

<ResponseField name="name" type="string" required>
  מזהה ייחודי של הסוכן. השתמש באותיות קטנות ובקווים תחתונים. השם צריך
  להתאים לשם הקובץ. לדוגמה, סוכן בשם `customer_support` יוגדר
  בקובץ `customer_support.jsonc`.
</ResponseField>

<ResponseField name="description" type="string" required>
  תיאור קצר של מה שהסוכן עושה.
</ResponseField>

<ResponseField name="instructions" type="string" required>
  פרומפט מערכת שמגדיר את ההתנהגות, האישיות וההנחיות של הסוכן.
</ResponseField>

<ResponseField name="model" type="string" required>
  מודל ה-AI שעליו הסוכן רץ. השתמש ב-`automatic` כדי לתת ל-Base44 לבחור מודל. לחלופין, הגדר מזהה מוגדר מראש מרשימת [המודלים הנתמכים](/he/developers/backend/resources/models), לדוגמה `claude-sonnet-5` או `gpt_6_sol`.

  מזהים מוגדרים מראש שהוצאו משימוש ו-Base44 עדיין מזהה משודרגים אוטומטית לחלופה עדכנית.
</ResponseField>

### שדות אופציונליים

<ResponseField name="tool_configs" type="array">
  כלים שהסוכן יכול להשתמש בהם כדי לפעול מול האפליקציה. ראה [תצורת
  כלים](#tool-configuration).
</ResponseField>

<ResponseField name="whatsapp_greeting" type="string">
  הודעת פתיחה לשיחות WhatsApp עם הסוכן.
</ResponseField>

<ResponseField name="selected_skill_names" type="array">
  שמות [כישורי הסוכן](/he/developers/backend/resources/agents/agent-skills)
  שמצורפים לסוכן. עד 10 כישורים לכל סוכן.
</ResponseField>

## תצורת כלים

המערך `tool_configs` מגדיר את היכולות של הסוכן. יש שני סוגים: **כלי ישויות** ו**כלי פונקציות**.

### כלי ישויות

כלי ישויות מאפשרים לסוכן לבצע פעולות CRUD על [הישויות](/he/developers/backend/resources/entities/overview) של האפליקציה.

<ResponseField name="entity_name" type="string" required>
  שם הישות. חייב להתאים לישות קיימת באפליקציה.
</ResponseField>

<ResponseField name="allowed_operations" type="array" required>
  הפעולות שהסוכן יכול לבצע על הישות. הערכים החוקיים הם `"read"`,
  `"create"`, `"update"` ו-`"delete"`.
</ResponseField>

### כלי פונקציות

כלי פונקציות מאפשרים לסוכן להפעיל את [פונקציות הבקאנד](/he/developers/backend/resources/backend-functions/overview) של האפליקציה.

<ResponseField name="function_name" type="string" required>
  שם הפונקציה. חייב להתאים לפונקציה קיימת באפליקציה.
</ResponseField>

<ResponseField name="description" type="string" required>
  תיאור של מה שהפונקציה עושה. הסוכן משתמש בתיאור כדי להחליט מתי
  לקרוא לה.
</ResponseField>

## טיפוסי TypeScript

צור טיפוסי TypeScript מתצורות הסוכנים. כך תקבל בטיחות טיפוסים והשלמה אוטומטית לשמות הסוכנים בקוד ה-SDK. מידע נוסף זמין ב[טיפוסים דינמיים](/he/developers/references/sdk/getting-started/dynamic-types).

## ראה גם

* [`agents pull`](/he/developers/references/cli/commands/agents-pull): סנכרון תצורות סוכנים מ-Base44 לפרויקט המקומי
* [`agents push`](/he/developers/references/cli/commands/agents-push): פריסת תצורות הסוכנים המקומיות ל-Base44
* [כישורי סוכנים](/he/developers/backend/resources/agents/agent-skills): הגדרת סטים של הנחיות לשימוש חוזר עבור הסוכנים
* [`agents`](/he/developers/references/sdk/docs/interfaces/agents): מדריך ה-SDK לעבודה עם סוכנים בקוד
* [הגדרת סוכני AI](/he/Building-your-app/AI-agents-for-apps): מדריך ליצירה ולהגדרה של סוכני AI

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


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