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

# Edytor agenta

> Główne miejsce pracy z agentem: rola i prompt, pierwsza wiadomość, głos, transkrypcja, narzędzia, wiedza, ustawienia i integracje.

Po utworzeniu agenta trafiasz do **edytora agenta** - to tutaj konfigurujesz
wszystko, co decyduje o jakości rozmów. Edytor jest podzielony na zakładki.

## Zakładka Rola (najważniejsza)

Serce agenta. Ustawiasz tu:

* **Nazwę, opis i awatar** agenta. Awatar wgrywasz plikiem z dysku - klikasz
  ołówek przy zdjęciu i wybierasz obrazek (PNG, JPG, WEBP lub SVG). Obrazek jest
  przycinany do kwadratu, zmniejszany i zapisywany razem z agentem, więc widać go
  wszędzie tam, gdzie agent się pojawia: w aplikacji, w widgecie na stronie i w
  linku publicznym. Nie trzeba niczego wgrywać na serwer ani podawać adresu.
* **Prompt systemowy** - pełne instrukcje: kim jest agent, co wie o firmie,
  jak prowadzi rozmowę, czego mu nie wolno. Edytor podświetla
  `{{zmienne}}` i podpowiada ich nazwy po wpisaniu `{{`
  (zob. [Zmienne szablonowe](/pl/voice-agent/template-variables)).
* **Pierwszą wiadomość** w dwóch trybach:
  * **Statyczna** - dokładny tekst wypowiadany na start,
  * **Dynamiczna** - instrukcja dla LLM, jak wygenerować powitanie
    (np. spersonalizowane danymi z `initial_context`).
* **Kto mówi pierwszy** - agent otwiera rozmowę albo czeka, aż odezwie się
  rozmówca.
* **Sugestie ulepszeń (AI)** - panel z propozycjami poprawek promptu
  wygenerowanymi z prawdziwych rozmów. Każdą sugestię przeglądasz i
  stosujesz jednym kliknięciem - nic nie zmienia się bez Twojej zgody
  (zob. [Analizę po rozmowie](/pl/features/post-call-analysis)).

### Zapis fonetyczny (dodawany automatycznie)

