Dokumentacja ustawień agenta głosowego

Wyjaśnienie wszystkich ustawień agenta głosowego ThunderPhone: poziomów, głosów, języków, potwierdzeń, narzędzi, kolejności mówienia, poczty głosowej, komunikatów o zgodzie, obsługi ciszy, testowania i wdrażania.

Otwórz Agentów głosowych, wybierz agenta i użyj karty Konfiguracja, aby określić, jak brzmi, rozumuje, rozpoczyna połączenia, korzysta z narzędzi, obsługuje ciszę i pocztę głosową oraz kontaktuje się z rozmówcami. Zmiany są automatycznie zapisywane jako wersja robocza; ruch produkcyjny nie zmienia się, dopóki nie wybierzesz Wdróż.

Ta strona zawiera pełną dokumentację panelu. Aby poznać nazwy pól i przykłady żądań, skorzystaj z dokumentacji API agentów.

Prompt i tożsamość#

Nazwa agenta identyfikuje go w całym panelu, raportach, historii połączeń i portalach klientów. Prompt to skrypt działania agenta: persona, fakty biznesowe, wymagane pytania, zasady eskalacji i działania podczas połączenia.

Edytor promptów wyświetla szacowaną liczbę tokenów i oznacza typowe problemy, takie jak pusty prompt, nierozwiązane symbole zastępcze szablonu, brak ścieżki eskalacji lub bardzo długi prompt. Pierwsze 5 000 szacowanych tokenów jest wliczone w cenę; dłuższe prompty korzystają z cen dodatkowych opartych na blokach.

Informacje o regułach routingu, zimnych przekierowaniach i filtrowanych ciepłych przekierowaniach znajdziesz w sekcji Przekierowywanie połączeń.

Poziom modelu#

Storm udostępnia dwa opcjonalne ustawienia:

• Potwierdzenie — Brak zachowuje ciszę podczas przygotowywania pełnej odpowiedzi; Tykanie odtwarza delikatny dźwięk oczekiwania; Słowne wypowiada krótkie potwierdzenie i dodaje 2¢/min. Tekst słownego potwierdzenia może być generowany na podstawie głównego promptu lub podany ręcznie. Niestandardowy prompt potwierdzenia pojawia się tylko wtedy, gdy wybrany tryb Storm obsługuje słowne potwierdzenia; w przeciwnym razie to pole jest niedostępne.
• Dodatkowa inteligencja — dodaje głębsze rozumowanie w przypadku złożonych połączeń oraz 3¢/min.

Kreator stale wyświetla pełny koszt za minutę agenta, obejmujący poziom, ścieżkę głosu/języka, długość promptu, słowne potwierdzenie, dodatkową inteligencję i nadzór.

Głos, tło i języki#

Wybierz głos i odtwórz jego próbkę przed wdrożeniem. Selektor wymaga jedynie, aby wybrany głos obsługiwał język podstawowy. Jeśli włączysz Przełącz na głosy natywne, dodatkowe języki mogą być obsługiwane przez natywne głosy z katalogu tej samej płci. Kombinacje premium są oznaczone odpowiednią dopłatą. Twoje niestandardowe głosy pojawią się w tym samym selektorze, gdy będą gotowe. Zobacz Biblioteka głosów i głosy niestandardowe.

Ścieżka tła może być następująca:

• Brak — bez dźwięku otoczenia.
• Call center — atmosfera centrum obsługi telefonicznej z podglądem w panelu.

Ustaw jeden język główny, a następnie dowolną liczbę dodatkowych języków. Agent automatycznie wykrywa, gdy rozmówca przełącza się na wybrany język, i odpowiada w tym języku. Niektóre kombinacje głosu i języka dodają 3¢/min; zobacz wygenerowany katalog Obsługiwane języki.

Gdy agent ma ustawione Dodatkowe języki, włącz Przełącz na natywne głosy, aby używać głosu z katalogu, który jest natywny dla wykrytego języka i dopasowany pod względem płci. Agent przełącza się z powrotem na skonfigurowany głos dla języka głównego. Jeśli nie ma dostępnego pasującego natywnego głosu, nadal używany jest bieżący głos. Głosy niestandardowe nie są przełączane. Przetestuj każdy język za pomocą Rozmowa, a następnie wybierz Wdróż.

