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

# Az ügynökökről

> MI-ügynökök definiálása helyi konfigurációs fájlokkal

Ön a fejlesztői dokumentációt nézi

Ez a dokumentáció a Base44 fejlesztői platformmal dolgozó fejlesztőknek szól. Az alkalmazásszerkesztőben használható MI-ügynökökről az [MI-ügynök beállítása](https://docs.base44.com/hu/Building-your-app/AI-agents-for-apps.md) oldalon olvashat.

Az [MI-ügynökök](https://docs.base44.com/hu/Building-your-app/AI-agents-for-apps.md) testreszabható MI-asszisztensek, amelyek műveleteket hajtanak végre, és eszközökhöz csatlakoznak, hogy segítsék a csapattagokat és a végfelhasználókat. Az ügynök viselkedését, jogosultságait és eszközeit helyi JSONC-konfigurációs fájlokkal határozhatja meg.

## Ügynökök létrehozása

Hozzon létre JSONC-konfigurációs fájlokat a `base44/agents/` könyvtárban (ügynökönként egy fájlt), majd futtassa az [`agents push`](https://docs.base44.com/developers/references/cli/commands/agents-push) parancsot a Base44-gyel való szinkronizáláshoz.

## Példa

```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"],
}
```

## Mezőreferencia

Az ügynökkonfigurációk JSONC formátumúak. Minden ügynök külön fájlban van definiálva a `base44/agents/` könyvtárban.

### Kötelező mezők

**name** `string` *required*

Az ügynök egyedi azonosítója. Kisbetűket és aláhúzásjeleket használjon. A
névnek egyeznie kell a fájlnévvel, így a `customer_support` nevű ügynök
a `customer_support.jsonc` fájlban található.

**description** `string` *required*

Rövid leírás arról, mit csinál az ügynök.

**instructions** `string` *required*

Rendszerprompt, amely meghatározza az ügynök viselkedését, személyiségét és irányelveit.

**model** `string` *required*

Az MI-modell, amelyen az ügynök fut. Az `automatic` értékkel a Base44 választ modellt, vagy megadhat egy előbeállítás-azonosítót a [támogatott modellek](https://docs.base44.com/hu/developers/backend/resources/models.md) listájából, például `claude-sonnet-5` vagy `gpt_6_sol`.

A kivezetett, de a Base44 által még felismert előbeállítás-azonosítók automatikusan egy aktuális helyettesítő modellre frissülnek.

### Nem kötelező mezők

**tool\_configs** `array`

Eszközök, amelyekkel az ügynök az alkalmazással dolgozhat. Lásd: [Eszközök
konfigurálása](#tool-configuration).

**whatsapp\_greeting** `string`

Üdvözlő üzenet az ügynökkel folytatott WhatsApp-beszélgetésekhez.

**selected\_skill\_names** `array`

Az ügynökhöz kapcsolt [ügynökskillek](https://docs.base44.com/hu/developers/backend/resources/agents/agent-skills.md)
nevei. Ügynökönként legfeljebb 10 skill.

## Eszközök konfigurálása

A `tool_configs` tömb határozza meg, milyen képességei vannak az ügynöknek. Három típus létezik: **entitáseszközök**, **függvényeszközök** és **szerverútvonal-eszközök**.

### Entitáseszközök

Az entitáseszközökkel az ügynök CRUD-műveleteket végezhet az alkalmazás [entitásain](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md).

**entity\_name** `string` *required*

Az entitás neve. Egyeznie kell az alkalmazás egy meglévő entitásával.

**allowed\_operations** `array` *required*

Az ügynök által az entitáson végezhető műveletek. Érvényes értékek: `"read"`,
`"create"`, `"update"` és `"delete"`.

### Függvényeszközök

A függvényeszközökkel az ügynök meghívhatja az alkalmazás [backend-függvényeit](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md).

**function\_name** `string` *required*

A függvény neve. Egyeznie kell az alkalmazás egy meglévő függvényével.

**description** `string` *required*

Leírás arról, mit csinál a függvény. Az ügynök ez alapján dönti el, mikor
hívja meg.

### Szerverútvonal-eszközök

A szerverútvonal-eszközökkel az ügynök egy full-stack alkalmazás saját szerverútvonalait hívhatja meg. Az eszköz hívásakor lekérdezési paramétereket adhat át, a `get` kivételével pedig JSON-kéréstörzset is.

```jsonc theme={null}
"tool_configs": [
  {
    "tool_name": "order_summary",
    "route_path": "/api/orders/summary",
    "method": "get",
    "description": "Summarizes the customer's recent orders",
  },
],
```

**tool\_name** `string` *required*

A név, amellyel az ügynök az eszközt hívja. 1–64 betűt, számjegyet, aláhúzásjelet
vagy kötőjelet használhat.

**route\_path** `string` *required*

A szerverútvonal alkalmazáson belüli útvonala, például `/api/orders/summary`. Egyetlen
`/` jellel kell kezdődnie, legfeljebb 2000 karakter lehet, és nem tartalmazhat
lekérdezési karakterláncot vagy fragmentet.

**method** `string`

Az útvonal hívásához használt HTTP-metódus. Érvényes értékek: `"get"`, `"post"`,
`"put"`, `"patch"` és `"delete"`. Alapértelmezett érték: `"post"`.

**description** `string`

Mit csinál az útvonal, mikor kell használni, és milyen bemenetet vár. Az ügynök
ez alapján dönti el, mikor hívja meg. Alapértelmezett érték: `"agent server route"`.

## TypeScript-típusok

Generáljon TypeScript-típusokat az ügynökkonfigurációkból, hogy típusbiztonságot és automatikus kiegészítést kapjon az ügynöknevekhez az SDK-kódban. További információ a [dinamikus típusokról](https://docs.base44.com/developers/references/sdk/getting-started/dynamic-types.md).

## Lásd még

* [`agents pull`](https://docs.base44.com/developers/references/cli/commands/agents-pull): Ügynökkonfigurációk szinkronizálása a Base44-ből a helyi projektbe
* [`agents push`](https://docs.base44.com/developers/references/cli/commands/agents-push): A helyi ügynökkonfigurációk telepítése a Base44-re
* [Ügynökskillek](https://docs.base44.com/hu/developers/backend/resources/agents/agent-skills.md): Újrahasználható utasításkészletek definiálása az ügynökökhöz
* [`agents`](https://docs.base44.com/developers/references/sdk/docs/interfaces/agents): SDK-referencia az ügynökökkel való munkához a kódban
* [MI-ügynökök beállítása](https://docs.base44.com/hu/Building-your-app/AI-agents-for-apps.md): Útmutató MI-ügynökök létrehozásához és konfigurálásához

> [!NOTE]
>
> Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az [angol nyelvű változatot](https://docs.base44.com/index.md).


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