To, co agent wygeneruje, trafia prosto do syntezatora mowy - a syntezator
przeczyta „24/7" jako „dwadzieścia cztery ukośnik siedem", „np." przeliteruje,
a „0,4" powie jako „zero przecinek cztery" tylko przez przypadek. Dlatego do
**każdej** instrukcji systemowej platforma dopisuje na końcu twardą zasadę
zapisu fonetycznego: liczby, kwoty, godziny i daty słownie („o dziewiątej",
nie „o 9:00"), bez skrótów („na przykład", nie „np."), znaki słownie („małpa"
zamiast „@", „kropka" zamiast „."), numery telefonów i kody dyktowane w
grupach.

Zasada dokładana jest w trakcie rozmowy, a nie do tekstu promptu, więc:

* działa też dla promptów napisanych ręcznie i przeklejonych skądinąd,
* nie da się jej skasować przez edycję promptu,
* nie musisz jej powtarzać we własnych instrukcjach (jeśli już ją tam masz,
  nie zostanie zdublowana).

Wyjątkiem są argumenty narzędzi - data rezerwacji leci do `book_appointment`
w normalnym formacie, bo nikt jej nie wypowiada. Wersję językową zasady
(polską albo angielską) platforma dobiera po języku transkrypcji ustawionym
w zakładce **Transkrypcja**.

## Zapisywanie

Cały edytor ma **jeden przycisk Zapisz** - zielony, w prawym górnym rogu.
Zapisuje wszystko naraz: nazwę, opis, prompt, pierwszą wiadomość i ustawienia
z pozostałych zakładek. Działa też skrót **⌘S**. Gdy masz niezapisane zmiany,
w nagłówku pojawia się żółty znacznik **Niezapisane zmiany**.

<Note>
  Zakładki **Zmienne**, **Narzędzia** i **Baza wiedzy** mają własne przyciski
  („Zapisz zmienne", „Zapisz narzędzia", „Zapisz dokumenty"). To nie jest
  duplikat - te trzy zapisują się osobno, bo dotyczą danych trzymanych poza
  konfiguracją agenta. Reszta edytora idzie wyłącznie przez przycisk w nagłówku.
</Note>

## Pozostałe zakładki

| Zakładka | Co konfigurujesz |
| - | - |
| **Głos** | Głos agenta (TTS) - zob. [Głos](/pl/configurations/voice) |
| **Transkrypcja** | Rozpoznawanie mowy (STT) i jego timing - zob. [Transkrypcja](/pl/configurations/transcriber) |
| **Narzędzia** | Akcje wywoływane w trakcie rozmowy - zob. [Narzędzia](/pl/voice-agent/tools) |
| **Zmienne** | Zmienne szablonowe agenta - zob. [Zmienne](/pl/voice-agent/template-variables) |
| **Baza wiedzy** | Dokumenty [bazy wiedzy](/pl/features/knowledge-base) podpięte do agenta (RAG) |
| **Pamięć** | Tylko w [asystencie osobistym](/pl/voice-agent/personal-assistant) - co agent zapamiętuje między rozmowami. Przy pozostałych agentach zakładka się nie pojawia |
| **Ustawienia** | [Limity rozmowy](/pl/billing/pricing#sufit-długości-rozmowy), wykrywanie poczty głosowej, [nagrywanie rozmów i komunikat przed powitaniem](/pl/features/data-retention#nagrywanie-rozmów), wrażliwość na przerwania, [przytakiwanie](/pl/features/backchannel), frazy kończące (agent z szablonu po polsku rozłącza się na „do widzenia”, „do usłyszenia”, „do zobaczenia” i „dziękuję, to wszystko”), język podsumowań |
| **Integracje** | SMS po rozmowie, CRM (HubSpot/Pipedrive), Slack, Zapier, e-mail, rezerwacje [Cal.com](/pl/integrations/calendar/calcom), [notatki i odczyt z Google Sheets](/pl/integrations/overview), [źródła leadów](/pl/integrations/leads/lead-webhook) (formularz, Google Ads, [nowy kontakt w CRM](/pl/integrations/leads/crm-leads)), [oddzwanianie do nieodebranych](/pl/integrations/leads/missed-calls) |

Zakładka **Integracje** ma nad kartami wyszukiwarkę i filtr **Wszystkie /
Włączone / Wyłączone**, więc nie trzeba jej przewijać, żeby sprawdzić, co ten
agent ma podpięte. Karty wyłączone stoją po dwie w wierszu; włączona rozwija
się na całą szerokość razem ze swoimi ustawieniami.

W treści SMS-a po rozmowie menu **Wstaw zmienną** podaje gotową listę tego, co
się w niej wypełni, licznik pod polem pokazuje, na ile płatnych wiadomości
rozbija się tekst, a **Zaproponuj treść** pisze kilka propozycji na podstawie
promptu systemowego agenta - zob.
[SMS po rozmowie](/pl/integrations/overview#sms-po-rozmowie).

## Duplikowanie agenta

Drugiego agenta dla tej samej firmy najszybciej zrobisz z tego, który już
działa. W menu **⋯** przy agencie - na liście **Agenci głosowi** i w bocznym
pasku edytora - wybierz **Duplikuj**. Kopia otwiera się od razu.

Do kopii przechodzi wszystko, co decyduje o zachowaniu agenta: prompty,
głos, transkrypcja, integracje, akcje w trakcie rozmowy i zbierane zmienne.

<Note>
  Numer telefonu i token widgetu **nie** są kopiowane. Numer odbiera dla jednego
  agenta - kopia, która by go przejęła, zdjęłaby oryginał z anteny. Numer
  przypisujesz kopii osobno na stronie **Telefonia** (menu boczne) przyciskiem
  **Przypisz do agenta**, a widget włączasz jej własnym kodem osadzenia.
</Note>

## Testowanie

Z edytora uruchomisz od razu **rozmowę web** (z przeglądarki) albo
**telefoniczną** - a po każdej rozmowie zobaczysz analizę AI i trace
przebiegu, które podpowiadają, co poprawić.

W transkrypcji - na żywo i w historii rozmowy - każde wywołanie narzędzia jest
osobną kartą: nazwa narzędzia, czy odpowiedziało i godzina. Po rozwinięciu
karty widzisz **Wysłane dane** (argumenty, z jakimi agent je wywołał) i
**Odpowiedź narzędzia** (co narzędzie zwróciło). To jest odpowiedź na pytanie „dlaczego agent
powiedział, że nic nie znalazł" - widać, czego szukał i co dostał. Wywołanie,
które nigdy nie wróciło, zostaje w transkrypcji oznaczone jako trwające.

## Co jest pod spodem

Pod spodem agent jest grafem węzłów (start, etapy rozmowy, zakończenie).
Kanwa przepływu jest na razie **ukryta w panelu** - nie musisz jej dotykać,
bo szablony i edytor konfigurują graf za Ciebie. Jeśli chcesz wiedzieć, co
dokładnie dzieje się pod spodem i gdzie dziś ustawia się to, co kiedyś
ustawiało się na kanwie, zobacz [Przepływ rozmowy (pod spodem)](/pl/voice-agent/conversation-flow).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.