--- title: "Referenční přehled nastavení hlasového agenta" description: "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, zpracování ticha, testování a nasazení." --- Otevřete **Hlasoví agenti**, vyberte agenta a na kartě **Konfigurace** určete, jak zní, uvažuje, zahajuje hovory, používá nástroje, řeší ticho a hlasovou schránku a jak kontaktuje volající. Změny se automaticky ukládají do konceptu; provozní provoz se nezmění, dokud nevyberete **Nasadit**. Tato stránka obsahuje úplnou referenci k ovládacímu panelu. 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 ovládacím panelu, 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 upozorňuje na běžné problémy, například prázdný prompt, nevyřešené zástupné symboly šablony, chybějící cestu 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). Přepojení, stisky klávesnice, chování při čekání a rozhodnutí o ukončení hovoru můžete napsat přímo do promptu. Když agent potřebuje externí data nebo akce, připojte nástroje API, aplikace, MCP nebo znalostní nástroje. Pravidla směrování, studená přepojení a prověřená teplá přepojení naleznete v části [Přepojování hovorů](/cs/guides/call-transfers). ## Úroveň modelu {/* rate:tier-table */} | Úroveň | Základní cena | Nejvhodnější použití | | --- | ---: | --- | | **Spark** | 2¢/min | Cenově citlivé, přímočaré hovory. | | **Bolt** | 5¢/min | Rychlé odpovědi a vyvážené každodenní pracovní postupy. | | **Storm** | 9¢/min | Složité pokyny, porozumění zvuku a uvažování. | {/* /rate */} Storm nabízí dva volitelné ovládací prvky: - **Potvrzení** — **Žádné** zůstává při přípravě celé odpovědi potichu; **Tiknutí** přehraje jemný zvuk čekání; **Slovní** pronese krátké potvrzení a přidá **{/* rate:ack */}2¢/min{/* /rate */}**. Slovní text lze vygenerovat z hlavního promptu nebo zadat ručně. **Vlastní prompt potvrzení** se zobrazí pouze tehdy, když vybraný režim Storm podporuje slovní potvrzení; jinak toto pole není k dispozici. - **Dodatečná inteligence** — přidává hlubší uvažování pro složité hovory a **{/* rate:extra */}3¢/min{/* /rate */}**. Nástroj pro tvorbu průběžně zobrazuje **celkovou cenu 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 si přehrajte jeho ukázku. Výběr vyžaduje pouze, aby vámi zvolený hlas podporoval **primární jazyk**. Pokud zapnete **Přepínat na nativní hlasy**, další jazyky mohou místo toho pokrýt nativní katalogové hlasy stejného pohlaví. Prémiové kombinace jsou označeny příplatkem. Vaše vlastní hlasy se po dokončení zobrazí ve stejném výběru. 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 přímo v ovládacím panelu. 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 v tomto jazyce odpoví. Některé kombinace hlasu a jazyka přidávají **{/* rate:language */}3¢/min{/* /rate */}**; viz generovaný katalog [Podporované jazyky](/cs/guides/supported-languages). Když má agent nastavené **Další jazyky**, povolte **Přepínat na rodilé hlasy**, abyste použili katalogový hlas rodilého mluvčího rozpoznaného jazyka odpovídajícího pohlaví. Pro primární jazyk se přepne zpět na nakonfigurovaný hlas. Pokud není k dispozici odpovídající rodilý hlas, nadále se používá aktuální hlas. Vlastní hlasy se nepřepínají. Každý jazyk otestujte pomocí **Mluvit** a poté vyberte **Nasadit**. Přepínání rodilých hlasů nemá samostatný příplatek. Vybraná kombinace jazyka a hlasu stále určuje, zda se uplatní sazba za prémiový jazyk. ## Připojené funkce Karta Konfigurace obsahuje čtyři nezávisle 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, které může agent během hovoru prohledá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 pro produkční hovory bude k dispozici po nasazení. Nejprve nakonfigurujte zdroje v části **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ískejte číslo ThunderPhone nebo importujte číslo prostřednictvím připojení VoIP. Číslo může používat různé agenty pro příchozí a odchozí hovory. 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 konfiguraci agenta. ## Časové pásmo **Časové pásmo** pod telefonními čísly určuje, co agent považuje za „teď“: uvádí datum a čas, nabízí termíny schůzek a vyhodnocuje „dnes“ a „zítra“ v tomto pásmu. Používá ho také pracovní doba tohoto agenta ve výkazech. Nový agent začíná s časovým pásmem vaší organizace, nebo vašeho počítače, pokud organizace žádné nemá. Změňte je, pokud se vaši volající nacházejí jinde. Když je telefonní číslo agenta v jiném pásmu než v tom, které jste vybrali, tvůrce vás na to upozorní a nabídne přepnutí. Agent bez časového pásma (starší agent nebo agent vytvořený prostřednictvím API bez `timezone`) používá pásmo čísla, na kterém hovor probíhá, poté pásmo čísel agenta, pak organizace a nakonec tichomořské pásmo USA. Tvůrce zobrazí, o které pásmo jde, a požádá vás o jeho potvrzení nebo o výběr pásma, pokud to čísla neurčují (bezplatné číslo nebo čísla v různých pásmech). Když jeden agent obsluhuje kontakty v několika časových pásmech, předávejte místo toho pásmo s každým hovorem: `timezone` v [`POST /v1/call`](/api-reference/outbound-calls) nebo v [odpovědi vašeho konfiguračního webhooku](/cs/guides/dynamic-call-config). ### Pokud váš agent zatím nemá časové pásmo Noví agenti vyžadují časové pásmo. Starší agenti ho stále nemusí mít nastavené. Pokud starší agent nemá časové pásmo, ThunderPhone nejprve použije vlastní nastavení agenta, pokud existuje, poté nastavení vaší organizace a následně časové pásmo odvozené z telefonních čísel agenta. Pokud to stále nepomůže, použije se časové pásmo Los Angeles. Nástroj pro tvorbu zobrazí určené pásmo a požádá vás o jeho potvrzení nebo o výběr pásma, pokud je nelze určit podle čísel. ## Pokročilé chování hovorů Rozbalte **Pokročilé** v dolní části Konfigurace pro následující ovládací prvky. ### Dohled Je-li povolen, druhý monitor AI kontroluje každý tah agenta podle pokynů a může nepozorovaně zasáhnout. Dohled přidává **{/* rate:supervision */}4 ¢/min{/* /rate */}** a není k dispozici v Bolt. ### Tón připojení Přehraje krátký tón ihned po připojení hovoru a předtím, než některá strana promluví. ### Úvodní klip Přehrajte předem nahraný klip na začátku příchozích hovorů, po kterém následuje vyzvánění, aby linka zněla jako firemní telefonní linka, než agent odpoví. Přehrává se u příchozích telefonních hovorů a testovacích hovorů **Talk** (v prohlížeči) v nástroji pro tvorbu. Nepřehrává se u odchozích hovorů, testovacích hovorů AI, hovorů z webového widgetu ani volání přes Realtime API. - **Vypnuto** (výchozí) — agent odpoví ihned. - **Oznámení o nahrávání** — nahraný hlas říká „Tento hovor může být monitorován nebo nahráván pro účely zajištění kvality.“ Poslechněte si náhled v nástroji pro tvorbu. - **Vlastní nahrávka** — nahrajte zvukový soubor (MP3, WAV, M4A a další formáty, které váš prohlížeč dokáže přehrát) nebo jej nahrajte v prohlížeči. Klipy mohou být dlouhé 0,5 až 15 sekund. Nástroj pro tvorbu klip před nahráním převede a můžete jej přehrát nebo odstranit. **Vyzvánění po úvodu** určuje, kolik amerických vyzvánění se přehraje po klipu: **Vypnuto**, **1 vyzvánění** (výchozí) nebo **2 vyzvánění**. Pořadí na začátku hovoru je následující: tón připojení (je-li zapnutý), úvodní klip, vyzvánění, poté [oznámení o souhlasu](#consent-announcement) nebo [sdělení o zpracování pomocí AI](#ai-processing-disclosure), pokud se uplatňují, a následně pozdrav. Úvodní klip nikdy nenahrazuje oznámení o souhlasu ani sdělení o zpracování pomocí AI, ani když váš klip uvádí, že je hovor nahráván. Zvuk volajícího se během přehrávání klipu a vyzvánění nezpracovává. Vlastní klip se načítá při zahájení hovoru; pokud jej nelze načíst během několika sekund, hovor pokračuje bez něj, takže neúspěšné načtení může pozdrav zpozdit až přibližně o 3 sekundy. Úvodní klip je návrhové nastavení stejně jako ostatní: do živých hovorů se dostane po nasazení. Hlas standardního oznámení o nahrávání: Allison Smith, [CC BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/), upraveno (zkráceno, spojeno, převzorkováno) společností ThunderPhone. ### Zvuk nástroje Zvolte zvuk vytvářený nástrojem pro přehrání zvuku, který lze vyvolat z promptu: - **Žádný** — nástroj není k dispozici. - **Zvonkohra**, **Cinknutí** nebo **Pípnutí** — každý lze zobrazit v náhledu v nástroji pro sestavení. ### Zvuky psaní Povolte **Zvuky psaní**, chcete-li během spuštění vlastního nástroje agentem přehrávat tichý zvuk klávesnice. Nástroje spravované platformou jej nespouštějí. Jakmile je funkce zapnutá, vyberte zvuk. Každý si můžete přehrát v nástroji pro tvorbu: - **Klávesnice a myš** (výchozí): psaní doprovázené klikáním myši, jako když někdo něco vyhledává. - **Mechanická klávesnice**: výrazné, klikavé mechanické klávesy. - **Stolní klávesnice**: plynulé psaní na standardní klávesnici. - **Notebook**: tiché, ploché klávesy notebooku. - **Kancelářská klávesnice**: tichá, tlumená kancelářská klávesnice. - **Tichá místnost**: jemný zvuk místnosti s jednou píšící osobou. ### Řádek při spuštění nástroje Zvolte, zda se má něco říct, když agent volá nástroj: - **Vždy** (výchozí nastavení pro nové agenty): při každém volání nástroje se něco řekne, bez ohledu na to, jak rychle nástroj vrátí výsledek. Pokud agent při volání něco řekl, jeho vlastní slova jsou tímto řádkem. Jinak se krátký řádek napsaný pro volání přehraje, jakmile je připraven, nebo se použije standardní řádek, například „Okamžik, prosím“, pokud to trvá déle než přibližně sekundu. Nástroje, které přehrávají vlastní zvuk nebo přímo ovlivňují hovor (zadávání na klávesnici, zvuky, podržení, přepojení, ukončení hovoru, předání mezi kroky), stále dostanou řádek pouze v případě, že jsou pomalé, stejně jako každý nástroj během toho, kdy se agent nachází v telefonním menu nebo mluví do hlasové schránky. - **Pouze pokud je nástroj pomalý**: krátký řádek se přehraje pouze tehdy, pokud nástroj stále běží přibližně 3 sekundy poté, co agent naposledy promluvil. Agenti vytvoření před zavedením tohoto nastavení si tuto volbu zachovají. - **Nikdy**: ThunderPhone při spuštění nástroje nic neřekne a agent dostane pokyn, aby při volání nástroje nemluvil. Cokoli agent přesto řekne spolu s voláním, se přehraje. Vlastní slova agenta se přehrají vždy, bez ohledu na zvolenou možnost. Volající uslyší nejvýše jeden řádek při spuštění nástroje za tah: řádek, který už v daném tahu zazněl, například slova agenta nebo výplň při pomalé odpovědi, se do něj započítává. ### Aktualizace při dlouhém čekání Ve výchozím nastavení jsou zapnuté. Pokud nástroj stále běží po přibližně 12 sekundách ticha, agent řekne, že na tom stále pracuje, a poté přidá krátký řádek žádající o trpělivost přibližně každých 15 sekund, dokud nedorazí výsledek. Tyto řádky jsou formulovány pro daný hovor: řídí se promptem a personou agenta, dosavadním průběhem konverzace a jazykem hovoru, takže neopakují jednu pevně danou větu. Pokud nelze řádek napsat včas, agent použije standardní řádek, například „Omlouvám se, trvá to o něco déle, než se očekávalo“. Pomalé odpovědi bez nástroje dostanou krátké standardní řádky, například „Jen chvilku“. Vypněte **Aktualizace při dlouhém čekání**, aby agent po větě oznamující spuštění nástroje zůstal zticha, dokud nedorazí výsledek. Pomalé odpovědi bez nástroje pak také neobsahují žádné výplňové věty. Zvuky psaní se stále přehrávají, pokud jsou zapnuté. Nastavení potvrzení ve Storm je samostatné a není ovlivněno. ### Nastavení mají přednost před promptem Řádek při spuštění nástroje a Aktualizace při dlouhém čekání rozhodují o tom, co ThunderPhone říká během běhu nástroje. Text promptu nemůže tyto řádky zastavit ani přidat. Pro agenta, který má během běhu nástrojů zůstat potichu, nastavte **Řádek při spuštění nástroje** na **Nikdy** a vypněte **Aktualizace při dlouhém čekání**, namísto požadavku na ticho v promptu. Kontrola promptu v nástroji pro sestavení upozorní, když prompt požaduje ticho nebo řádek při každém volání nástroje, ale tato nastavení říkají něco jiného. ### Odeslat e-mail Povolte **Odeslat e-mail** a zadejte jednu adresu příjemce, abyste agentovi poskytli nástroj `send_email`. Adresa je pevně nastavena v nastavení agenta. Model vytváří předmět a tělo v prostém textu, nemůže však zvolit ani změnit příjemce. Do promptu agenta uveďte přesné situace, které mají vést k odeslání e-mailu, například odeslání zprávy volajícího po získání jeho jména a čísla pro zpětné volání. Úplné chování nástroje naleznete v části [Integrované nástroje](/cs/guides/built-in-tools). ### Odeslat SMS Povolte **Odeslat SMS**, abyste agentovi poskytli nástroj `send_sms`. Zvolte, ze kterého připojeného čísla VoIP (Twilio nebo Telnyx, s podporou SMS a ověřeného) se má odesílat; čísla zřízená službou ThunderPhone nemohou odesílat SMS. Můžete omezit odesílání pouze na volajícího nebo povolit další příjemce a udržovat seznam povolených schválených čísel. Můžete také povolit šablonu následné SMS pro zprávy odesílané po hovoru. Úplné chování nástroje naleznete v části [Integrované nástroje](/cs/guides/built-in-tools). ### Dodatečný zvukový kontext **Dodatečný zvukový kontext** určuje, kolik nedávného zvuku volajícího se přenáší mezi tahy: - **Automaticky (doporučeno)** používá více nedávného zvuku pro příchozí hovory, hovory z prohlížeče a hovory WebSocket a pouze poslední tah pro odchozí telefonní hovory. - **Zapnuto** zahrnuje několik posledních tahů volajícího, což pomáhá s opravami, hláskováním a shromažďováním dat s mnoha čísly. - **Vypnuto** zahrnuje pouze poslední tah volajícího pro nižší latenci. API Agents také zpřístupňuje pole kompatibility `audio_context_mode` pouze pro Storm: `full` nebo `reduced`. Je oddělené od výše uvedeného třístavového nastavení `additional_audio_context` na řídicím panelu. ### Kdo mluví první Nakonfigurujte příchozí a odchozí hovory samostatně: - **Příchozí:** agent mluví první nebo volající mluví první. - **Odchozí:** agent mluví první nebo volaný mluví první. Chcete-li odstranit úvodní pozdrav agenta, zvolte pro příchozí hovory **Volající mluví první** nebo pro odchozí hovory **Volaný mluví první**. Toto nastavení je užitečné pro odchozí vytáčecí systémy, které musí před zahájením scénáře čekat na osobu nebo telefonní nabídku. ### Zpracování hlasové schránky Zvolte, co se stane, když odchozí hovor dosáhne hlasové schránky: | Možnost | Chování | | --- | --- | | **Nechat rozhodnout agenta** | Prompt a kontext konverzace určují, zda má agent mluvit, nebo zavěsit. | | **Tiše zavěsit** | Ukončit bez zanechání zprávy. | | **Zanechat zprávu a poté zavěsit** | Přehrát nakonfigurovanou zprávu a ukončit hovor. | Zprávy do hlasové schránky mohou obsahovat až **2 000 znaků** a podporují `{agent_name}` a `{org_name}`. Informace o tom, jak se účtuje čas hovoru, naleznete v části [Ceny](/cs/guides/pricing). ### Oznámení o souhlasu Ve výchozím nastavení krátké oznámení na začátku každého hovoru sděluje volajícímu, že hovoří s asistentem AI a že je hovor nahráván. Text oznámení můžete upravit až na **2 000 znaků**; přehrává 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é povolení 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). ### Nahrávat hovory **Nahrávání hovorů** určuje, zda tento agent ukládá zvuk hovoru, přepisy a další obsah hovoru. Aby se hovory nahrávaly, musí být také povoleno nastavení nahrávání pro celou organizaci. Když je nahrávání vypnuté, tyto artefakty se neukládají. Nahrávka pokrývá nanejvýš první 3 hodiny hovoru; delší hovor pokračuje, ale zvuk po 3 hodinách se nenahrává. Viz [Zákony o souhlasu s nahráváním hovorů](/cs/guides/recording-consent-laws). ### Oznámení o zpracování AI Když je nahrávání vypnuté, **Oznámení o zpracování AI** určuje kratší upozornění, že zvuk je zpracováván živě, ale není nahráván. Zvolte **Použít nastavení organizace**, **Přehrávat vždy** nebo **Nepřehrávat**. Vypnutí oznámení vyžaduje potvrzení správce organizace. ### Nepřerušitelná oznámení **Nepřerušitelná oznámení** zůstávají kvůli kompatibilitě viditelná, jejich povolení však nemá žádný účinek. Nechte je vypnutá. Pro požadovaný úvodní text použijte **Oznámení o souhlasu**, které se přehrává před konverzací a nelze jej přerušit. ### Kontroly při tichu Je-li tato možnost povolena, agent po období ticha zkontroluje, zda je volající stále přítomen, opakuje kontrolu až do vašeho 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. ### Délka hovoru a časové limity Pomocí těchto ovládacích prvků zabraňte hromadění času hovoru a telekomunikačních poplatků u zaseknutých nebo neobvykle dlouhých hovorů: - **Minuty ticha před zavěšením:** 1–60 minut. Výchozí hodnota je 10 minut a použije se, když jsou kontroly ticha vypnuté. - **Maximální délka hovoru:** 1–360 minut. Noví agenti začínají na 60 minutách, s výjimkou agentů vytvořených ze šablony Interpreter, kteří začínají bez limitu na úrovni agenta; limit můžete zvýšit, snížit nebo vypnout, abyste neměli limit na úrovni agenta. Agenti vytvoření před zavedením této výchozí hodnoty si ponechávají stávající nastavení. 45 sekund před limitem (čtvrtinu limitu, pokud je kratší než 3 minuty) dostane agent pokyn, aby hovor uzavřel a rozloučil se. - **Limit platformy:** každý hovor skončí po 6 hodinách bez ohledu na nastavení agenta. Agent nejprve obdrží stejné upozornění na ukončení hovoru. - **Délka vyzvánění:** nechte odchozí a přepojené hovory vyzvánět 5–120 sekund. Pokud nastavení ponecháte prázdné, použijí se výchozí hodnoty platformy: 60 sekund pro odchozí hovory, 45 sekund pro teplá přepojení a výchozí hodnota operátora pro studená přepojení. Toto nastavení nemá vliv na vyzvánění příchozích hovorů. ## Karty nástroje pro tvorbu a životní cyklus | Karta nebo akce | Účel | | --- | --- | | **Živě / Hovor** | Mluvte s aktuálním konceptem v prohlížeči a kontrolujte přepis a aktivitu nástrojů. | | **Hovory** | Prohlížejte hovory vyřízené tímto agentem. | | **A/B** | Vytvářejte varianty výzev nebo konfigurace a porovnávejte výsledky v reálném provozu. | | **Simulovat** | Spouštějte uložené nebo ad hoc scénáře volajících s AI proti konceptu. | | **Ověření** | Před nasazením přehrávejte proti konceptu zmrazené tahy ze skutečných hovorů. | | **Historie** | Porovnávejte nasazené revize a obnovte jednu z nich do konceptu. | | **Zahodit** | Vraťte všechna nevyřízená nastavení konceptu na nasazenou verzi. | | **Nasadit** | Atomicky povyšte kompletní koncept a vytvořte revizi. | Pokud jiný editor uloží stejného agenta poté, co jste jej načetli, ThunderPhone zastaví konfliktní uložení nebo nasazení 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** podporuje také 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** ponechá zdroj; **Přesunout** jej odebere z aktuální organizace a vyžaduje přístup správce. - Po potvrzení smažte jednoho agenta nebo hromadně smažte vybrané agenty. ### Export seznamu agentů Vyberte jednoho nebo více agentů a exportujte jejich souhrnná pole jako **CSV** nebo **JSON**. Export nezahrnuje úplné výzvy a nepředstavuje zálohu konfigurace. Kopírování nebo přesun 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 agenta v cílové organizaci zkontrolujte jeho připojení k aplikacím, API, znalostem, MCP, telefonním číslům a widgetům. ## Související stránky Stručný průvodce nástrojem pro tvorbu od začátku do konce. Základní tarify, doplňky, měření hovorů, čísla a jednorázové poplatky. Zmrazte tahy ze skutečných hovorů a přehrajte je před nasazením. Pole požadavků, koncepty, nasazení, verze a příklady.