> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brosbots.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Szablony onboardingowe
> Gotowe szablony branżowe z prowadzonym onboardingiem, które generują kompletnego agenta głosowego w kilkadziesiąt sekund.
## Wprowadzenie
Brosbots udostępnia **gotowe szablony branżowe**, dzięki którym stworzysz
produkcyjnego agenta głosowego w mniej niż minutę. Zamiast pisać prompty od
zera: wybierasz szablon dla swojej branży, wypełniasz krótki formularz,
zaznaczasz możliwości agenta - a platforma generuje **w pełni
skonfigurowanego agenta**: prompt systemowy, pierwszą wypowiedź, przepływ
rozmowy i włączone narzędzia.
Twoje odpowiedzi z formularza są **wplatane bezpośrednio w prompt** - nie
dostajesz półproduktu z placeholderami do uzupełnienia później.
## Wybór szablonu
Wejdź w **Utwórz agenta**, aby otworzyć galerię szablonów. Możesz:
* **wyszukiwać** szablony po nazwie, branży lub tagu,
* filtrować po **branży** (lista) albo **chipach kategorii**,
* kliknąć **Użyj szablonu**, aby przejść do prowadzonej konfiguracji,
* wkleić adres strony WWW w banerze nad galerią albo kliknąć **Generuj z AI**,
a AI samo dobierze szablon i wypełni formularz (zob.
[Generowanie agenta z AI](/pl/voice-agent/ai-generator)),
* kliknąć **Mam skrypt rozmowy**, jeśli masz już skrypt dla handlowców
(zob. [Agent ze skryptu rozmowy](/pl/voice-agent/call-script)),
* zacząć od **pustego agenta**.
### Dostępne szablony
| Szablon | Opis | Kluczowe funkcje |
| - | - | - |
| **Restauracja** | Rezerwacje stolików, pytania o menu, zamówienia. | Rezerwacje, pytania o menu i alergeny, zbieranie danych rezerwacji |
| **Agencja / Firma usługowa** | Zapytania klientów i umawianie konsultacji. | Kwalifikacja leadów, prezentacja usług, umawianie konsultacji |
| **Ochrona zdrowia** | Umawianie wizyt i obsługa pacjentów. | Terminarz wizyt, dane pacjenta (domyślnie imię i nazwisko, telefon, powód wizyty i termin; NFZ czy prywatnie, PESEL i data urodzenia tylko po zaznaczeniu), empatyczny ton; przed utworzeniem potwierdzasz, że agent nie zbiera danych o zdrowiu ([Dane medyczne](/pl/features/medical-data)) |
| **Salon samochodowy** | Pytania o pojazdy, jazdy próbne, serwis. | Pytania o ofertę, jazdy próbne, preferencje kupujących |
| **Warsztat samochodowy** | Diagnostyka, serwis i naprawy aut. | Umawianie auta (marka i model, numer rejestracyjny, co się dzieje), ceny wyłącznie z Waszego cennika, opcjonalnie wymiana opon, pytania o auto w naprawie i awarie; bez diagnozy przez telefon, bez wiążącej ceny naprawy, nigdy „auto jest gotowe” |
| **Wsparcie klienta** | Zgłoszenia, diagnoza problemów, eskalacja. | Diagnoza, tworzenie zgłoszeń, przekazanie do człowieka |
| **Salon beauty** | Rezerwacje zabiegów i pytania o usługi. | Pytania o zabiegi, rezerwacje u specjalistów, preferencje klientek |
| **Siłownia / klub fitness** | Treningi próbne, karnety, zajęcia. | Umawianie treningów próbnych, pytania o karnety i zajęcia, prośby o zawieszenie i wypowiedzenie przekazywane obsłudze, żadnych porad zdrowotnych |
| **Asystent osobisty** | Dzwoni *do Ciebie* codziennie z pocztą, kalendarzem i sprawami w toku. | [Codzienna odprawa](/pl/voice-agent/personal-assistant), skrzynka IMAP, kalendarz iCal, pamięć między rozmowami |
| **Sklep internetowy** | Status zamówień, zwroty i reklamacje. | Podgląd zamówień i stanów w BaseLinkerze, Shopify, WooCommerce lub na Allegro, przyjmowanie zwrotów i reklamacji według Waszych zasad |
| **Sekretarka po godzinach** | Odbiera, gdy firma jest zamknięta, i przyjmuje wiadomość. | Imię, numer, sprawa i pilność; wiadomość SMS-em na numer właściciela albo e-mailem na adres zespołu |
| **Przypomnienie o wizycie** | Kampania: potwierdza zbliżające się wizyty. | Potwierdzenie, zmiana terminu (z kalendarzem tylko wolne godziny) albo odwołanie |
| **Potwierdzenie zamówienia za pobraniem** | Kampania: potwierdza zamówienie przed wysyłką. | Produkty, kwota przy odbiorze i adres dostawy; zmiany i anulowania zapisane dla sklepu |
| **Przypomnienie o płatności** | Kampania: uprzejmie przypomina o nieopłaconej fakturze. | Termin płatności, ponowne przesłanie faktury, żadnych gróźb ani nacisku |
| **Ankieta satysfakcji (NPS)** | Kampania: ocena od 0 do 10 i jej powód. | Ocena, powód, co poprawić; domyślnie zapis każdej rozmowy do Google Sheets |
### Szablony kampanii
Przypomnienie o wizycie, potwierdzenie zamówienia za pobraniem, przypomnienie
o płatności i ankieta NPS dzwonią do osób z listy
[kampanii](/pl/features/campaigns), więc mają domyślnie ustawiony kierunek
**wychodzący**. To, co różni jedną rozmowę od drugiej - data wizyty, numer
zamówienia, kwota faktury - agent bierze z kolumn listy kontaktów. Prompt
odwołuje się do nich jako zmiennych szablonowych z wartością zastępczą, np.
`{{amount_due | fallback:(brak na liście)}}`, i przy każdym połączeniu
podstawia wartości z wiersza danej osoby.
Imię i nazwisko jest rozpoznawane samo (kolumna `Imię i nazwisko`, `Imię`,
`name` i podobne). Pozostałe kolumny nazwij tak, jak w tabeli:
| Szablon | Kolumny |
| - | - |
| **Przypomnienie o wizycie** | `appointment_date`, `appointment_time`, `appointment_type` |
| **Potwierdzenie zamówienia za pobraniem** | `order_number`, `order_items`, `order_total`, `delivery_address` |
| **Przypomnienie o płatności** | `company` (albo `Firma`), `invoice_number`, `amount_due`, `due_date` |
| **Ankieta satysfakcji (NPS)** | `survey_subject` - czego dotyczy ankieta, np. „wizyta 3 października” |
Gdy kolumny brakuje, agent widzi „brak na liście” i ma zakaz zgadywania:
zamiast wymyślać kwotę czy godzinę, mówi, że zespół odezwie się z tą
informacją. Agent nie czyta też sam wizyt z kalendarza - lista na kampanię to
wiersze, które przygotujesz Ty. Z podłączonym kalendarzem agent może za to
sprawdzić wolne terminy i zarezerwować nowy, gdy ktoś przekłada wizytę;
poprzedni termin usuwa zespół.
Przypomnienie o płatności zaczyna rozmowę samą nazwą firmy i o fakturze mówi
dopiero wtedy, gdy ma pewność, że rozmawia z właściwą osobą. Nigdy nie
wspomina o sądzie, komorniku, windykacji, rejestrach dłużników ani odsetkach i
zgadza się tylko na to, co wpiszesz w polu **Na co agent może się zgodzić**.
## Formularz konfiguracji
Formularz to kreator krok po kroku: jeden panel naraz, przyciski **Wstecz**
i **Dalej**, a nad nimi lista sekcji, w którą można kliknąć, żeby przejść od
razu do wybranego panelu. Przechodzenie tam i z powrotem niczego nie kasuje -
odpowiedzi zostają do momentu utworzenia agenta. Cztery sekcje opisane niżej
to właśnie te panele, przy czym **Co potrafi Twój agent** jest rozbite na
kilka, żeby żaden panel nie był za długi.
### 1. Podstawy
Fakty o firmie, na których opiera się agent. Na górze formularza znajdziesz
kartę **„Wypełnij automatycznie ze strony WWW”** - podaj adres swojej strony,
a AI uzupełni opis, usługi, godziny i adres (wypełniane są tylko puste pola).
AI czyta też dane, których nie widać w tekście strony: numery z przycisków
„Zadzwoń”, adresy e-mail i dane strukturalne schema.org (adres, godziny,
cennik).
Pola zależą od branży, ale typowo obejmują:
* **Nazwę firmy** (wymagana),
* **Główny cel asystenta** - po co agent odbiera telefon; trafia do
**pierwszego akapitu promptu**, w tym samym zdaniu co rola (zob.
[Główny cel asystenta](#g%C5%82%C3%B3wny-cel-asystenta)),
* **Opis firmy** - czym się zajmujecie, dla kogo, co Was wyróżnia; trafia
wprost do promptu i działa jak kotwica przeciw halucynacjom,
* **Usługi / produkty**, **Godziny otwarcia**, **Adres**,
* pola branżowe, np. **Rodzaj kuchni** + **Menu** (restauracja),
**Specjalizacja** (klinika), **Marki aut** (salon).
W polach menu i usług agent wspomina **wyłącznie** o tym, co podasz - nigdy
nie wymyśla dań, cen, zabiegów ani pracowników.
### 2. Dane kontaktowe
Telefon, e-mail, strona WWW i adres firmy. Trafiają do bloku **O firmie**
w prompcie razem z instrukcją: *„Podawaj te dane kontaktowe, gdy rozmówca o
nie prosi.”* Adres pojawia się tu tylko wtedy, gdy szablon nie pyta o niego
już w Podstawach. Te pola uzupełnia również automat ze strony [WWW](http://WWW).
### 3. Co potrafi Twój agent (możliwości)
| Możliwość | Działanie |
| - | - |
| **Ton i osobowość** | Przyjazny, Profesjonalny, Energiczny albo Spokojny - dostraja styl wypowiedzi. |
| **Jak długie mają być odpowiedzi** | Suwak od „Bardzo krótko” do „Szczegółowo”. Stoi przy tonie, bo to część tego, jak agent brzmi. Przez telefon krócej jest bezpieczniej - rozmówcy rozłączają się przy monologach, a agent zawsze może zaproponować, że rozwinie temat. |
| **Jak agent zwraca się do rozmówcy** | „Państwo” (domyślne), „Pan / Pani”, „na Ty” albo dopasowanie do rozmówcy - zob. [Forma zwracania się](#forma-zwracania-si%C4%99). |
| **Kierunek połączeń** | Przychodzące (klienci dzwonią do agenta) albo wychodzące (agent dzwoni i zaczyna od przedstawienia się). |
| **Jak ma przebiegać rozmowa** | Opcjonalny plan rozmowy - jeden krok w linii. Zostaw puste, gdy rozmówca sam mówi, z czym dzwoni (typowy support). Wypełnij, gdy agent ma coś powiedzieć albo sprawdzić, zanim przejdzie do zbierania danych - zob. [Struktura rozmowy](#struktura-rozmowy). |
| **Zbieranie danych rozmówcy** | Wybierasz dokładnie, które dane zbierać (imię, telefon, e-mail, firma, budżet, termin, liczba osób, powód wizyty, NFZ czy prywatnie, PESEL, data urodzenia, ID konta, problem, pojazd, numer rejestracyjny, usługa, specjalista…). Zestaw zależy od szablonu: placówka medyczna domyślnie nie pyta o PESEL ani datę urodzenia, a o ubezpieczyciela nie pyta wcale. |
| **Własne dane do zebrania** | Dopisujesz własne pozycje, których nie ma na liście - np. „numer zamówienia”, „numer części”. Trafiają do promptu i do danych zbieranych po rozmowie. |
Agent pyta o te dane **pojedynczo**: jedno pytanie, odpowiedź rozmówcy,
potwierdzenie, i dopiero kolejne pytanie. Nigdy nie wylicza całej listy w
jednej wypowiedzi - przez telefon rozmówca zapamiętałby tylko ostatnią pozycję,
a reszta pól zostałaby pusta.
\| **Czego unikać w rozmowie** | Jedna zasada w linii; budują sekcję **Ograniczenia / czego unikać** w prompcie. |
\| **Najczęstsze pytania (FAQ)** | Lista par pytanie + odpowiedź; budują sekcję **Obsługa najczęstszych pytań i problemów**. |
\| **Baza wiedzy** | Wiedza wpisana tekstem albo wczytana z pliku; agent odpowiada na jej podstawie i ma zakaz zgadywania poza nią. |
\| **Przekazanie do człowieka** | Włącza eskalację; numer do przekierowania jest wtedy **wymagany** - bez niego agenta nie da się utworzyć, bo zapowiadałby przełączenie, którego nie da się wykonać. Jeśli przełączenie się nie uda, agent przeprasza, zapisuje wiadomość (imię, numer, sprawa) i obiecuje oddzwonienie. |
\| **Rezerwacje (Cal.com)** | Dodaje akcję `book_appointment` w trakcie rozmowy - zob. [integrację Cal.com](/pl/integrations/calendar/calcom). |
\| **SMS, e-mail, CRM** | Powiadomienia w trakcie i po rozmowie oraz wyszukiwanie kontaktu w HubSpot / Pipedrive. |
\| **Zapis każdej rozmowy do Google Sheets** | Po każdej rozmowie dopisywany jest wiersz do arkusza. |
\| **Notatki do Google Sheets w trakcie rozmowy** | Agent dopisuje wiersz jeszcze na linii - prośbę o kontakt, wiadomość do przekazania. Podajesz zakładkę, treść notatki i zwroty, po których agent ma po nią sięgnąć; kolumny dopracowujesz później w zakładce **Integracje** agenta - zob. [Notatka w trakcie rozmowy](/pl/integrations/overview). |
\| **Sprawdzanie danych w Google Sheets** | Agent czyta arkusz w trakcie rozmowy - status zamówienia, cena, czy rozmówca jest już klientem - zob. [Odczyt z arkusza](/pl/integrations/overview). |
\| **Google Calendar, Slack, Zapier / Make** | Wizyta wprost do kalendarza, wiadomość na kanał, uruchomienie Waszego scenariusza z zebranymi danymi. |
\| **Pogoda** | Agent odpowie, jaka jest pogoda - przydaje się przy wycieczkach, dostawach i wizytach w terenie. |
Wszystkie trzy funkcje Google Sheets korzystają z jednego arkusza, więc o
arkusz kreator pyta **raz** - pod tą, którą włączysz pierwszą. Pozostałe
pokazują już tylko swoje własne ustawienia. Agent zapisuje przez konto Google
zalogowane na stronie Integracje, więc najpierw zaloguj się tam; kreator nie
pyta już o klucz konta serwisowego.
#### Główny cel asystenta
Pierwszy akapit promptu mówi, kim jest agent **i po co dzwoni/odbiera**:
> Jesteś pomocnym agentem wsparcia klienta AI w AWParts.pl. Twoim zadaniem
> jest przyjmowanie reklamacji, udzielanie informacji o produktach oraz
> sprawdzanie stanu zamówienia.
Gdy zostawisz to pole puste, wpisywany jest domyślny cel szablonu, więc
pierwszy akapit zawsze mówi o celu. Cel powtarza się też w węźle **Główna
agenda** jako „Główny cel”.
#### Forma zwracania się
W polskim ta decyzja musi zapaść wprost, bo model potrafi dosłownie wymówić
„Pan/Pani”. Dlatego każda opcja podaje w prompcie formę do użycia **i formy,
których nigdy nie wolno wypowiedzieć**:
| Opcja | Co robi agent |
| - | - |
| **„Państwo”** (domyślna) | Mówi wyłącznie „Państwo” - najbezpieczniejsza, pasuje zawsze. |
| **„Pan / Pani”** | Wybiera jedną formę po imieniu lub głosie; przy niepewności mówi bezosobowo. |
| **„na Ty”** | Zwraca się bezpośrednio; w dwóch szablonach zmienia też pierwszą wypowiedź na nieformalną. |
| **Dopasuj do rozmówcy** | Odzwierciedla styl rozmówcy, do tego czasu mówi bezosobowo. |
#### Struktura rozmowy
Bot wsparcia klienta radzi sobie bez planu: czeka, aż rozmówca powie, z czym
dzwoni, i reaguje. Ale agent banku, warsztatu czy przychodni często musi coś
**powiedzieć albo sprawdzić, zanim** poprosi o dane - podać cenę, uprzedzić o
warunku, potwierdzić, czy sprawa w ogóle się kwalifikuje.
Do tego służy pole **Jak ma przebiegać rozmowa**. Jeden krok w linii, zwykłym
językiem:
```
Przywitaj się i zapytaj, co się dzieje z autem
Powiedz, że diagnostyka kosztuje 150 zł i trwa około godziny
Sprawdź, czy auto jest jeszcze na gwarancji
Dopiero potem zbierz dane i zaproponuj termin
```
Nie musisz numerować - myślniki, gwiazdki i własne numery są sprowadzane do
jednej ponumerowanej listy.
To **plan, a nie skrypt do odczytania**. Agent realizuje każdy krok własnymi
słowami, kończy go przed przejściem do kolejnego, a gdy rozmówca wyprzedzi plan
albo zapyta o coś innego - odpowiada i wraca do miejsca, w którym przerwaliście.
Plan trafia do promptu **przed** sekcją zbierania danych, bo zwykle mówi
właśnie o tym, co ma się wydarzyć, zanim agent o cokolwiek zapyta. Zostaje też
widoczny jako zmienna `conversation_structure`, więc poprawisz go później bez
przechodzenia kreatora od nowa. Zostaw puste, jeśli rozmówca zawsze sam mówi, z
czym dzwoni.
#### Baza wiedzy i FAQ
To dwa osobne pola, bo służą do czego innego:
* **Baza wiedzy** to fakty (polityka zwrotów, cennik, zasady). Możesz je
wkleić albo kliknąć **Wczytaj z pliku** (PDF, DOCX, TXT, MD, HTML - do
**2 MB**), a platforma zamieni dokument na tekst i dopisze go do pola.
* **Najczęstsze pytania (FAQ)** to pary pytanie + gotowa odpowiedź, które
trafiają do osobnej sekcji promptu razem z zasadą: odpowiadaj zgodnie z
podaną odpowiedzią, a jeśli sprawa nie pasuje - wróć do bazy wiedzy.
Wszystko, co wpiszesz w Bazie wiedzy, ląduje w **każdym** prompcie tego
agenta - trzymaj tu tylko najpotrzebniejsze informacje. Większe dokumenty
podłącz po utworzeniu agenta w zakładce **Baza wiedzy** w jego konfiguracji (zob. [Baza wiedzy](/pl/features/knowledge-base));
tam są dzielone na fragmenty i wyszukiwane w trakcie rozmowy. Plik powyżej
2 MB kreator odrzuci właśnie z takim komunikatem. Skrypt rozmowy ma
osobny, większy limit (10 MB) - zob. [Agent ze skryptu rozmowy](/pl/voice-agent/call-script).
### 4. Głos i język
* **Głos** - kobiecy · ciepły, kobiecy · jasny, męski · spokojny, męski · pewny.
* **Język** - polski, angielski, hiszpański, francuski, niemiecki, włoski,
portugalski, niderlandzki albo **wielojęzyczny** (auto-wykrywanie).
Prompt jest pisany **natywnie w wybranym języku** - to nie jest angielski
szablon z dopiskiem „odpowiadaj po polsku”.
## Generowanie promptu i język
Po kliknięciu **Utwórz agenta** platforma buduje prompt jedną z dwóch ścieżek:
Agent z gotowego szablonu w języku **polskim albo angielskim** dostaje prompt
złożony wprost z Twoich odpowiedzi, bez przepisywania przez LLM. To ten sam,
przetestowany prompt za każdym razem: te same odpowiedzi dają ten sam prompt,
więc łatwo sprawdzić, skąd wzięło się zachowanie agenta.
Przy **Mam własny pomysł**, pustym szablonie z opisanym celem, agencie ze
skryptu rozmowy i w pozostałych językach Twoje odpowiedzi trafiają do LLM,
który pisze **jeden kompletny, dopasowany prompt systemowy** - rola,
osobowość, wiedza, dane do zebrania, zabezpieczenia i styl rozmowy
telefonicznej. Bez dostępnego LLM pozostałe języki bazują na angielskim z
tłumaczeniem lub mocną dyrektywą językową, a tryb wielojęzyczny każe agentowi
dopasować się do języka rozmówcy.
## Zabezpieczenia przed halucynacjami
Każdy wygenerowany prompt zawiera jawne instrukcje zapobiegające zmyślaniu,
np.:
> „Wspominaj WYŁĄCZNIE o usługach i szczegółach wymienionych powyżej.
> NIE wymyślaj zabiegów, cen ani pracowników.”
Zasilają je pola **Opis firmy**, **Menu / Usługi** i **Wiedza i FAQ**.
## Agent mówi, że jest AI
AI Act (art. 50) wymaga, żeby rozmówca wiedział, że rozmawia ze sztuczną
inteligencją. Dlatego powitanie każdego szablonu mówi to w pierwszym zdaniu,
przy połączeniach przychodzących i wychodzących, w każdym języku - np.
*„Dzień dobry! Witamy w Bella Vista, mówi asystent AI. W czym mogę pomóc?”*.
Prompt każdego agenta, niezależnie od kierunku połączeń, zawiera też zasadę:
zapytany, czy jest człowiekiem, agent potwierdza, że jest asystentem AI, i
nigdy nie podaje się za człowieka, nawet gdy rozmówca naciska. Zasada jest
dokładana także w trakcie rozmowy, więc nie zgubi jej prompt, który
poprawisz albo napiszesz sam. Powitanie z Twojego
[skryptu rozmowy](/pl/voice-agent/call-script) zostaje słowo w słowo; jeśli
nie mówi, że agent jest AI, agent powie to w pierwszej odpowiedzi.
## Co powstaje
Z szablonu otrzymujesz:
* **prompt systemowy/globalny** w Twoim języku,
* zlokalizowaną **pierwszą wypowiedź**,
* gotowy **przepływ rozmowy** z typowymi etapami (start → główna agenda →
podsumowanie → zakończenie) - budowany pod spodem, nie musisz go oglądać,
* włączone **narzędzia** (np. `book_appointment` dla Cal.com),
* ustawienia głosu, transkrypcji i języka.
## Co możesz zmienić później
Odpowiedzi z onboardingu są wplatane w prompt jako tekst, więc agent jest
kompletny od razu. Fakty o firmie (nazwa, godziny, ceny, FAQ, dane kontaktowe)
widać też w zakładce **Zmienne**, ale **tylko do odczytu** z oznaczeniem
**z kreatora**: zmiana tam nie zmieniłaby tego, co mówi agent. Żeby zmienić np.
godziny otwarcia, popraw je w prompcie w zakładce **Rola** albo utwórz agenta
ponownie kreatorem. Jeśli wstawisz do promptu `{{opening_hours}}`, zmienna
staje się aktywna i znów można ją edytować.
Dane, które agent ma zbierać, znajdziesz w tej samej zakładce w karcie
**Dane zbierane przez asystenta** - tam je podejrzysz, zmienisz i dodasz
kolejne. Zob. [Zmienne szablonowe](/pl/voice-agent/template-variables).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.