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

# Referenční příručka nastavení hlasového agenta

> Vysvětlení všech nastavení hlasového agenta ThunderPhone: úrovně, hlasy, jazyky, potvrzení, nástroje, pořadí mluvení, hlasová schránka, oznámení o souhlasu, práce s tichem, testování a nasazení.

Otevřete **Hlasoví agenti**, vyberte agenta a pomocí karty **Konfigurace** ovládejte,
jak zní, uvažuje, zahajuje hovory, používá nástroje, pracuje s tichem a hlasovou schránkou
a jak oslovuje volající. Změny se automaticky ukládají do konceptu; produkční provoz se nezmění,
dokud nevyberete **Nasadit**.

Tato stránka představuje kompletní referenci k dashboardu. Názvy polí a příklady
požadavků najdete v [referenci API agentů](/api-reference/agents).

## Prompt a identita

Název agenta jej identifikuje v celém dashboardu, přehledech, historii hovorů
a klientských portálech. Prompt je provozní scénář agenta: persona,
informace o firmě, povinné otázky, zásady eskalace a akce během hovoru.

Editor promptu zobrazuje odhadovaný počet tokenů a označuje běžné problémy, jako je
prázdný prompt, nevyřešené zástupné symboly šablony, chybějící cesta eskalace nebo
velmi dlouhý prompt. Prvních **5 000 odhadovaných tokenů** je zahrnuto; delší
prompty využívají [příplatkové ceny podle bloků](/cs/guides/pricing).

<Tip>
  Přepojení, stisky klávesnice, chování při podržení hovoru a rozhodnutí o zavěšení můžete napsat
  přímo do promptu. Když agent potřebuje externí data nebo akce, připojte nástroje API, aplikací, MCP nebo znalostí.
</Tip>

## Úroveň modelu

| Úroveň    | Základní cena | Nejvhodnější použití                                    |
| --------- | ------------: | ------------------------------------------------------- |
| **Spark** |   2 centy/min | Cenově citlivé, jednoduché hovory.                      |
| **Bolt**  |   5 centů/min | Rychlé odpovědi a vyvážené každodenní pracovní postupy. |
| **Storm** |   9 centů/min | Složité pokyny, porozumění zvuku a uvažování.           |

Storm nabízí dva volitelné ovládací prvky:

* **Potvrzení** — **Žádné** zůstává při přípravě celé odpovědi potichu;
  **Tiknutí** přehraje tichý zvuk čekání; **Slovní** vysloví stručné potvrzení
  a přidá **2 centy/min**. Slovní text může být vygenerován z hlavního promptu nebo
  dodán ručně prostřednictvím API.
* **Dodatečná inteligence** — přidává hlubší uvažování pro složité hovory a
  **3 centy/min**.

Nástroj pro tvorbu průběžně zobrazuje **celkové náklady za minutu** agenta včetně
úrovně, kombinace hlasu a jazyka, délky promptu, slovního potvrzení, dodatečné
inteligence a dohledu.

## Hlas, pozadí a jazyky

Vyberte hlas a před nasazením přehrajte jeho ukázku. Výběr nabízí pouze
hlasy kompatibilní se všemi vybranými jazyky a prémiové kombinace označuje
příplatkem. Po připravení se ve stejném výběru zobrazí i vaše vlastní hlasy.
Viz [Knihovna hlasů a vlastní hlasy](/cs/guides/voice-library).

**Zvuková stopa na pozadí** může být:

* **Žádná** — bez okolního zvuku.
* **Call centrum** — atmosféra call centra s náhledem v dashboardu.

Nastavte jeden **primární jazyk** a poté libovolný počet **dalších jazyků**. Agent
automaticky rozpozná, když volající přepne do vybraného jazyka, a odpoví v něm.
Některé kombinace hlasu a jazyka přidávají **3 centy/min**; viz generovaný
katalog [Podporované jazyky](/cs/guides/supported-languages).

## Připojené funkce

Karta Konfigurace obsahuje čtyři samostatně připojitelné sekce funkcí:

| Sekce                  | Použití                                                                                      |
| ---------------------- | -------------------------------------------------------------------------------------------- |
| **Připojené aplikace** | Schválené operace v Google Calendar, Google Sheets, Slack, HubSpot, Salesforce nebo Cal.com. |
| **Připojení API**      | Vaše vlastní koncové body HTTP popsané jako volatelné funkce.                                |
| **Znalosti**           | Soubory nebo webový obsah, ve kterých může agent během hovoru vyhledávat.                    |
| **Servery MCP**        | Nástroje uložené v mezipaměti objevené ze vzdálených serverů Model Context Protocol.         |

Připojení je součástí konceptu a po nasazení bude dostupné pro produkční hovory.
Nejprve nakonfigurujte prostředky v sekci **Připojení** nebo
**Znalosti** a poté je připojte k agentovi.

## Telefonní a webové koncové body

V části **Telefonní čísla** připojte existující číslo, zřiďte ukázkové číslo nebo
importujte číslo prostřednictvím připojení VoIP. Číslo může používat různé agenty
pro příchozí a odchozí směr.

V části **Webové widgety** připojte widget, aby návštěvníci mohli s agentem mluvit z
webu. Dostupnost widgetu lze také povolit nebo zakázat v rámci konfigurace agenta.

## Pokročilé chování hovorů

Rozbalte **Pokročilé** v dolní části konfigurace, kde najdete následující ovládací prvky.

### Dohled

Po zapnutí druhý monitor AI kontroluje každý tah agenta podle pokynů a může tiše zasáhnout. Dohled přidává **8 ¢/min** a není dostupný ve službě Bolt.

### Tón připojení

Přehraje krátký tón ihned po spojení hovoru a předtím, než začne mluvit kterákoli strana.