Przełączanie na głosy natywne nie wiąże się z osobną dopłatą. Wybrana kombinacja języka i głosu nadal określa, czy obowiązuje stawka za język premium.

Podłączone funkcje#

Karta Konfiguracja zawiera cztery sekcje funkcji, które można podłączać niezależnie:

Podłączenie jest częścią wersji roboczej i staje się dostępne dla połączeń produkcyjnych po wdrożeniu. Najpierw skonfiguruj zasoby w sekcji Połączenia lub Wiedza, a następnie podłącz je do agenta.

Punkty końcowe telefoniczne i internetowe#

W sekcji Numery telefonów podłącz istniejący numer, uzyskaj numer ThunderPhone lub zaimportuj numer przez połączenie VoIP. Numer może korzystać z różnych agentów dla połączeń przychodzących i wychodzących.

W sekcji Widżety internetowe podłącz widżet, aby odwiedzający mogli rozmawiać z agentem na stronie. Dostępność widżetu można także włączyć lub wyłączyć w ramach konfiguracji agenta.

Strefa czasowa#

Strefa czasowa pod numerami telefonów określa, co agent uznaje za „teraz”: podaje datę i godzinę, oferuje terminy wizyt oraz ustala „dzisiaj” i „jutro” w tej strefie. Używa jej również dla godzin pracy tego agenta w raportach.

Nowy agent zaczyna ze strefą czasową Twojej organizacji, a jeśli organizacja jej nie ma, ze strefą Twojego komputera. Zmień ją, jeśli Twoi rozmówcy są gdzie indziej. Gdy numer telefonu agenta znajduje się w innej strefie niż wybrana przez Ciebie, kreator informuje o tym i proponuje zmianę.

Agent bez strefy czasowej (starszy agent lub utworzony przez API bez timezone) używa strefy numeru, na który przychodzi połączenie, następnie strefy numerów agenta, potem organizacji, a na końcu czasu pacyficznego USA. Kreator pokazuje, która to strefa, i prosi o jej potwierdzenie albo wybór jednej, gdy numery nie pozwalają jej ustalić (numer bezpłatny lub numery w różnych strefach).

Gdy jeden agent obsługuje kontakty w kilku strefach czasowych, przekaż strefę z każdym połączeniem: timezone w POST /v1/call lub w odpowiedzi webhooka konfiguracji.

Jeśli Twój agent nie ma jeszcze strefy czasowej#

Nowi agenci wymagają ustawienia strefy czasowej. Starsi agenci nadal mogą jej nie mieć.

Jeśli starszy agent nie ma strefy czasowej, ThunderPhone najpierw używa własnego ustawienia agenta, jeśli istnieje, następnie ustawienia Twojej organizacji, a potem strefy czasowej wywnioskowanej z numerów telefonu agenta. Jeśli to nadal nie rozstrzyga sprawy, system domyślnie używa Los Angeles. Kreator wyświetla ustaloną strefę i prosi o jej potwierdzenie lub wybranie strefy, gdy numery nie pozwalają jej ustalić.

Zaawansowane zachowanie połączeń#

Rozwiń Zaawansowane na dole sekcji Konfiguracja, aby uzyskać dostęp do poniższych opcji.

Nadzór#

Po włączeniu drugi monitor AI sprawdza każdą turę agenta względem instrukcji i może interweniować bezgłośnie. Nadzór dodaje 4¢/min i nie jest dostępny w Bolt.

Sygnał połączenia#

Odtwórz krótki sygnał bezpośrednio po połączeniu i zanim którakolwiek ze stron zacznie mówić.

Klip wprowadzający#

Odtwórz wcześniej nagrany klip na początku połączeń przychodzących, a następnie sygnały dzwonienia, aby linia brzmiała jak firmowa linia telefoniczna, zanim agent odbierze. Jest odtwarzany podczas przychodzących połączeń telefonicznych oraz testowych połączeń Rozmowa (w przeglądarce) w kreatorze. Nie jest odtwarzany podczas połączeń wychodzących, testowych połączeń AI, połączeń z widżetu internetowego ani połączeń Realtime API.

