---
title: "Beépített eszközök"
description: "Utasítsa a ThunderPhone ügynökeit a hívások befejezésére, a hívók átirányítására, a billentyűzetek használatára, várakoztatásra, tudásanyagok keresésére, hangok lejátszására és e-mailek küldésére."
---

A beépített eszközök lehetővé teszik, hogy egy ügynök gyakori hívásműveleteket
végezzen el saját API csatlakoztatása nélkül. A legtöbb automatikusan elérhető;
az e-mail, a hangok és a tudáskeresés csak a kapcsolódó beállítás vagy forrás
konfigurálása után jelenik meg. Az ügynök promptjában adja meg, mikor használja az egyes műveleteket.

| Eszköz | Használat | Engedélyezés | Támogatott hívások |
| --- | --- | --- | --- |
| `end_call` | Befejezett beszélgetés lezárása | Mindig elérhető | Telefon, böngészős Talk, widget, szimuláció és Realtime |
| `transfer_call` | Telefonos hívó átirányítása | Állítsa be az átirányítást a promptban | Hagyományos telefonhívások; a `call_events` eseményekkel rendelkező beágyazott Realtime használhat hideg átirányítást. A mentett ügynökös Realtime nem tartalmazza. |
| `send_keypad_input` | Gombok megnyomása telefonos menüben | Hagyományos telefonhívásoknál mindig elérhető | Telefonhívások; `call_events` eseményekkel rendelkező beágyazott kimenő Realtime. A mentett ügynökös Realtime nem tartalmazza. |
| `no_response` | További hallgatás, miközben egy automatizált menü beszél vagy a hívó hangosan gondolkodik; ha a hívó arra kéri az ügynököt, hogy várjon, csak „Rendben.” választ kap | Mindig elérhető | Minden hívástípus |
| `wait_on_hold` | Várakozás csendben, amíg egy személy visszatér | Kimenő hívások esetén elérhető | Kimenő telefonhívások és kimenő beágyazott Realtime-munkamenetek |
| `search_knowledge_base` | Válaszadás csatolt források alapján | Csatoljon tudásforrásokat az ügynökhöz | Csatolt tudásforrásokkal rendelkező mentett ügynökös hívások |
| `play_sound` | Konfigurált értesítési hang lejátszása | **Speciális → Eszközhang** | Mentett ügynökös hívások |
| `send_email` | E-mail küldése egy rögzített címzettnek | **Speciális → E-mail küldése** | Mentett ügynökös hívások |

## `end_call`

Lezárja az aktuális hívást, amikor a prompt erre utasítja a modellt. Alapértelmezés szerint elérhető, és nincs ügynökbeállítása.

Írja a feltételt és az esetlegesen szükséges elköszönést a promptba:

```text
When the caller confirms they need nothing else, say goodbye and end the call.
```

Egy modell által befejezett hívás `end_reason: "ai_hangup"` értéket kap, beleértve azt is, amely a hívásidő-korlátra vonatkozó figyelmeztetés után ér véget. A hívás csak akkor ér véget `max_duration` értékkel, ha előbb eléri az időkorlátot, és `balance_exhausted` értékkel, ha az előre feltöltött egyenleg elfogy.

## `transfer_call`

Telefonáló átirányítása a modell által megadott rögzített számra. A hideg átirányítás azonnali. A szűrt meleg átirányítás a felek összekapcsolása előtt privát módon felhívja a célállomást. A meleg átirányításhoz ellenőrzött, importált VoIP-szám szükséges, amely képes kimenő hívásokat kezdeményezni.

Adja meg a célállomás számát és a pontos útválasztási feltételt a promptban:

```text
If the caller asks for billing, transfer them to +15551234567.
```

A sikeres hideg átirányítás `end_reason: "ai_transfer"` értékkel rendelkezik; a befejezett meleg átadás `end_reason: "ai_warm_transfer"` értékkel rendelkezik. Sikertelen meleg kísérlet esetén a vezérlés visszakerül az ügynökhöz, ezért a hívás későbbi lezárása határozza meg a lezárási okát. Nem telefonos munkamenetekben az átirányítási kérés ehelyett lezárja a munkamenetet.

