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

# Dokumentacja ustawień agenta głosowego

> Omówienie 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 jego karty **Konfiguracja**, aby określić,
jak brzmi, rozumuje, rozpoczyna połączenia, używa narzędzi, obsługuje ciszę i pocztę głosową
oraz dociera do rozmówców. Zmiany są automatycznie zapisywane w wersji roboczej; ruch produkcyjny nie
zmieni się, dopóki nie wybierzesz **Wdróż**.

Ta strona zawiera kompletny opis pulpitu. Nazwy pól i przykłady
żądań znajdziesz w [dokumentacji API agentów](/api-reference/agents).

## Prompt i tożsamość

Nazwa agenta identyfikuje go w całym pulpicie, raportach, Historii połączeń
i portalach klientów. Prompt to skrypt działania agenta: persona,
informacje o firmie, wymagane pytania, zasady eskalacji i działania podczas połączeń.

Edytor promptów wyświetla szacunkową liczbę tokenów i wskazuje typowe problemy, takie jak
pusty prompt, nierozwiązane symbole zastępcze szablonu, brak ścieżki eskalacji lub
bardzo długi prompt. Pierwsze **5 000 szacunkowych tokenów** jest wliczone w cenę; dłuższe
prompty podlegają [dopłacie blokowej](/pl/guides/pricing).

<Tip>
  Przekierowania, naciskanie klawiszy, zachowanie podczas oczekiwania i decyzje o rozłączeniu można zapisać
  bezpośrednio w prompcie. Dołącz narzędzia API, aplikacji, MCP lub wiedzy, gdy
  agent potrzebuje danych zewnętrznych albo możliwości wykonania działań.
</Tip>

## Poziom modelu

| Poziom    | Cena podstawowa | Najlepsze zastosowanie                               |
| --------- | --------------: | ---------------------------------------------------- |
| **Spark** |          2¢/min | Proste połączenia, przy których liczy się koszt.     |
| **Bolt**  |          5¢/min | Szybkie odpowiedzi i zrównoważone codzienne procesy. |
| **Storm** |          9¢/min | Złożone instrukcje, rozumienie audio i rozumowanie.  |

Storm udostępnia dwa opcjonalne ustawienia:

* **Potwierdzenie** — **Brak** oznacza ciszę podczas przygotowywania pełnej odpowiedzi;
  **Tykanie** odtwarza cichy dźwięk oczekiwania; **Słowne** wypowiada krótkie potwierdzenie
  i dodaje **2¢/min**. Tekst słownego potwierdzenia można wygenerować na podstawie głównego promptu lub
  podać ręcznie przez API.
* **Dodatkowa inteligencja** — zapewnia głębsze rozumowanie przy złożonych połączeniach i
  kosztuje dodatkowe **3¢/min**.

Kreator stale wyświetla **całkowity koszt za minutę** agenta, uwzględniają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 oferuje tylko
głosy zgodne ze wszystkimi wybranymi językami i oznacza kombinacje premium
wraz z dopłatą. Po przygotowaniu niestandardowe głosy pojawią się w tym samym selektorze.
Zobacz [Biblioteka głosów i głosy niestandardowe](/pl/guides/voice-library).

**Ścieżka tła** może być:

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

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 nim. Niektóre kombinacje głosu i języka dodają **3¢/min**; zobacz
wygenerowany katalog [Obsługiwane języki](/pl/guides/supported-languages).

## Połączone funkcje

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

| Sekcja                  | Zastosowanie                                                                                    |
| ----------------------- | ----------------------------------------------------------------------------------------------- |
| **Połączone aplikacje** | Zatwierdzone operacje w Google Calendar, Google Sheets, Slack, HubSpot, Salesforce lub Cal.com. |
| **Połączenia API**      | Własne punkty końcowe HTTP opisane jako funkcje możliwe do wywołania.                           |
| **Wiedza**              | Pliki lub treści internetowe, które agent może przeszukiwać podczas połączenia.                 |
| **Serwery MCP**         | Narzędzia w pamięci podręcznej wykryte na zdalnych serwerach Model Context Protocol.            |

Dołą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 dołącz je do agenta.

## Punkty końcowe telefonu i internetu

W sekcji **Numery telefonów** dołącz istniejący numer, udostępnij numer demonstracyjny lub
zaimportuj numer przez połączenie VoIP. Numer może używać różnych agentów
dla połączeń przychodzących i wychodzących.

W sekcji **Widżety internetowe** dołącz widżet, aby użytkownicy mogli rozmawiać z agentem na
stronie. Dostępność widżetu można także włączać lub wyłączać w ramach konfiguracji
agenta.

## Zaawansowane zachowanie połączeń

Rozwiń **Zaawansowane** na dole Config, aby uzyskać dostęp do poniższych ustawień.

### Nadzór