• Wyłączone (domyślnie) — agent odbiera od razu.
• Powiadomienie o nagrywaniu — nagrany głos mówi: „To połączenie może być monitorowane lub nagrywane w celach zapewnienia jakości”. Odsłuchaj je w kreatorze.
• Własne nagranie — prześlij plik audio (MP3, WAV, M4A oraz inne formaty, które może odtworzyć Twoja przeglądarka) albo nagraj go w przeglądarce. Klipy mogą trwać od 0,5 do 15 sekund. Kreator konwertuje klip przed jego przesłaniem, a Ty możesz go odtworzyć lub usunąć.

Dzwonienie po klipie wprowadzającym określa, ile amerykańskich sygnałów dzwonienia zostanie odtworzonych po klipie: Wyłączone, 1 sygnał (domyślnie) lub 2 sygnały.

Kolejność na początku połączenia jest następująca: ton połączenia (jeśli jest włączony), klip wprowadzający, sygnały dzwonienia, następnie komunikat o zgodzie lub informacja o przetwarzaniu przez AI, jeśli mają zastosowanie, a potem powitanie. Klip wprowadzający nigdy nie zastępuje komunikatu o zgodzie ani informacji o przetwarzaniu przez AI, nawet gdy Twój klip informuje, że połączenie jest nagrywane. Dźwięk rozmówcy nie jest przetwarzany podczas odtwarzania klipu i sygnałów dzwonienia. Niestandardowy klip jest pobierany po rozpoczęciu połączenia; jeśli nie można go załadować w ciągu kilku sekund, połączenie jest kontynuowane bez niego, więc nieudane ładowanie może opóźnić powitanie o maksymalnie około 3 sekundy.

Klip wprowadzający jest ustawieniem roboczym, tak jak pozostałe: zaczyna obowiązywać w połączeniach na żywo po wdrożeniu.

Dźwięk narzędzia#

Wybierz dźwięk odtwarzany przez wywoływane z promptu narzędzie dźwiękowe:

• Brak — narzędzie nie jest dostępne.
• Dzwonek, Ding lub Sygnał dźwiękowy — każdy z nich można odsłuchać w kreatorze.

Dźwięki pisania#

Włącz Dźwięki pisania, aby odtwarzać cichy dźwięk klawiatury, gdy agent uruchamia narzędzie niestandardowe. Narzędzia zarządzane przez platformę go nie wywołują.

Po włączeniu wybierz dźwięk. Każdy z nich można odsłuchać w kreatorze:

• Klawiatura i mysz (domyślnie): pisanie z kliknięciami myszy, jak podczas wyszukiwania informacji.
• Klawiatura mechaniczna: wyraziste, klikające klawisze mechaniczne.
• Klawiatura stacjonarna: równomierne pisanie na standardowej klawiaturze.
• Laptop: miękkie, płaskie klawisze laptopa.
• Klawiatura biurowa: cicha, stonowana klawiatura biurowa.
• Cichy pokój: delikatny odgłos pomieszczenia z jedną osobą piszącą na klawiaturze.

Komunikat przy uruchomieniu narzędzia#

Wybierz, czy agent ma coś mówić, gdy wywołuje narzędzie:

• Zawsze (domyślnie dla nowych agentów): przy każdym wywołaniu narzędzia jest odtwarzany komunikat, niezależnie od tego, jak szybko narzędzie zwróci wynik. Jeśli agent mówił wraz z wywołaniem, jego własne słowa są tym komunikatem. W przeciwnym razie krótki komunikat przygotowany dla wywołania jest odtwarzany, gdy tylko będzie gotowy, lub standardowy komunikat, taki jak „Proszę chwilę poczekać”, jeśli trwa to dłużej niż około sekundę. Narzędzia, które odtwarzają własny dźwięk lub działają bezpośrednio na połączeniu (wprowadzanie z klawiatury, dźwięki, wstrzymanie, przekazania, zakończenie połączenia, przekazania między krokami), nadal otrzymują komunikat tylko, jeśli działają wolno, podobnie jak każde narzędzie, gdy agent jest w menu telefonicznym lub rozmawia z pocztą głosową.
• Tylko jeśli narzędzie działa wolno: krótki komunikat jest odtwarzany tylko wtedy, gdy narzędzie nadal działa około 3 sekundy po ostatniej wypowiedzi agenta. Agenci utworzeni przed wprowadzeniem tego ustawienia zachowują ten wybór.
• Nigdy: ThunderPhone nic nie mówi po uruchomieniu narzędzia, a agent otrzymuje instrukcję, aby nie mówić podczas wywoływania narzędzia. Wszystko, co agent mimo to powie wraz z wywołaniem, zostanie odtworzone.