A kezelőfelületi és API-beállításokról, útválasztásról, szűrésről, hibakezelésről, korlátokról és tesztelésről lásd a [Hívások átirányítása](/hu/guides/call-transfers) útmutatót.

## `send_keypad_input`

DTMF (telefonbillentyűzet) számjegyeket (`0`–`9`, `*` és `#`) küld egy telefonvonalra. A modell ezt IVR-ben, vagyis abban az automatizált menüben való navigálásra használja, amely arra kéri a hívókat, hogy gombokat nyomjanak meg. Alapértelmezés szerint elérhető, és nincs ügynökbeállítása.

Mondja meg a modellnek, mely menükben navigálhat, és honnan származnak a kért értékek. Ne kérje meg, hogy találgassa a menüopciókat:

```text
Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.
```

A platform eltávolítja a nem támogatott karaktereket, és a megfelelő számjegyeket sorrendben küldi el. Ha nem marad megfelelő számjegy, vagy a hívás nem tud billentyűzetbemenetet küldeni, a rendszer visszaadja a hibát az ügynöknek, hogy helyreállhasson.

## `no_response`

Csendben tartja az AI-ügynököt, amíg egy automatizált rendszer még beszél vagy arra kéri, hogy tovább figyeljen, illetve amíg a hívó hangosan gondolkodik („ööö, hadd nézzem”) vagy valaki máshoz fordul beszélni. Amikor a hívó arra kéri az AI-ügynököt, hogy várjon, amíg valamit elintéz („egy pillanat”, „hadd ellenőrizzem”, „tud várni egy pillanatot?”), és nem ad más megválaszolandó információt, az AI-ügynök csak annyit mond: „Rendben.” (nem azt, hogy „Nyugodtan, ráér.”), majd megvárja, amíg a hívó ismét megszólal. Az AI-ügynök csend közbeni visszakérdezései továbbra is működnek, és mindig elhangzanak, ha a vonal csendben marad. Ez nem élő
személy üdvözlésére, kérdésére vagy tényleges várakoztatási sorra szolgál. Alapértelmezés szerint elérhető,
és nincs hozzá AI-ügynök-beállítás.

Ha a prompt meghatározza, mit mondjon az AI-ügynök, amikor a hívó egy pillanatot kér, a
prompt élvez elsőbbséget.

Általában elegendő a beépített leírás. Sok IVR-t használó hívásoknál erősítse meg a határt a promptban:

```text
Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.
```

Ez a művelet nem zárja le a hívást.

## `wait_on_hold`

Csendes várakoztatási állapotba helyez egy kimenő hívásban működő ügynököt, amíg egy élő személy vissza nem tér.
A modell csak akkor használja, miután a másik fél kifejezetten közölte, hogy várakoztatásba helyezi az ügynököt. Kimenő hívásoknál automatikusan elérhető, és nincs hozzá irányítópulti beállítás.

```text
If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.
```

Ne utasítsa az ügynököt arra, hogy IVR „kérem, várjon” üzenetéhez használja. A várakoztatás alapértelmezés szerint legfeljebb 15 percig tart. Normál kimenő hívásoknál a `POST /v1/call` pozitív egész `max_hold_seconds` értéket fogad el; a beágyazott Realtime a `max_hold_seconds` értékét 10–900 másodpercre korlátozza. Ha a személy visszatér, az ügynök a hívás befejezési okának módosítása nélkül folytatja. Ha a korlát lejár, a platform a következővel fejezi be a hívást: `end_reason: "ai_hangup"`.

## `search_knowledge_base`

Megkeresi az ügynökhöz csatolt dokumentumokat, és releváns részleteket ad vissza. Csatoljon tudásbázist vagy különálló tudásdokumentumokat az engedélyezéséhez, majd mondja meg a modellnek, mely válaszoknak kell ezekből a forrásokból származniuk:

```text
Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.
```

Ha a keresés sikertelen, az eredmény visszakerül az ügynökhöz. Az irányítópulti és API-beállításokról lásd: [Tudásbázis](/hu/guides/knowledge-base).

## `play_sound`

