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

# Zmienne szablonowe

> Zmiennych szablonowych używasz w prompcie systemowym agenta, w treści SMS-a po rozmowie oraz w mapowaniach integracji.

### Renderowanie szablonów

W promptach możesz odwoływać się do zmiennych przekazanych jako
`initial_context` (przez wyzwalacz API albo z arkusza/CSV kampanii) oraz do
zmiennych wyekstrahowanych z rozmowy jako `gathered_context`.

Renderowanie obsługuje wartości zagnieżdżone.

Przykład - dla kontekstu początkowego:

```json theme={null}
{
    "initial_context": {
        "user": {
            "name": "Jan"
        }
    }
}
```

prompt może wyglądać tak:

`Jesteś Alicją i rozmawiasz z {{initial_context.user.name}}.`

### Data i godzina

Model nie ma zegara: agent poproszony o umówienie wizyty „na wtorek" sam
zgaduje rok i potrafi umówić na zeszły. Dlatego platforma dopisuje do promptu
systemowego **każdego** agenta - także napisanego ręcznie albo
zaimportowanego - zdanie z dzisiejszą datą, dniem tygodnia i godziną
rozpoczęcia rozmowy w strefie `Europe/Warsaw`, w języku agenta, np.:

`AKTUALNA DATA: Dzisiaj jest sobota, 17 października 2026 (2026-10-17), godzina 14:05 na początku tej rozmowy (strefa Europe/Warsaw).`

Od tej daty agent liczy „jutro", „w przyszły wtorek" czy „za tydzień" i nie
umawia niczego w przeszłości. Nie musisz niczego dopisywać.

Jeśli chcesz użyć daty we własnym tekście, w każdej rozmowie dostępne są też
trzy zmienne z bieżącą datą w tej samej strefie:

| Zmienna | Przykład |
| - | - |
| `{{today}}` | `2026-08-28` |
| `{{now}}` | `2026-08-28 10:15` |
| `{{weekday}}` | `Friday` |

Jeśli własna zmienna nosi taką samą nazwę, wygrywa Twoja.

Narzędzie **Umów wizytę (Cal.com)** dostaje dzisiejszą datę samo, niezależnie
od promptu, i odmawia rezerwacji w przeszłości.

### Dane zbierane przez asystenta

W konfiguracji agenta, w zakładce **Zmienne**, na górze znajdziesz kartę
**Dane zbierane przez asystenta**. To pozycje wybrane w kreatorze w kroku
„Co agent ma zebrać” - agent pyta o nie w trakcie rozmowy, a platforma
zapisuje je jako `gathered_context`.

<Note>
  Wartości pojawiają się **dopiero po zakończeniu rozmowy** - w historii
  rozmów i w integracjach (Google Sheets, CRM, webhook). W trakcie
  konfiguracji widzisz same nazwy pól, nie dane klientów.
</Note>

W karcie możesz:

* podejrzeć wszystkie zbierane pola razem z opisem („co asystent ma ustalić”),
* zmienić nazwę pola lub jego opis,
* usunąć pole i dodać własne, np. `numer_zamowienia`.

Zapis rozsyła jedną wspólną listę na węzły konwersacyjne agenta, więc nie
musisz pamiętać, który węzeł co zbiera.

Tych samych nazw używasz w zakładce **Integracje** jako **Źródło** mapowania
z kontekstem `gathered`. Pole Źródło podpowiada je z listy - kliknij strzałkę
po prawej stronie pola.

### Zmienne szablonowe a dane zbierane

| | Zmienne szablonowe | Dane zbierane przez asystenta |
| - | - | - |
| Skąd pochodzą | Onboarding, edytor, `initial_context` (API, kampania) | Rozmowa z klientem |
| Kiedy znane | Przed rozmową | Po rozmowie |
| Kontekst w mapowaniach | `initial` | `gathered` |
| Użycie w prompcie | `{{nazwa}}` | - |

### Odpowiedzi z kreatora

Godziny, ceny, FAQ, opis firmy i inne odpowiedzi z kreatora są przy tworzeniu
agenta wpisywane w prompt jako tekst. W zakładce **Zmienne** widać je z
oznaczeniem **z kreatora** i **tylko do odczytu**, bo nowa wartość nie
zmieniłaby tego, co mówi agent. Zmiana wymaga edycji promptu w zakładce
**Rola** albo ponownego przejścia kreatora. Gdy wstawisz zmienną do promptu,
węzła lub treści SMS-a jako `{{nazwa}}`, staje się aktywna i znów możesz ją
edytować.

### Węzły

Pod spodem agent działa na grafie węzłów: jedne przekazują mu instrukcje, inne
pozwalają wyzwolić połączenie z zewnątrz, a jeszcze inne wysyłają wynik rozmowy
webhookiem do CRM lub narzędzi typu n8n. Kanwa tego grafu jest na razie ukryta
w panelu - co dzieje się pod spodem i gdzie dziś ustawia się poszczególne
rzeczy, opisuje [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.