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

# על Agents

> הגדר סוכני 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="/Building-your-app/AI-agents-for-apps">הגדרת סוכן AI</a>.
    </div>
  </div>
</div>

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

## יצירת agents

צור קבצי תצורה JSONC בתיקיית `base44/agents/` שלך (קובץ אחד לכל agent), ואז הרץ [`agents push`](/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": "anthropic/claude-sonnet-4-20250514",
  "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?",
}
```

## סימוכין שדות

תצורות סוכן משתמשות ב-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>
  System prompt המגדיר את התנהגות הסוכן, האישיות שלו וההנחיות.
</ResponseField>

<ResponseField name="model" type="string" required>
  מודל ה-AI לשימוש, בפורמט `provider/model-name`.

  מודלים נתמכים:

  * `anthropic/claude-sonnet-4-20250514`
  * `anthropic/claude-3-5-sonnet-20241022`
  * `openai/gpt-4o`
  * `openai/gpt-4o-mini`
</ResponseField>

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

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

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

## תצורת כלים

המערך `tool_configs` מגדיר אילו יכולות יש לסוכן שלך. יש שני סוגים: **entity tools** ו-**function tools**.

### Entity tools

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

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

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

### Function tools

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

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

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

## TypeScript types

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

## ראה גם

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

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