Az ügynök konfigurált értesítési hangját játssza le ugyanabban a körben elhangzott bármely beszéd után. Az irányítópulton állítsa a **Speciális → Eszközhang** értékét **Chime**, **Ding** vagy **Beep** értékre, majd telepítse az ügynököt. A **Nincs** eltávolítja az eszközt.

Az [Agents API](/api-reference/agents) használatával állítsa a `play_sound_asset` értékét `"chime"`, `"ding"` vagy `"beep"` értékre, majd telepítse. Az eszköz letiltásához állítsa `""` értékre.

```text
After confirming that an appointment was saved, say "You're all set" and play
the notification sound.
```

A lejátszási hiba visszakerül az ügynökhöz, és nem fejezi be a hívást.

## `send_email`

Egyszerű szöveges e-mailt küld az ügynök tulajdonosa által konfigurált egyetlen címzettnek. A modell adja meg a tárgyat és a törzset. Soha nem lát címzettparamétert, és nem választhatja ki vagy módosíthatja a címet.

Az irányítópulton engedélyezze a **Speciális → E-mail küldése** lehetőséget, mentsen egy címzettcímet, majd telepítse az ügynököt. Az [Agents API](/api-reference/agents) használatával állítsa be a `send_email_enabled: true` értéket és egy nem üres `send_email_recipient` értéket, majd telepítse. Határozza meg a promptban az eseményindítót és a kötelező tartalmat:

```text
When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.
```

Egy hívás legfeljebb három e-mail-küldést kísérelhet meg. Minden tárgy legfeljebb 300 karakterből, minden törzs pedig legfeljebb 20 000 karakterből állhat. A hiányzó konfiguráció, az érvénytelen tartalom, a hívásonkénti korlát és a kézbesítési hibák visszakerülnek az ügynökhöz. A sikertelen kézbesítés is felhasznál egyet a három kísérletből.

Széles körű telepítés előtt teszteljen ellenőrzött címzettel. A böngészős Talk és a szimulációk valódi e-mailt küldenek; nincs próbaüzemi mód.

## Kompatibilitási megjegyzés

A **Speciális → Megszakíthatatlan tájékoztatások** beállítás és a régi `speak_uninterruptible_enabled` mező kompatibilitási okokból megmarad, de engedélyezésüknek nincs hatása. Hagyja kikapcsolva a beállítást; egyetlen prompt sem aktiválhatja ezt az eszközt.

Kötelező, hívásnyitó tájékoztatóhoz használja a **Hozzájárulási közlemény** lehetőséget. Ez szó szerint lejátszásra kerül a normál beszélgetés előtt, és nem szakítható meg. Lásd: [Hívásrögzítési hozzájárulásra vonatkozó jogszabályok](/hu/guides/recording-consent-laws).

## Beépített eszközök tesztelése és figyelése

A promptok, a tudásbázis-keresés, a hangok és az e-mail ellenőrzéséhez használja a böngészős Talkot vagy egy szimulációt. Ezek a környezetek nem képesek reprodukálni a telefonhálózati viselkedést. A billentyűzetes navigációt és a várakoztatást kimenő telefonhívásban tesztelje, és egy teljes meleg átadást is teszteljen valódi hívásban, megfelelő importált VoIP-szám használatával. A Realtime támogatása a fenti táblázatban látható módon korlátozott.

## Hívások, díjszabás és webhookok

A beépített műveletek használatánkénti eszközdíj nélkül érhetők el. A szokásos hívás- és szolgáltatói díjak
továbbra is érvényesek; lásd: [Díjszabás](/hu/guides/pricing). Hívásaik és eredményeik
megjelenhetnek a befejezett átiratban, de nem küldenek `telephony.tool` vagy `web.tool`
eseményeket. Ezek az események a [felhasználó által definiált függvényekhez](/hu/tools/overview) tartoznak. Csak a befejezett
bontás vagy átirányítás módosítja a hívás `end_reason` értékét; az egyéb hibák az AI-ügynökhöz kerülnek vissza. A hívási
rekordért lásd a [Befejezési webhookok](/hu/webhooks/call-complete) oldalt.