Po włączeniu drugi monitor AI sprawdza każdą turę agenta pod kątem zgodności z
instrukcjami i może dyskretnie interweniować. Nadzór zwiększa koszt o **8 centów/min** i nie jest
dostępny w Bolt.

### Sygnał połączenia

Odtwórz krótki sygnał natychmiast po nawiązaniu połączenia i zanim którakolwiek strona
zacznie mówić.

### Dźwięk narzędzia

Wybierz dźwięk emitowany przez narzędzie dźwiękowe wywoływane przez prompt:

* **Brak** — narzędzie nie jest dostępne.
* **Dzwonek**, **Ding** lub **Beep** — każdy dźwięk można odsłuchać w kreatorze.

### Kto mówi pierwszy

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

* **Przychodzące:** agent mówi pierwszy lub rozmówca mówi pierwszy.
* **Wychodzące:** agent mówi pierwszy lub odbiorca połączenia mówi pierwszy.

To ustawienie jest przydatne w przypadku automatycznych wybieraków połączeń wychodzących, 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ą:

| Opcja                                         | Zachowanie                                                                  |
| --------------------------------------------- | --------------------------------------------------------------------------- |
| **Pozwól agentowi zdecydować**                | Prompt i kontekst rozmowy określają, czy agent ma mówić, czy się rozłączyć. |
| **Rozłącz bez komunikatu**                    | Zakończ bez pozostawiania wiadomości.                                       |
| **Zostaw wiadomość, a następnie się rozłącz** | Wypowiedz skonfigurowaną wiadomość i zakończ połączenie.                    |

Wiadomości poczty głosowej mogą zawierać do **2000 znaków** i obsługują
`{agent_name}` oraz `{org_name}`. Informacje o sposobie naliczania czasu
połączenia znajdziesz w sekcji [Cennik](/pl/guides/pricing).

### 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 **2000 znaków**; jest on odtwarzany dosłownie
w języku agenta.

Wyłączenie komunikatu dla kwalifikującego się agenta wymaga, aby administrator organizacji
potwierdził, że organizacja przekaże wszelkie wymagane prawem informacje i
uzyska wszelkie wymagane prawem 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](/pl/guides/recording-consent-laws).

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

## Karty kreatora i cykl życia

| Karta lub działanie   | Cel                                                                                                 |
| --------------------- | --------------------------------------------------------------------------------------------------- |
| **Na żywo / Rozmowa** | Rozmawiaj z bieżącą wersją roboczą w przeglądarce oraz sprawdzaj transkrypcję i aktywność narzędzi. |
| **Połączenia**        | Przeglądaj połączenia obsłużone przez tego agenta.                                                  |
| **A/B**               | Twórz warianty promptów lub konfiguracji i porównuj wyniki na żywo.                                 |
| **Symuluj**           | Uruchamiaj zapisane lub doraźne scenariusze rozmówców AI na wersji roboczej.                        |
| **Walidacja**         | Odtwarzaj zamrożone tury rzeczywistych połączeń na wersji roboczej przed wdrożeniem.                |
| **Historia**          | Porównuj wdrożone wersje i przywracaj jedną z nich do wersji roboczej.                              |
| **Odrzuć**            | Przywróć każde oczekujące ustawienie wersji roboczej do wdrożonej wersji.                           |
| **Wdróż**             | Atomowo promuj kompletną wersję roboczą i utwórz wersję.                                            |

Jeśli inny edytor zapisze tego samego agenta po jego załadowaniu przez Ciebie, ThunderPhone zatrzyma
kolidujący zapis lub wdrożenie i poprosi o odświeżenie zamiast nadpisywać
ich zmiany.

## Zarządzanie agentami z listy

Strona **Agenci głosowi** obsługuje również działania związane z cyklem ż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.
* Wybierz co najmniej jednego agenta i wyeksportuj wyświetlaną konfigurację jako
  **CSV** lub **JSON**.
* Usuń jednego agenta lub zbiorczo usuń wybranych agentów po potwierdzeniu.

Kopiowanie lub przenoszenie agenta między organizacjami nie przyznaje automatycznie
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, numerami telefonów i widżetami.

## Powiązane strony

<CardGroup cols={2}>
  <Card title="Utwórz swojego pierwszego agenta" icon="robot" href="/pl/guides/build-an-agent">
    Zwięzły przewodnik po tworzeniu agenta od początku do końca.
  </Card>

  <Card title="Cennik" icon="coins" href="/pl/guides/pricing">
    Plany podstawowe, dodatki, rozliczanie połączeń, numery i opłaty jednorazowe.
  </Card>

  <Card title="Zestawy walidacyjne" icon="list-check" href="/pl/guides/validation-sets">
    Zapisuj tury z rzeczywistych połączeń i odtwarzaj je przed wdrożeniem.
  </Card>

  <Card title="API agentów" icon="code" href="/api-reference/agents">
    Pola żądań, wersje robocze, wdrożenia, wersje i przykłady.
  </Card>
</CardGroup>