Własne słowa agenta są zawsze odtwarzane, niezależnie od wybranej opcji. Rozmówca słyszy najwyżej jeden komunikat przy uruchomieniu narzędzia na turę: komunikat wypowiedziany już w tej turze, taki jak słowa agenta lub wypełniacz przy wolnej odpowiedzi, jest do niego zaliczany.

Aktualizacje podczas długiego oczekiwania#

Domyślnie włączone. Gdy narzędzie nadal działa po około 12 sekundach ciszy, agent mówi, że wciąż nad tym pracuje, a następnie co około 15 sekund dodaje krótki komunikat z prośbą o cierpliwość, aż nadejdzie wynik. Te komunikaty są formułowane na potrzeby połączenia: uwzględniają prompt i personę agenta, dotychczasową rozmowę oraz język połączenia, więc nie powtarzają jednego stałego zdania. Jeśli nie można przygotować komunikatu na czas, agent używa standardowego, takiego jak „Przepraszam, to zajmuje trochę więcej czasu, niż oczekiwano”. Wolne odpowiedzi bez narzędzia otrzymują krótkie standardowe komunikaty, takie jak „Chwileczkę”.

Wyłącz Aktualizacje przy długim oczekiwaniu, aby zachować ciszę po komunikacie o rozpoczęciu narzędzia, aż do otrzymania wyniku. Wolne odpowiedzi bez narzędzia również nie otrzymają wtedy żadnych wypełniaczy. Dźwięki pisania będą nadal odtwarzane, jeśli są włączone. Ustawienie potwierdzeń Storm jest niezależne i nie ma na nie wpływu.

Ustawienia mają pierwszeństwo przed promptem#

Komunikat przy uruchomieniu narzędzia i Aktualizacje podczas długiego oczekiwania określają, co ThunderPhone mówi podczas działania narzędzia. Tekst promptu nie może zatrzymać ani dodać tych komunikatów. W przypadku agenta, który ma milczeć podczas działania narzędzi, ustaw Komunikat przy uruchomieniu narzędzia na Nigdy i wyłącz Aktualizacje podczas długiego oczekiwania, zamiast prosić o ciszę w prompcie. Kontrola promptu w kreatorze ostrzega, gdy prompt prosi o ciszę lub o komunikat przy każdym wywołaniu narzędzia, a te ustawienia wskazują inaczej.

Wyślij e-mail#

Włącz Wyślij e-mail i podaj jeden adres odbiorcy, aby udostępnić agentowi narzędzie send_email. Adres jest stały w ustawieniach agenta. Model tworzy temat i treść w postaci zwykłego tekstu, ale nie może wybrać ani zmienić odbiorcy. W prompcie agenta określ dokładne sytuacje, w których należy wysłać e-mail, na przykład wysłanie wiadomości rozmówcy po zebraniu jego imienia i numeru do oddzwonienia.

Pełny opis działania narzędzia znajdziesz w sekcji Wbudowane narzędzia.

Calculator#

Włącz Calculator, aby udostępnić agentowi narzędzie calculate. Agent używa go do dokładnego sumowania wartości zamówień, opłat i reszty zamiast wykonywać obliczenia samodzielnie. Domyślnie jest wyłączone; włącz je dla agentów podających ceny. Nie trzeba zmieniać promptu.

Pełny opis działania narzędzia znajdziesz w sekcji Wbudowane narzędzia.

Wyślij SMS#

