> ## 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.
# Základní pojmy
> Přehled všeho na platformě — co jednotlivé objekty dělají, kde je najdete v dashboardu a které API se jich týká.
ThunderPhone je kompletní platforma pro vytváření, provoz a zlepšování
hlasových agentů s AI. Tato stránka je mapou: každý pojem, se kterým se setkáte,
má vlastní krátkou sekci spolu s místem v dashboardu a rozhraním API, které jej podporuje.
Jednou si ji projděte a vraťte se k ní kdykoli budete potřebovat některý pojem objasnit.
Postranní panel dashboardu tuto strukturu odráží:
[Agenti](#agents), [telefonní čísla](#phone-numbers),
[webové widgety](#web-widgets), [hovory](#calls),
[znalostní báze](#knowledge-bases).
[Živé monitorování](#live-monitoring) a odchozí
[kampaně](#campaigns).
[Aplikace, rozhraní API, servery MCP a poskytovatelé VoIP](#connections), které mohou
vaši agenti používat.
[Simulace](#simulations), [experimenty](#experiments),
[problémy](#issues), [reporty](#reports),
[sledovatelnost](#observability).
[Tým a role](#team-and-roles), [klíče API](#organizations),
[upozornění](#alerts), [fakturace](#billing).
[Webhooky](#webhooks) a [funkční nástroje](#function-tools) pro
váš vlastní kód.
***
## Organizace
**Organizace** je základní jednotka pro oddělení prostředí. Každý další prostředek —
agenti, telefonní čísla, hovory, klíče — patří právě do jedné organizace. Váš
účet může patřit do více organizací; každá má vlastní zůstatek, vlastní
klíče a vlastní seznam členů.
Klíč API `sk_live_`, který vytvoříte v části **Organizace → Klíče**, je
vázaný na jednu organizaci. Díky tomuto vazbě je rozhraní REST API tak
přímočaré: do cest URL nikdy nevkládáte ID organizace, protože ji váš klíč
už identifikuje.
**V dashboardu:** přepínač organizace (v zápatí postranního panelu) a
nastavení **Organizace** — karty Obecné, Klíče, Upozornění, Nastavení
fakturace a Historie fakturace.
**V API:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Agenti
**Agent** je konfigurace AI, která řídí hovor. Zahrnuje:
* **Prompt**, který určuje, co agent říká a jak se chová —
včetně akcí hovoru, jako je předání hovoru, stisky klávesnice a ukončení hovoru,
které jsou běžnými řádky promptu, nikoli samostatnou konfigurací.
* **Úroveň enginu** (`spark`, `bolt`, `storm-*`): Spark je optimalizovaný
pro náklady, Bolt pro rychlost a Storm pro inteligenci při složitých promptech.
* **Hlas** spolu s **primárním jazykem** a volitelnými **dalšími
jazyky** — agent se automaticky přepne, když volající změní
jazyk. Viz [Podporované jazyky](/cs/guides/supported-languages).
* Připojené možnosti: [propojené aplikace](#connections),
[připojení API](#connections), [znalostní báze](#knowledge-bases),
[servery MCP](#connections) a vložené
[funkční nástroje](#function-tools).
* Nastavení chování: pořadí mluvení, režim potvrzování, podkresová stopa,
časový limit podržení.
Úpravy v nástroji pro tvorbu se **automaticky ukládají jako koncept**; nic se nepublikuje,
dokud nekliknete na **Nasadit**. Každé nasazení se uloží jako snímek na kartě
**Historie** v nástroji pro tvorbu, takže můžete prohlédnout a obnovit libovolnou předchozí verzi.
**V dashboardu:** **Hlasoví agenti** → nástroj pro tvorbu agentů
(`/dashboard/agents`). Viz
[Vytvořte svého prvního hlasového agenta](/cs/guides/build-an-agent).
**V API:** [`/v1/agents`](/api-reference/agents) — CRUD,
duplikování, předání, historie verzí a pomocné nástroje pro prompty.
***
## Telefonní čísla
**Telefonní číslo** patří organizaci a směruje příchozí hovory na
agenta (a může uskutečňovat odchozí hovory). Dva zdroje:
* **Ukázková čísla** — skutečná americká čísla zřízená z fondu
ThunderPhone, aktivní během několika sekund. Pouze pro příchozí
hovory, odpovídají krátkým mluveným upozorněním a řídicí panel omezuje
organizaci na 10 těchto čísel. Ideální pro první test, nikoli pro
produkci.
* **VoIP čísla** — přinesená od vlastního poskytovatele prostřednictvím
[VoIP připojení](#connections). Twilio a Telnyx se připojují přímo
(Telnyx nabízí provázené nastavení); SignalWire a Vonage budou brzy
k dispozici — dnes je můžete připojit pomocí ruční konfigurace SIP,
která přijímá jakýkoli SIP trunk. Po importu a ověření podporují VoIP
čísla příchozí i odchozí hovory.
V každém řádku čísla můžete nastavit režim směrování, vybrat agenta pro
příchozí hovory a číslo označit.
**V řídicím panelu:** **Telefonní čísla** (`/dashboard/phone-numbers`).
Viz [Získejte telefonní číslo](/cs/guides/get-a-phone-number).
**V API:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).
***
## Hovory
Každý příchozí hovor, odchozí hovor, simulace a relace widgetu se stává
**záznamem hovoru**. Hovor obsahuje úplný přepis s označenými rolemi,
strukturovanou historii tahů (včetně volání nástrojů), nahrávku,
celkovou cenu a volitelné hodnocení AI a hlášení problémů.
Když hovor **probíhá**, můžete jej otevřít a **odposlouchávat** — připojíte
se tiše a nikdo v hovoru vás neuslyší. Po připojení můžete
**našeptávat**: zadejte pokyn, který se během hovoru odešle přímo vašemu
agentovi; volající jej nikdy neuslyší a agent se jím bude ihned řídit.
**V řídicím panelu:** **Historie hovorů** (`/dashboard/call-history`) pro
archiv a podrobnosti jednotlivých hovorů; **Živě** pro probíhající
hovory. Viz
[Kontrola, odposlech a koučování hovorů](/cs/guides/review-calls).
**V API:** [`/v1/calls`](/api-reference/calls) — seznam, přepis,
historie, zvuk, hodnocení, export;
[`/v1/issue-reports`](/api-reference/issue-reports).
***
## Webové widgety
**Webový widget** poskytuje návštěvníkům vašeho webu konverzaci
s agentem přes mikrofon — telefonní číslo není potřeba. Ověřuje se
pomocí **veřejného klíče** (`pk_live_...`), který je omezen na původy
vašich povolených domén, takže jej lze bezpečně použít v kódu na straně
klienta.
Klíče fungují v jednom ze dvou režimů: `agent` (staticky vázaný na
jednoho agenta) nebo `webhook` (váš server vybírá konfiguraci pro
každého návštěvníka — viz
[Dynamická konfigurace pro jednotlivé hovory](/cs/guides/dynamic-call-config)).
Relace widgetu využívají stejnou infrastrukturu hovorů jako telefonní
hovory.
**V řídicím panelu:** **Webové widgety** (`/dashboard/web-widgets`) —
vytvářejte widgety, nastavujte režim a agenta, spravujte povolené domény
a kopírujte kód pro vložení. Viz
[Vytvoření webového widgetu](/cs/guides/embed-a-web-widget-dashboard).
**V API:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) a
[dokumentace Widget SDK](/cs/widget/overview).
***
## Znalostní báze
**Znalostní báze** je sada dokumentů, ve kterých může váš agent během
hovoru vyhledávat, aby své odpovědi opřel o relevantní informace —
nahrajte soubory přímo nebo je importujte z Google Drive a poté
znalostní bázi připojte k agentovi v nástroji pro tvorbu. Agent ji
dotazuje pomocí integrovaného vyhledávacího nástroje, kdykoli to
konverzace vyžaduje.
**V řídicím panelu:** **Znalosti** (`/dashboard/knowledge`) pro knihovnu
dokumentů; sekce **Znalosti** v nástroji pro tvorbu pro připojení
znalostní báze k agentovi. Viz
[Poskytněte agentovi znalostní bázi](/cs/guides/knowledge-base).
***
## Propojení
Propojení umožňují agentům komunikovat s okolním světem. Čtyři typy, jedna
skupina v postranním panelu:
* **Aplikace** (`/dashboard/app-connections`) — připojení OAuth ke
Slacku, HubSpotu, Salesforce, Kalendáři Google, Tabulkám Google a
Cal.com. Připojte jednou a poté u libovolného agenta zapínejte nástroje pro
jednotlivé operace (odeslání zprávy do Slacku, vytvoření nebo aktualizace kontaktu v HubSpotu, rezervace termínu v Cal.com…).
Viz [Připojení aplikací](/cs/guides/connect-apps).
* **API** (`/dashboard/api-connections`) — proměňte libovolné HTTP API na
akci agenta. Vložte příkaz cURL a průvodce AI navrhne definici nástroje,
nebo ji vytvořte ručně; tlačítko **Testovat požadavek** provede
volání v sandboxu před nasazením. Viz
[Připojení API](/cs/guides/api-connections) — rozhraní dashboardu pro
[`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — přidejte server Model Context
Protocol pomocí adresy URL a nechte agenta používat nástroje, které poskytuje.
Viz [Přidání serveru MCP](/cs/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — přihlašovací údaje poskytovatele pro
[použití vlastních telefonních čísel](#phone-numbers). Viz
[Připojení poskytovatele VoIP](/cs/guides/voip-providers).
**V API:** [`/v1/integrations`](/api-reference/integrations) a
[`/v1/voip-connections`](/api-reference/voip-connections); viz také
[Vytvoření integrace nástroje](/cs/guides/build-tool-integration).
***
## Kampaně
**Kampaň** uskutečňuje odchozí hovory ve velkém měřítku: nahrajte CSV se
kontakty, vyberte agenta a číslo volajícího a nastavte okno pro volání
(dny a hodiny se zohledněním časového pásma), souběžnost a zásady opakování
(maximální počet pokusů a výsledky — bez odpovědi, hlasová schránka, neúspěch — které se mají
opakovat). Kampaň postupuje seznamem a zaznamenává každý hovor
do Historie hovorů.
**V dashboardu:** **Kampaně** (`/dashboard/campaigns`). Viz
[Spuštění kampaně odchozího volání](/cs/guides/outbound-campaigns).
**Pro jednorázové programové hovory:**
[API pro odchozí hovory](/cs/guides/place-outbound-calls).
***
## Živé sledování
**Živě** zobrazuje každý probíhající hovor v celé organizaci a umožňuje
otevřít kterýkoli z nich a [odposlouchávat jej nebo do něj vstupovat šeptem](#calls) v reálném čase. Jde
o rozhraní pro dohled: sledujte, jak nový prompt získává první skutečný
provoz, nebo mějte pod dohledem spuštěnou kampaň.
**V dashboardu:** **Živě** (`/dashboard/live`). Viz
[Sledování a dohled nad živými hovory](/cs/guides/monitor-live-calls).
***
## Simulace
**Simulace** je volající AI, který vede skutečný rozhovor s vaším
agentem — stejná telefonní cesta, skutečný přepis, skutečné hodnocení — takže
můžete testovat před nasazením i po něm. Nasměrujte ji na agenta nebo telefonní
číslo, napište scénář volajícího sami nebo **generujte scénáře
pomocí AI** z promptu agenta (včetně okrajových případů, pokud o ně požádáte),
a sledujte hovor živě.
Scénáře se sdružují do **sad**, které stanovují minimální úspěšnost a mohou
blokovat vydání v CI; regrese oproti přijatému základu se hlásí pro každý
scénář.
**V dashboardu:** **Simulace** (`/dashboard/simulations`) a také
tlačítko **Simulace** v nástroji pro tvorbu agentů. Viz
[Simulace hovoru](/cs/guides/simulate-a-call).
**V API:** [`/v1/test-calls`](/api-reference/test-calls) a spouštěč
sad — viz [Komplexní testování agenta](/cs/guides/test-agents).
***
## Experimenty
**Experiment** provádí A/B testování konfigurací agentů na živém provozu:
definujte varianty (různé prompty, enginy nebo nastavení), rozdělte mezi ně
provoz a porovnejte výsledky jednotlivých variant. Použijte jej namísto
ruční implementace logiky segmentů ve webhooku.
**V dashboardu:** **Experimenty** (`/dashboard/experiments`) a
karta **A/B** v nástroji pro tvorbu agentů. Viz
[Experimenty (A/B testování)](/cs/guides/experiments-ab-testing).
## Problémy
**Problém** je označený problém v konkrétním hovoru — nahlášený
lidským kontrolorem nebo zjištěný hodnocením AI. Problémy obsahují závažnost,
zdroj a stav a stránka Problémy slouží jako fronta pro třídění: filtrujte,
prohlédněte problematický hovor a sledujte opravy.
**V dashboardu:** **Problémy** (`/dashboard/issues`) a označování
jednotlivých hovorů v Historii hovorů. Viz [Třídění problémů](/cs/guides/issues).
**V API:** [`/v1/issue-reports`](/api-reference/issue-reports).
***
## Reporty
**Report** odpovídá na otázku v přirozeném jazyce o vašich datech hovorů
(„Jaké byly minulý týden tři hlavní důvody, proč volající požadovali člověka?“)
pomocí analýzy vytvořené AI, omezené na agenty a období, které zvolíte.
**V dashboardu:** **Reporty** (`/dashboard/reports`). Viz
[Reporty](/cs/guides/reports).
***
## Observabilita
**Observabilita** je oblast metrik: objem hovorů, výsledky a
kvalita v čase, s možností filtrování podle agenta a časového okna a exportu
pro následnou analýzu.
**V dashboardu:** **Observabilita** (`/dashboard/observability`).
Viz [Observabilita](/cs/guides/observability).
***
## Upozornění
**Pravidlo upozornění** sleduje metriku (míru úspěšnosti, míru selhání,
průměrné skóre, objem hovorů, regrese sad) v časovém okně a
spustí se, když překročí váš práh. Oznámení se odesílají e-mailem a do
Slacku a vyvolají událost `alert.triggered` pro vaše
[koncové body webhooků](/cs/webhooks/endpoints).
**V dashboardu:** **Organizace → Upozornění**. Viz
[Upozornění](/cs/guides/alerts).
***
## Webhooky
ThunderPhone odesílá na váš server **HTTP POST webhooky**, když
během hovoru a po něm nastanou události. Dva modely doručování:
* **Koncové body webhooků** (doporučeno): spravujte více URL na
[`/v1/developer/webhook-endpoints`](/cs/webhooks/endpoints) s
tajnými klíči pro jednotlivé koncové body a odběry událostí pro jednotlivé koncové body.
* **Starší webhook s jedinou URL**: jedna URL pro organizaci. Spravuje se na
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
nebo v části **Organizace → Obecné**. Je zachován kvůli zpětné kompatibilitě.
Události se dělí do dvou tříd:
* **Blokující události** očekávají, že váš server odpoví konfigurací,
která ovlivní probíhající hovor — jedná se o
[události příchozích hovorů](/cs/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Na odpověď máte až 10 sekund;
při vypršení časového limitu hovor zpracuje staticky přiřazený agent.
* **Neblokující události** jsou oznámení typu fire-and-forget, která se opakují
s exponenciálním odkladem — viz
[sémantika doručování](/cs/webhooks/overview).
Každý požadavek obsahuje podpis HMAC-SHA256 v hlavičce
`X-ThunderPhone-Signature`. Viz
[Ověření podpisu](/cs/webhooks/overview).
***
## Funkční nástroje
**Funkční nástroj** je koncový bod HTTP, který může váš agent volat
uprostřed konverzace. ThunderPhone poskytnete schéma funkce ve stylu OpenAI
spolu s URL koncového bodu; agent rozhodne, kdy jej zavolat, a
ThunderPhone odešle ze svých serverů podepsaný HTTP požadavek a předá
výsledek zpět agentovi.
Agenti také obsahují **vestavěné funkce pro hovory** — přepojení hovoru,
odesílání vstupu z klávesnice (DTMF), ukončení hovoru, čekání v režimu podržení —,
které povolíte pomocí jednoduchých řádků v promptu namísto definic nástrojů.
**V dashboardu:** sekce **Připojení API** v nástroji pro tvorbu (viz
[Připojení](#connections)).
**V API:** [`/v1/integrations`](/api-reference/integrations) a
[specifikace funkčních nástrojů](/cs/tools/overview).
***
## Tým a role
Každá organizace má seznam členů se dvěma rolemi: **Členové** vytvářejí
a provozují agenty; **Správci** také spravují tým a fakturaci.
Pozvěte členy e-mailem — pozvánky vyprší po 7 dnech a lze je zrušit;
nabídka ⋯ na řádku člena mění role nebo někoho odebere. Jednotné
přihlášení lze nakonfigurovat pro celou organizaci — viz [SSO](/cs/guides/sso).
**V dashboardu:** **Organizace → Obecné**. Viz
[Pozvěte svůj tým](/cs/guides/invite-your-team).
**V API:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
***
## Fakturace
ThunderPhone je **předplacený**. Každá organizace má zůstatek v USD; hovory
z něj strhávají sazbu agenta za minutu (úroveň enginu plus příplatky —
editor při změně nastavení průběžně zobrazuje celkovou sazbu a
[prémiové jazyky](/cs/guides/supported-languages) přidávají 2 ¢/min). Když
zůstatek klesne na nulu, příchozí hovory jsou odmítnuty a odchozí hovory
vrátí `402 Payment Required`.
Doplňte kredit ručně nebo zapněte **automatické dobíjení** s prahem
zůstatku, částkou dobíjení a volitelným měsíčním limitem útrat — aby se
hovor nikdy nepřerušil uprostřed věty.
**V ovládacím panelu:** **Organizace → Nastavení fakturace** a
**Historie fakturace**. Viz
[Přidání prostředků a zapnutí automatického dobíjení](/cs/guides/billing-and-topups).
**V API:** [`/v1/billing`](/api-reference/billing).
***
## Kopilot v aplikaci
Ovládací panel obsahuje vestavěného **kopilota** — zeptejte se ho „jak mohu X“
a odpoví na základě této dokumentace, nabídne podrobné postupy krok za krokem,
které zvýrazní skutečné ovládací prvky, a dokáže přehrát kteroukoli z prohlídek.
Je to nejrychlejší způsob, jak najít ovládací prvek uvedený na této stránce.
Viz [Dotaz na kopilota v aplikaci](/cs/guides/ask-the-copilot).
***
## Jak to celé spojit
Průvodce v pěti krocích: agent → fakturace → číslo → simulace → kontrola.
Stejný první hovor ve čtyřech REST voláních.
Vytvořte agenta, dobijte kredit, získejte číslo, simulujte a zkontrolujte hovory.
Aplikace OAuth, vlastní API, servery MCP a poskytovatelé VoIP.
Reporty, sledovatelnost, experimenty, problémy a upozornění.
Pozvánky a role, klíče API, zabezpečení a SSO.
Postupy pro API: příchozí hovory, odchozí hovory, dynamická konfigurace, nástroje, testování.
Implementujte kontrolu HMAC správně jednou a používejte ji všude.