> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Alapfogalmak
> A platform összes elemének áttekintése — mit csinál az egyes objektum, hol található a vezérlőpulton, és melyik API kezeli.
A ThunderPhone egy teljes körű platform hangalapú AI-ügynökök létrehozásához, futtatásához és fejlesztéséhez. Ez az oldal az áttekintő térkép: minden fogalom, amellyel találkozni fog, egy-egy rövid szakaszban, a vezérlőpult megfelelő felületével és az azt támogató API-val. Fusson át rajta egyszer, majd térjen vissza, amikor egy fogalmat részletesebben kell értelmeznie.
A vezérlőpult oldalsávja ezt a struktúrát követi:
[Ügynökök](#agents), [telefonszámok](#phone-numbers),
[webes widgetek](#web-widgets), [hívások](#calls),
[tudásbázisok](#knowledge-bases).
[Élő monitorozás](#live-monitoring) és kimenő
[kampányok](#campaigns).
[Alkalmazások, API-k, MCP-szerverek és VoIP-szolgáltatók](#connections), amelyeket az
ügynökei használhatnak.
[Szimulációk](#simulations), [kísérletek](#experiments),
[problémák](#issues), [jelentések](#reports),
[megfigyelhetőség](#observability).
[Csapat és szerepkörök](#team-and-roles), [API-kulcsok](#organizations),
[riasztások](#alerts), [számlázás](#billing).
[Webhookok](#webhooks) és [függvényeszközök](#function-tools) a
saját kódjához.
***
## Szervezetek
A **szervezet** a bérlői egység. Minden más erőforrás —
ügynökök, telefonszámok, hívások, kulcsok — pontosan egy szervezethez tartozik. Az Ön
fiókja több szervezethez is tartozhat; mindegyik saját egyenleggel, saját
kulcsokkal és saját taglistával rendelkezik.
A **Szervezet → Kulcsok** alatt létrehozott `sk_live_` API-kulcs
egy szervezethez van kötve. Ez a kötés teszi a REST API-t ennyire
egyszerűvé: soha nem kell szervezeti azonosítót megadnia az URL-útvonalakban, mert a kulcsa
már azonosítja azt.
**A vezérlőpulton:** a szervezetváltó (az oldalsáv láblécében) és a
**Szervezet** beállításai — Általános, Kulcsok, Riasztások, Számlázási
beállítások és Számlázási előzmények lapok.
**Az API-ban:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Ügynökök
Az **ügynök** az a mesterségesintelligencia-konfiguráció, amely egy hívást kezel. Tartalma:
* Egy **prompt**, amely meghatározza, mit mond az ügynök és hogyan viselkedik —
beleértve az olyan hívásműveleteket, mint az átirányítások, a billentyűzetnyomások és a hívásbontások,
amelyek külön konfiguráció helyett egyszerű prompthivatkozások.
* Egy **motorcsomag** (`spark`, `bolt`, `storm-*`): a Spark költséghatékonyságra,
a Bolt sebességre, a Storm pedig összetett promptok esetén intelligenciára van optimalizálva.
* Egy **hang**, valamint egy **elsődleges nyelv** és opcionális **további
nyelvek** — az ügynök automatikusan vált, amikor a hívó nyelvet
vált. Lásd: [Támogatott nyelvek](/hu/guides/supported-languages).
* Csatolt képességek: [csatlakoztatott alkalmazások](#connections),
[API-kapcsolatok](#connections), [tudásbázisok](#knowledge-bases),
[MCP-szerverek](#connections) és beágyazott
[függvényeszközök](#function-tools).
* Viselkedési beállítások: beszédsorrend, visszaigazolási mód, háttérhang,
várakoztatási időkorlát.
A szerkesztőben végzett módosítások **automatikusan piszkozatba mentődnek**; semmi sem kerül élesbe, amíg
nem kattint a **Telepítés** gombra. Minden telepítés pillanatfelvételként mentésre kerül a szerkesztő
**Előzmények** lapján, így bármely korábbi verziót megvizsgálhat és visszaállíthat.
**A vezérlőpulton:** **Hangalapú AI-ügynökök** → az ügynökszerkesztő
(`/dashboard/agents`). Lásd:
[Az első hangalapú AI-ügynök létrehozása](/hu/guides/build-an-agent).
**Az API-ban:** [`/v1/agents`](/api-reference/agents) — CRUD,
duplikálás, átirányítás, verzióelőzmények és promptsegédletek.
***
## Telefonszámok
Egy **telefonszám** egy szervezethez tartozik, és a bejövő hívásokat egy
ügynökhöz irányítja (valamint kimenő hívásokat is kezelhet). Két forrás áll rendelkezésre:
* **Demószámok** — valódi amerikai számok, amelyeket a ThunderPhone
készletéből biztosítunk, és másodpercek alatt aktiválódnak. Csak bejövő
hívásokhoz használhatók, rövid szóbeli tájékoztatóval fogadják a hívásokat,
és a vezérlőpult szervezetenként legfeljebb 10-et engedélyez belőlük. Első
teszteléshez ideálisak; éles használatra nem.
* **VoIP-számok** — saját szolgáltatótól hozhatók be egy
[VoIP-kapcsolaton](#connections) keresztül. A Twilio és a Telnyx közvetlenül
csatlakozik (a Telnyx irányított beállítást kínál); a SignalWire és a Vonage
hamarosan érkezik — jelenleg manuális SIP-konfiguráción keresztül érheti el
őket, amely bármilyen SIP-trunköt elfogad. Az importálás és ellenőrzés után
a VoIP-számok támogatják a bejövő és kimenő hívásokat is.
Minden szám sora lehetővé teszi az útválasztási mód beállítását, a bejövő
hívásokat kezelő ügynök kiválasztását és a szám címkézését.
**A vezérlőpulton:** **Telefonszámok** (`/dashboard/phone-numbers`).
Lásd: [Telefonszám beszerzése](/hu/guides/get-a-phone-number).
**Az API-ban:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).
***
## Hívások
Minden bejövő hívás, kimenő hívás, szimuláció és widgetmunkamenet
**hívásnaplóvá** válik. Egy hívás tartalmazza a teljes, szerepkörjelölésekkel
ellátott leiratot, a strukturált fordulóelőzményeket (beleértve az
eszközhívásokat), a felvételt, a számlázási végösszeget, valamint az opcionális
AI-alapú értékelési és problémariportokat.
Amíg egy hívás **élő**, megnyithatja és **belehallgathat** — Ön némán
csatlakozik, és a hívásban részt vevők nem hallják Önt. Belehallgatás közben
**súghat** is: írjon be egy utasítást, amely hívás közben közvetlenül az
ügynökéhez kerül; a hívó fél ezt soha nem hallja, az ügynök pedig valós időben
követi.
**A vezérlőpulton:** **Híváselőzmények** (`/dashboard/call-history`) az
archívumhoz és a hívásonkénti részletekhez; **Élő** a folyamatban lévő
hívásokhoz. Lásd:
[Hívások áttekintése, belehallgatás és iránymutatás](/hu/guides/review-calls).
**Az API-ban:** [`/v1/calls`](/api-reference/calls) — lista, leirat,
előzmények, hanganyag, értékelés, exportálás;
[`/v1/issue-reports`](/api-reference/issue-reports).
***
## Webes widgetek
A **webes widget** mikrofonalapú beszélgetést biztosít webhelye látogatóinak
egy ügynökkel — nincs szükség telefonszámra. Egy **publikálható kulccsal**
(`pk_live_...`) hitelesít, amely kizárólag az engedélyezett domainekről
használható, ezért biztonságosan alkalmazható kliensoldali kódban.
A kulcsok két mód egyikében működnek: `agent` (statikusan egy ügynökhöz kötve)
vagy `webhook` (a szervere látogatónként választja ki a konfigurációt — lásd:
[Dinamikus hívásonkénti konfiguráció](/hu/guides/dynamic-call-config)). A widget-
munkamenetek ugyanazon a hívásinfrastruktúrán keresztül működnek, mint a
telefonhívások.
**A vezérlőpulton:** **Webes widgetek** (`/dashboard/web-widgets`) —
hozzon létre widgeteket, állítsa be a módot és az ügynököt, kezelje az
engedélyezett domaineket, és másolja ki a beágyazási kódrészletet. Lásd:
[Webes widget létrehozása](/hu/guides/embed-a-web-widget-dashboard).
**Az API-ban:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions), valamint a
[Widget SDK dokumentációja](/hu/widget/overview).
***
## Tudásbázisok
A **tudásbázis** olyan dokumentumok gyűjteménye, amelyekben ügynöke hívás
közben kereshet, hogy megalapozza válaszait — töltsön fel fájlokat közvetlenül,
vagy importáljon a Google Drive-ból, majd kapcsolja a tudásbázist egy
ügynökhöz a szerkesztőben. Az ügynök a beépített keresőeszközzel kérdezi le,
amikor a beszélgetés ezt igényli.
**A vezérlőpulton:** **Tudás** (`/dashboard/knowledge`) a dokumentumtárhoz;
a szerkesztő **Tudás** szakasza egy tudásbázis ügynökhöz kapcsolásához. Lásd:
[Adjon tudásbázist az ügynökének](/hu/guides/knowledge-base).
***
## Kapcsolatok
A kapcsolatok révén érik el az ügynökök a külvilágot. Négy típus, egy
oldalsáv-csoport:
* **Alkalmazások** (`/dashboard/app-connections`) — OAuth-kapcsolatok a
Slackhez, HubSpothoz, Salesforce-hoz, Google Calendarhoz, Google Sheetshoz
és Cal.comhoz. Csatlakoztassa őket egyszer, majd kapcsolja be műveletenként
az eszközöket (Slack-üzenet küldése, HubSpot-kapcsolat létrehozása vagy
frissítése, Cal.com-időpont foglalása…) bármely ügynökhöz. Lásd:
[Alkalmazások csatlakoztatása](/hu/guides/connect-apps).
* **API-k** (`/dashboard/api-connections`) — alakítson bármely HTTP API-t
ügynökműveletté. Illesszen be egy cURL-parancsot, és az AI-varázsló
elkészíti az eszköz definíciójának vázlatát, vagy hozza létre kézzel; a
**Tesztkérés** gomb élesítés előtt tesztkörnyezetbeli hívást indít. Lásd:
[API-kapcsolatok](/hu/guides/api-connections) — a
[`/v1/integrations`](/api-reference/integrations) irányítópulti felülete.
* **MCP** (`/dashboard/mcp-connections`) — adjon hozzá URL alapján egy Model
Context Protocol-szervert, és engedje, hogy az ügynök használja az általa
biztosított eszközöket. Lásd: [MCP-szerver hozzáadása](/hu/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — szolgáltatói hitelesítő adatok a
[saját telefonszámok használatához](#phone-numbers). Lásd:
[VoIP-szolgáltató csatlakoztatása](/hu/guides/voip-providers).
**Az API-ban:** [`/v1/integrations`](/api-reference/integrations) és
[`/v1/voip-connections`](/api-reference/voip-connections); lásd még:
[Eszközintegráció létrehozása](/hu/guides/build-tool-integration).
***
## Kampányok
Egy **kampány** nagy léptékben indít kimenő hívásokat: töltsön fel egy
névjegyeket tartalmazó CSV-fájlt, válassza ki az ügynököt és a hívószámot,
majd állítsa be a hívási időablakot (napok és órák, időzónakezeléssel), a
párhuzamosságot és az újrapróbálkozási szabályzatot (a próbálkozások maximális
száma és az újrapróbálkozást kiváltó kimenetek — nincs válasz, hangposta,
sikertelen). A kampány végighalad a listán, és minden hívást rögzít a
Híváselőzményekben.
**Az irányítópulton:** **Kampányok** (`/dashboard/campaigns`). Lásd:
[Kimenő hívási kampány futtatása](/hu/guides/outbound-campaigns).
**Egyszeri, programozott hívásokhoz:** a
[kimenő hívások API-ja](/hu/guides/place-outbound-calls).
***
## Élő monitorozás
Az **Élő** nézet a szervezeten belüli összes folyamatban lévő hívást mutatja,
és lehetővé teszi bármelyik megnyitását, hogy [valós időben belehallgathasson
és súghasson](#calls). Ez a felügyeleti felület: figyelje, ahogy egy új prompt
megkapja az első valós forgalmát, vagy tartsa szemmel a futó kampányt.
**Az irányítópulton:** **Élő** (`/dashboard/live`). Lásd:
[Élő hívások figyelése és felügyelete](/hu/guides/monitor-live-calls).
***
## Szimulációk
Egy **szimuláció** során egy AI-hívó valós beszélgetést folytat az Ön
ügynökével — ugyanazon a telefonos útvonalon, valós leirattal és valós
értékeléssel —, így élesítés előtt (és után) is tesztelhet. Irányítsa egy
ügynökre vagy telefonszámra, írja meg saját maga a hívói forgatókönyvet, vagy
**generáljon forgatókönyveket AI-val** az ügynök promptja alapján (kérésre a
szélsőséges eseteket is beleértve), majd kövesse élőben a hívást.
A forgatókönyvek **csomagokba** rendezhetők, amelyek minimális sikerességi
arányt rögzítenek, és a CI-ben korlátozhatják a kiadásokat; az elfogadott
alapállapothoz viszonyított regressziók forgatókönyvenként jelennek meg.
**Az irányítópulton:** **Szimulációk** (`/dashboard/simulations`), valamint az
ügynökszerkesztőben található **Szimuláció** gomb. Lásd:
[Hívás szimulálása](/hu/guides/simulate-a-call).
**Az API-ban:** [`/v1/test-calls`](/api-reference/test-calls) és a
csomagfuttató — lásd: [Ügynök teljes körű tesztelése](/hu/guides/test-agents).
***
## Kísérletek
Egy **kísérlet** A/B-teszteli az ügynökkonfigurációkat élő forgalomban:
határozzon meg változatokat (eltérő promptokat, motorokat vagy beállításokat),
ossza fel közöttük a forgalmat, és hasonlítsa össze a változatonkénti
eredményeket. Használja ezt a webhookban kézzel kialakított bucketlogika
helyett.
**Az irányítópulton:** **Kísérletek** (`/dashboard/experiments`) és az
ügynökszerkesztő **A/B** lapja. Lásd:
[Kísérletek (A/B-tesztelés)](/hu/guides/experiments-ab-testing).
***
## Hibák
A **hiba** egy adott híváson megjelölt probléma — emberi
ellenőr rögzítheti, vagy az AI-alapú értékelés észlelheti. A hibákhoz
súlyosság, forrás és állapot tartozik, a Hibák oldal pedig a
triázs várólista: szűrje, vizsgálja meg az érintett hívást, és kövesse
nyomon a javításokat.
**A vezérlőpulton:** **Hibák** (`/dashboard/issues`), valamint hívásonkénti
jelölés a Híváselőzményekben. Lásd: [Hibák triázsa](/hu/guides/issues).
**Az API-ban:** [`/v1/issue-reports`](/api-reference/issue-reports).
***
## Jelentések
Egy **jelentés** az Ön hívásadataira vonatkozó, természetes nyelven
feltett kérdésre („Mi volt a három leggyakoribb ok, amiért a hívók
emberi ügyintézőt kértek a múlt héten?”) AI által készített elemzéssel
válaszol, az Ön által kiválasztott ügynökökre és dátumtartományra
szűkítve.
**A vezérlőpulton:** **Jelentések** (`/dashboard/reports`). Lásd:
[Jelentések](/hu/guides/reports).
***
## Megfigyelhetőség
A **megfigyelhetőség** a metrikák felülete: hívásmennyiség, kimenetelek
és minőség időbeli alakulása, ügynök és időablak szerint szűrhető,
valamint exportálható további elemzéshez.
**A vezérlőpulton:** **Megfigyelhetőség** (`/dashboard/observability`).
Lásd: [Megfigyelhetőség](/hu/guides/observability).
***
## Riasztások
Egy **riasztási szabály** egy metrikát (sikerességi arány, hibaarány,
átlagos pontszám, hívásmennyiség, tesztcsomag-regressziók) figyel egy
időablakban, és akkor aktiválódik, amikor az átlépi az Ön küszöbértékét.
Az értesítések e-mailben és Slackben érkeznek, és kiváltanak egy
`alert.triggered` eseményt az Ön
[webhookvégpontjain](/hu/webhooks/endpoints).
**A vezérlőpulton:** **Szervezet → Riasztások**. Lásd:
[Riasztások](/hu/guides/alerts).
***
## Webhookok
A ThunderPhone **HTTP POST webhookokat** küld az Ön szerverére, amikor
események történnek egy hívás közben vagy után. Két kézbesítési modell
érhető el:
* **Webhookvégpontok** (ajánlott): több URL kezelése a
[`/v1/developer/webhook-endpoints`](/hu/webhooks/endpoints) alatt,
végpontonkénti titkos kulcsokkal és végpontonkénti
eseményfeliratkozásokkal.
* **Régi, egyetlen URL-es webhook**: szervezetenként egy URL. Kezelése a
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
alatt vagy a **Szervezet → Általános** menüben történik. A visszafelé
kompatibilitás érdekében megmaradt.
Az események két osztályba sorolhatók:
* A **blokkoló események** esetén a szerverének olyan konfigurációval
kell válaszolnia, amely alakítja a folyamatban lévő hívást — ezek a
[bejövő hívási események](/hu/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Legfeljebb 10 másodperce van
a válaszadásra; időtúllépés esetén a statikusan hozzárendelt ügynök
kezeli a hívást.
* A **nem blokkoló események** elküldési és elfelejtési értesítések,
amelyeket exponenciális visszalépéssel próbálunk újra kézbesíteni —
lásd a [kézbesítési szemantikát](/hu/webhooks/overview).
Minden kérés HMAC-SHA256 aláírást tartalmaz a
`X-ThunderPhone-Signature` fejlécben. Lásd:
[Aláírás-ellenőrzés](/hu/webhooks/overview).
***
## Függvényeszközök
Egy **függvényeszköz** egy HTTP-végpont, amelyet az ügynöke a
beszélgetés közben hívhat meg. Ön egy OpenAI-stílusú
függvénysémát és egy végpont-URL-t ad meg a ThunderPhone számára; az
ügynök eldönti, mikor hívja meg, a ThunderPhone pedig aláírt HTTP-kérést
indít a szervereiről, és visszaadja az eredményt az ügynöknek.
Az ügynökök **beépített hívási képességekkel** is rendelkeznek — a hívás
átadása, billentyűzeti (DTMF) bevitel küldése, a hívás befejezése,
várakoztatás —, amelyeket egyszerű prompt-sorokkal engedélyezhet
eszközdefiníciók helyett.
**A vezérlőpulton:** a szerkesztő **API-kapcsolatok** szakasza (lásd:
[Kapcsolatok](#connections)).
**Az API-ban:** [`/v1/integrations`](/api-reference/integrations) és a
[Függvényeszközök specifikációja](/hu/tools/overview).
***
## Csapat és szerepkörök
Minden szervezet rendelkezik taglistával, amely két szerepkört tartalmaz:
a **Tagok** ügynököket hoznak létre és üzemeltetnek; az
**Adminisztrátorok** emellett a csapatot és a számlázást is kezelik.
E-mailben hívhat meg tagokat — a meghívók 7 nap után lejárnak és
visszavonhatók; egy tag sorában található ⋯ menüvel módosíthatja a
szerepkört vagy eltávolíthat valakit. Az egyszeri bejelentkezés
szervezetszinten konfigurálható — lásd: [SSO](/hu/guides/sso).
**A vezérlőpulton:** **Szervezet → Általános**. Lásd:
[Csapat meghívása](/hu/guides/invite-your-team).
**Az API-ban:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
***
## Számlázás
A ThunderPhone **előre fizetett**. Minden szervezethez USD-egyenleg tartozik; a hívások az ügynök percenkénti díjával terhelik azt (a motorcsomag és a felárak alapján —
a szerkesztő a beállítások módosításakor élőben mutatja a teljes díjat, és a
[prémium nyelvek](/hu/guides/supported-languages) további 2¢/perc díjat jelentenek). Amikor az
egyenleg eléri a nullát, a bejövő hívásokat a rendszer elutasítja, a kimenő hívások pedig
`402 Payment Required` választ adnak vissza.
Töltse fel manuálisan az egyenleget, vagy engedélyezze az **automatikus feltöltést** egy egyenlegküszöbértékkel, egy
feltöltési összeggel és opcionális havi költési limittel — így egy hívás
soha nem szakad meg mondat közben.
**A vezérlőpulton:** **Szervezet → Számlázási beállítások** és
**Számlázási előzmények**. Lásd:
[Egyenleg feltöltése és az automatikus feltöltés bekapcsolása](/hu/guides/billing-and-topups).
**Az API-ban:** [`/v1/billing`](/api-reference/billing).
***
## Az alkalmazáson belüli kopilóta
A vezérlőpult beépített **kopilótával** rendelkezik — kérdezze meg tőle: „hogyan csináljam az X-et”,
és a dokumentáció alapján válaszol, kattintásról kattintásra bemutató útmutatókat kínál,
amelyek kiemelik a tényleges vezérlőelemeket, valamint bármelyik vezetett bemutatót újra le tudja játszani.
Ez a leggyorsabb módja annak, hogy megtaláljon egy ezen az oldalon említett vezérlőelemet.
Lásd: [Kérdezze meg az alkalmazáson belüli kopilótát](/hu/guides/ask-the-copilot).
***
## Mindez együtt
Az ötlépéses varázsló: ügynök → számlázás → szám → szimuláció → ellenőrzés.
Ugyanaz az első hívás négy REST-hívással.
Hozzon létre egy ügynököt, töltse fel az egyenlegét, szerezzen egy számot, szimuláljon, és ellenőrizze a hívásokat.
OAuth-alkalmazások, egyéni API-k, MCP-szerverek és VoIP-szolgáltatók.
Jelentések, megfigyelhetőség, kísérletek, problémák és riasztások.
Meghívók és szerepkörök, API-kulcsok, biztonság és SSO.
API-receptek: bejövő, kimenő, dinamikus konfiguráció, eszközök, tesztelés.
Állítsa be helyesen egyszer a HMAC-ellenőrzést, majd használja újra mindenhol.