Włącz Wyślij SMS, aby udostępnić agentowi narzędzie send_sms.

Wybierz, z którego połączonego numeru VoIP (Twilio lub Telnyx, obsługującego SMS i zweryfikowanego) wysyłać wiadomości; numery udostępnione przez ThunderPhone nie mogą wysyłać SMS-ów. Możesz ograniczyć wysyłanie wyłącznie do rozmówcy albo zezwolić na innych odbiorców i prowadzić listę dozwolonych zatwierdzonych numerów. Możesz też włączyć szablon wiadomości SMS wysyłanej po połączeniu.

Pełny opis działania narzędzia znajdziesz w sekcji Wbudowane narzędzia.

Dodatkowy kontekst audio#

Dodatkowy kontekst audio określa, ile ostatniego dźwięku rozmówcy jest przenoszone między turami:

• Automatycznie (zalecane) wykorzystuje więcej ostatniego dźwięku w przypadku połączeń przychodzących, przeglądarkowych i WebSocket, a w przypadku wychodzących połączeń telefonicznych tylko ostatnią turę.
• Włączone uwzględnia kilka ostatnich tur rozmówcy, aby ułatwić poprawki, literowanie i zbieranie danych zawierających dużo liczb.
• Wyłączone uwzględnia tylko ostatnią turę rozmówcy, aby zmniejszyć opóźnienia.

Interfejs Agents API udostępnia również pole zgodności audio_context_mode, dostępne tylko w Storm: full lub reduced. Jest ono niezależne od opisanego powyżej trójstanowego ustawienia additional_audio_context w panelu.

Kto mówi pierwszy#

Skonfiguruj połączenia przychodzące i wychodzące osobno:

• Przychodzące: agent mówi pierwszy albo rozmówca mówi pierwszy.
• Wychodzące: agent mówi pierwszy albo osoba odbierająca mówi pierwsza.

Aby usunąć początkowe powitanie agenta, wybierz Rozmówca mówi pierwszy dla połączeń przychodzących lub Osoba odbierająca mówi pierwsza dla połączeń wychodzących.

To ustawienie jest przydatne w automatycznych systemach wybierania numerów, które muszą czekać na osobę lub menu telefoniczne przed rozpoczęciem skryptu.

Obsługa poczty głosowej#

Wybierz, co ma się stać, gdy połączenie wychodzące trafi na pocztę głosową:

Wiadomości poczty głosowej mogą zawierać do 2 000 znaków i obsługują {agent_name} oraz {org_name}. Informacje o sposobie naliczania czasu połączenia znajdziesz w sekcji Cennik.

Komunikat o zgodzie#

Domyślnie krótki komunikat na początku każdego połączenia informuje rozmówcę, że rozmawia z asystentem AI i że połączenie jest nagrywane. Możesz edytować tekst komunikatu, do 2 000 znaków; jest on odtwarzany dosłownie w języku agenta.

Wyłączenie komunikatu dla kwalifikującego się agenta wymaga od administratora organizacji potwierdzenia, że organizacja przekaże wszelkie prawnie wymagane informacje i uzyska wszelkie prawnie wymagane zgody. Ponowne włączenie, a następnie wyłączenie komunikatu wymaga nowego potwierdzenia. Przed zmianą tego ustawienia zapoznaj się z przewodnikiem po przepisach dotyczących zgody na nagrywanie.

Nagrywaj połączenia#

Nagrywaj połączenia określa, czy ten agent przechowuje dźwięk połączeń, transkrypcje i inne treści połączeń. Aby nagrywanie mogło się odbywać, musi być również włączone ustawienie nagrywania dla całej organizacji. Gdy nagrywanie jest wyłączone, te materiały nie są przechowywane. Nagranie obejmuje maksymalnie pierwsze 3 godziny połączenia; dłuższe połączenie trwa nadal, ale dźwięk po upływie 3 godzin nie jest nagrywany. Zobacz Przepisy dotyczące zgody na nagrywanie połączeń.

Informacja o przetwarzaniu przez AI#