### Zvuk nástroje

Vyberte zvuk vytvářený nástrojem pro zvuk, který lze vyvolat pokynem:

* **Žádný** — nástroj není k dispozici.
* **Zvonkohra**, **Cinknutí** nebo **Pípnutí** — každý zvuk si můžete přehrát v nástroji pro tvorbu.

### Kdo mluví první

Nastavte příchozí a odchozí hovory samostatně:

* **Příchozí:** agent mluví první, nebo volající mluví první.
* **Odchozí:** agent mluví první, nebo volaný mluví první.

Toto nastavení je užitečné pro odchozí vytáčení, které musí před zahájením scénáře počkat na osobu nebo telefonní menu.

### Zpracování hlasové schránky

Vyberte, co se stane, když odchozí hovor dosáhne hlasové schránky:

| Možnost                            | Chování                                                               |
| ---------------------------------- | --------------------------------------------------------------------- |
| **Nechat rozhodnout agenta**       | Pokyn a kontext konverzace určují, zda má agent mluvit, nebo zavěsit. |
| **Tiše zavěsit**                   | Ukončí hovor bez zanechání zprávy.                                    |
| **Zanechat zprávu a poté zavěsit** | Přečte nastavenou zprávu a ukončí hovor.                              |

Zprávy do hlasové schránky mohou obsahovat až **2 000 znaků** a podporují
`{agent_name}` a `{org_name}`. Informace o způsobu účtování času hovoru najdete v části
[Ceník](/cs/guides/pricing).

### Oznámení o souhlasu

Ve výchozím nastavení krátké oznámení na začátku každého hovoru sdělí volajícímu, že hovoří s asistentem AI a že je hovor nahráván. Text oznámení můžete upravit až do **2 000 znaků**; přehraje se doslovně v jazyce agenta.

Vypnutí oznámení u způsobilého agenta vyžaduje, aby správce organizace potvrdil, že organizace poskytne veškerá zákonem vyžadovaná upozornění a získá veškeré zákonem vyžadované souhlasy. Opětovné zapnutí a následné vypnutí vyžaduje nové potvrzení. Před změnou tohoto nastavení si prostudujte
[průvodce zákony o souhlasu s nahráváním](/cs/guides/recording-consent-laws).

### Kontroly při tichu

Po zapnutí agent po období ticha ověří, zda je volající stále přítomen, opakuje kontrolu až do nastaveného limitu a poté zavěsí:

* **Sekundy před kontrolou:** 10–120 sekund.
* **Maximální počet kontrol:** 1–10.

Výchozí hodnoty jsou 15 sekund a 3 kontroly.

## Karty nástroje pro tvorbu a životní cyklus

| Karta nebo akce  | Účel                                                                                   |
| ---------------- | -------------------------------------------------------------------------------------- |
| **Živě / Hovor** | Hovořte v prohlížeči s aktuálním konceptem a kontrolujte přepis i aktivitu nástrojů.   |
| **Hovory**       | Prohlédněte si hovory vyřízené tímto agentem.                                          |
| **A/B**          | Vytvářejte varianty pokynů nebo konfigurace a porovnávejte výsledky v reálném provozu. |
| **Simulovat**    | Spusťte uložené nebo ad hoc scénáře volajícího AI proti konceptu.                      |
| **Ověření**      | Před nasazením přehrajte vůči konceptu zmrazené tahy ze skutečných hovorů.             |
| **Historie**     | Porovnávejte nasazené revize a jednu z nich obnovte do konceptu.                       |
| **Zahodit**      | Vraťte všechna čekající nastavení konceptu na nasazenou verzi.                         |
| **Nasadit**      | Atomicky povýší celý koncept a vytvoří revizi.                                         |

Pokud jiný editor uloží stejného agenta poté, co jste jej načetli, ThunderPhone konfliktní uložení nebo nasazení zastaví a požádá vás o obnovení stránky, místo aby přepsal jeho změny.

## Správa agentů ze seznamu

Stránka **Hlasoví agenti** také podporuje akce životního cyklu na úrovni organizace:

* **Duplikujte** agenta jako nový výchozí bod ve stejné organizaci.
* **Převeďte** agenta do jiné organizace, jejímž jste členem. **Kopírovat** zachová
  zdroj; **Přesunout** jej odebere z aktuální organizace a vyžaduje
  přístup správce.
* Vyberte jednoho nebo více agentů a exportujte jejich zobrazenou konfiguraci jako
  **CSV** nebo **JSON**.
* Po potvrzení odstraňte jednoho agenta nebo hromadně odstraňte vybrané agenty.

Kopírování nebo přesunutí agenta mezi organizacemi automaticky neuděluje
cílové organizaci přístup k připojením dostupným pouze ve zdrojové organizaci. Před
nasazením zkopírovaného agenta v cílové organizaci zkontrolujte jeho přílohy aplikace,
API, znalostí, MCP, telefonního čísla a widgetu.

## Související stránky

<CardGroup cols={2}>
  <Card title="Vytvoření prvního agenta" icon="robot" href="/cs/guides/build-an-agent">
    Stručný průvodce tvorbou od začátku do konce.
  </Card>

  <Card title="Ceník" icon="coins" href="/cs/guides/pricing">
    Základní tarify, doplňky, účtování hovorů, čísla a jednorázové poplatky.
  </Card>

  <Card title="Validační sady" icon="list-check" href="/cs/guides/validation-sets">
    Uložte repliky ze skutečných hovorů a před nasazením je znovu přehrajte.
  </Card>

  <Card title="API agentů" icon="code" href="/api-reference/agents">
    Pole požadavků, koncepty, nasazení, verze a příklady.
  </Card>
</CardGroup>
