# Zainstaluj agenta Nodale na swojej witrynie

<https://nodale.ai/pl/docs>

Jeden tag script umieszcza agenta Nodale na twojej witrynie. Gdzie go wkleić, na co witryna musi zezwalać i jak sprawdzić, że działa.

Agent Nodale działa na twojej witrynie dzięki jednemu tagowi script. Ta strona jest dla dewelopera, który go instaluje. Aby sterować agentem z własnego kodu, przeczytaj [JavaScript API](https://nodale.ai/pl/docs/api).

## Zanim zaczniesz

W twojej przestrzeni roboczej Nodale muszą być spełnione dwa warunki, inaczej tag nic nie robi:

1. **Agent jest opublikowany i online.** Karta Install twojego agenta pokazuje linię do wklejenia dopiero wtedy, gdy agent jest opublikowany, a jego wdrożenie aktywne.
2. **Twoja witryna jest zadeklarowana.** Dodaj jej adres w sekcji **Allowed websites**, na tej samej karcie. Zasady są [poniżej](#dozwolone-witryny).

## Wklej tag

```html
<script src="https://tag.nodale.app/v1/tag.js" data-workspace="YOUR_WORKSPACE_ID" async></script>
```

Skopiuj linię z karty Install: zawiera już identyfikator twojej przestrzeni roboczej. Wklej ją na każdej stronie, na której chcesz mieć agenta, w `<head>` albo tuż przed `</body>`.

- **Jedna linia na przestrzeń roboczą, wklejona raz.** Tag odczytuje bieżącą konfigurację twojej przestrzeni roboczej przy każdym załadowaniu strony. Publikacja nowej wersji agenta lub zmiana jego wyświetlania dociera na każdą stronę, a nikt nie musi dotykać witryny.
- **Uruchamia się raz na stronę.** Wklejenie go dwa razy albo załadowanie go z menedżera tagów oprócz samej strony niczemu nie szkodzi: druga kopia widzi pierwszą i się zatrzymuje.
- **Aplikacje jednostronicowe są obsługiwane.** Agent pozostaje zamontowany, gdy twoja aplikacja nawiguje przez `pushState`, `replaceState` lub `popstate`.
- **Język.** Widget przyjmuje język strony z `<html lang>`. Aby ustawić go samodzielnie, dodaj do tagu `data-lang`, na przykład `data-lang="fr"`.
- **Jedna przestrzeń robocza na stronę.** Strona uruchamia jeden tag.

## Dozwolone witryny

Tag odpowiada tylko na witrynach, które deklaruje twoja przestrzeń robocza. Na każdej innej witrynie nic nie jest dodawane do strony.

- Wpis to origin, ze schematem i portem: `https://www.example.com`. Nie ma ścieżki.
- Tylko `https`, z wyjątkiem `localhost` i `127.0.0.1` do pracy lokalnej.
- `https://*.example.com` obejmuje każdą subdomenę, na dowolnej głębokości, ale nie samo `example.com`. Domenę główną zadeklaruj osobnym wpisem.
- Najwyżej 20 witryn na przestrzeń roboczą.
- Zmiana nie wymaga publikacji. Usunięta witryna przestaje pokazywać agenta przy następnym załadowaniu strony przez odwiedzającego.

## Gdzie wyświetla się agent

Wyświetlanie to ustawienie karty Install, a nie tagu:

- **Floating bar**: pływający pasek u dołu strony.
- **Button**: przycisk uruchamiający w prawym dolnym rogu, który otwiera widget po kliknięciu.

Aby zamiast tego umieścić agenta we własnym układzie strony, dodaj ten element tam, gdzie chcesz. Widget montuje się w pierwszym, który znajdzie, w układzie strony, niezależnie od ustawienia wyświetlania:

```html
<div data-nodale-agent></div>
```

Trzecie wyświetlanie, `hidden`, trzyma agenta poza widokiem, dopóki twój kod go nie otworzy. Jest opisane w [JavaScript API](https://nodale.ai/pl/docs/api#wyświetlanie-hidden).

## Content Security Policy

Witryna, która wysyła Content Security Policy, dodaje dokładnie trzy źródła do dyrektyw, które już ma:

```text
script-src  https://tag.nodale.app;
frame-src   https://nodale.app;
connect-src https://nodale.app
```

- Bez `'unsafe-inline'`, bez `'unsafe-eval'`, bez symbolu wieloznacznego i bez nonce: tag to zewnętrzny skrypt bez kodu inline.
- Bez wpisu `style-src`, `img-src`, `font-src` ani `media-src`: wszystko, co renderuje widget, ładuje się w jego własnej ramce.
- `require-trusted-types-for 'script'` jest zgodne.
- `frame-src` przechodzi awaryjnie na `child-src`, a następnie na `default-src`.

## Mikrofon

Głos wymaga mikrofonu, a przeglądarka prosi o niego dopiero wtedy, gdy odwiedzający naciśnie przycisk mikrofonu, nigdy przy ładowaniu strony.

Jeśli twoja witryna wysyła nagłówek `Permissions-Policy`, nie może on odmawiać widgetowi dostępu do mikrofonu. Pomiń `microphone` albo zezwól na origin Nodale:

```text
Permissions-Policy: microphone=(self "https://nodale.app")
```

## Banery cookies

Narzędzie do zarządzania zgodami, które automatycznie blokuje skrypty, musi wyłączyć tag Nodale z blokady albo zaliczyć go do kategorii, którą twoja przestrzeń robocza wybrała dla śledzenia wizyt. Zablokowany tag nie może pokazać agenta.

Śledzenie wizyt jest domyślnie wyłączone. Gdy je włączysz, odsłony stron są liczone dopiero po tym, jak odwiedzający wyrazi zgodę. Tag odczytuje odpowiedź z twojego banera cookies; witryna, która go nie ma, zgłasza ją przez [`nodale('consent')`](https://nodale.ai/pl/docs/api#nodaleconsent). Sam agent jest montowany w obu przypadkach.

## Sprawdź instalację

Otwórz kartę Install. Karta **Tag on your sites** wymienia każdą zadeklarowaną witrynę jako **Detected** lub **Not detected**, z czasem, kiedy tag był ostatnio widziany. **Check again** odczytuje stronę główną każdej witryny.

Jeśli agent nie wyświetla się na stronie, sprawdź w tej kolejności:

1. Witryna jest w **Allowed websites**, z dokładnym schematem i subdomeną.
2. Agent jest opublikowany, a jego wdrożenie jest online.
3. Content Security Policy strony zawiera trzy źródła podane wyżej.
4. Żadne narzędzie do zarządzania zgodami nie blokuje skryptu.

Tag nigdy nie zapisuje błędu na twojej stronie. Gdy się zatrzymuje, zostawia jedną linię `console.debug` zaczynającą się od `nodale tag:`.

## Docs

- [JavaScript API: otwórz agenta Nodale z własnego kodu](https://nodale.ai/pl/docs/api): Polecenia nodale(), które może wywołać strona: otwórz agenta z własnego przycisku lub formularza, przekaż e-mail i kontekst, zgłoś zgodę odwiedzającego. (Markdown: https://nodale.ai/pl/docs/api.md)
- [Serwer MCP: zarządzaj przestrzenią Nodale z Claude Code](https://nodale.ai/pl/docs/mcp): Połącz Claude Code z serwerem MCP Nodale, potem odczytuj i zmieniaj przestrzeń roboczą: wiedzę, materiały demo, ustawienia agenta, witryny, wdrożenie. (Markdown: https://nodale.ai/pl/docs/mcp.md)