Gdy nagrywanie jest wyłączone, Informacja o przetwarzaniu przez AI określa krótszy komunikat, że dźwięk jest przetwarzany na żywo, ale nie jest nagrywany. Wybierz Użyj ustawienia organizacji, Zawsze odtwarzaj lub Nie odtwarzaj. Wyłączenie komunikatu wymaga potwierdzenia administratora organizacji.

Komunikaty, których nie można przerwać#

Komunikaty, których nie można przerwać pozostają widoczne ze względów zgodności, ale ich włączenie nie ma żadnego efektu. Pozostaw je wyłączone. W przypadku wymaganego komunikatu otwierającego użyj Komunikat o zgodzie, który jest odtwarzany przed rozmową i nie można go przerwać.

Sprawdzanie ciszy#

Po włączeniu agent sprawdza, czy rozmówca nadal jest obecny po okresie ciszy, powtarza sprawdzenie do ustawionego limitu, a następnie się rozłącza:

• Sekundy przed sprawdzeniem: 10–120 sekund.
• Maksymalna liczba sprawdzeń: 1–10.

Wartości domyślne to 15 sekund i 3 sprawdzenia.

Długość połączenia i limity czasu#

Użyj tych opcji, aby zapobiec naliczaniu czasu połączeń i opłat telekomunikacyjnych przez zawieszone lub wyjątkowo długie połączenia:

• Minuty ciszy przed rozłączeniem: 1–60 minut. Wartość domyślna to 10 minut i ma zastosowanie, gdy kontrola ciszy jest wyłączona.
• Maksymalny czas trwania połączenia: 1–360 minut. Nowi agenci głosowi zaczynają z limitem 60 minut, z wyjątkiem agentów utworzonych z szablonu Interpreter, którzy zaczynają bez limitu na poziomie agenta; zwiększ go, zmniejsz lub wyłącz, aby nie ustawiać limitu na poziomie agenta. Agenci utworzeni przed wprowadzeniem tej wartości domyślnej zachowują istniejące ustawienie. 45 sekund przed limitem (jedną czwartą limitu, gdy wynosi on mniej niż 3 minuty) agent otrzymuje polecenie, aby zakończyć rozmowę i się pożegnać.
• Limit platformy: każde połączenie kończy się po 6 godzinach, niezależnie od ustawienia agenta. Agent najpierw otrzymuje takie samo ostrzeżenie o zakończeniu rozmowy.
• Czas dzwonienia: zezwól, aby połączenia wychodzące i przekazywane dzwoniły przez 5–120 sekund. Pozostaw to ustawienie nieokreślone, aby użyć wartości domyślnych platformy: 60 sekund dla połączeń wychodzących, 45 sekund dla ciepłych przekazań oraz wartości domyślnej operatora dla zimnych przekazań. To ustawienie nie wpływa na dzwonienie przy połączeniach przychodzących.

Karty kreatora i cykl życia#

Jeśli inny edytor zapisze tego samego agenta po jego wczytaniu, ThunderPhone zatrzyma powodujący konflikt zapis lub wdrożenie i poprosi o odświeżenie zamiast nadpisywać jego zmiany.

Zarządzanie agentami z listy#

Strona Agenci głosowi obsługuje również działania dotyczące cyklu życia na poziomie organizacji:

• Duplikuj agenta jako nowy punkt wyjścia w tej samej organizacji.
• Przenieś agenta do innej organizacji, do której należysz. Kopiuj zachowuje źródło; Przenieś usuwa je z bieżącej organizacji i wymaga dostępu administratora.
• Usuń jednego agenta lub zbiorczo usuń wybranych agentów po potwierdzeniu.

Eksport listy agentów#

Wybierz jednego lub więcej agentów i wyeksportuj ich pola podsumowania jako CSV lub JSON. Eksport nie obejmuje pełnych promptów i nie jest kopią zapasową konfiguracji.

Kopiowanie lub przenoszenie agenta między organizacjami nie przyznaje po cichu organizacji docelowej dostępu do połączeń dostępnych wyłącznie w organizacji źródłowej. Przed wdrożeniem skopiowanego agenta w organizacji docelowej sprawdź jego powiązania z aplikacją, API, bazą wiedzy, MCP, numerem telefonu i widżetem.

Powiązane strony#