# Jak dodać agenta Copilot Studio na stronę internetową (bez programowania)

> Agent Copilot Studio jako czat na stronie firmy: kod osadzania z kilku linijek HTML, adres tokena z kanałów, wygląd okienka, powitanie. Kiedy to działa, a kiedy potrzebny jest pełny WebChat.

Źródło: https://przejmijai.pl/artykuly/copilot-studio-agent-na-stronie-www
Aktualizacja: 13 listopada 2026
Autor: PrzejmijAI (przejmijai.pl)

Agent z Copilot Studio nie musi żyć tylko w Teams. Można go wstawić na stronę firmy jako okienko czatu w rogu ekranu, np. do odpowiadania klientom na pytania o godziny otwarcia, cennik czy status zamówienia. Najprostszy sposób nie wymaga pisania JavaScriptu: wystarczy kilka linijek HTML.

Opis opieramy na [wpisie zespołu Microsoft CAT](https://microsoft.github.io/mcscatblog/posts/webchat-embed-zero-javascript/), który pokazuje bibliotekę `botframework-webchat-embed`.

## Warunek: agent bez logowania

Ten sposób działa tylko dla agentów **bez uwierzytelniania**, czyli takich, z których może korzystać każdy odwiedzający. Jeśli agent wymaga logowania kontem firmowym (Entra ID), potrzebny jest pełny WebChat i praca programisty.

Pamiętaj: agent bez logowania **nie powinien mieć dostępu do danych wewnętrznych**. Każdy odwiedzający stronę może zadać mu dowolne pytanie. Wiedza takiego agenta to wyłącznie informacje publiczne.

## Krok 1: adres tokena

W Copilot Studio wejdź w **Settings → Channels**, wybierz kanał **Email** i skopiuj **Token Endpoint**. To adres, przez który strona łączy się z agentem.

## Krok 2: kod na stronie

Wstaw w kodzie strony element z adresem tokena i skrypt biblioteki:

```html
<div class="czat"
     data-webchat-token-url="TU-WKLEJ-TOKEN-ENDPOINT"
     data-webchat-title="Pomoc"
     data-webchat-bubble-text="Napisz do nas"></div>
<script src="https://cdn.jsdelivr.net/npm/botframework-webchat-embed@latest"></script>
```

Skrypt sam znajdzie element i wyświetli w rogu dymek, który po kliknięciu otwiera okno czatu. Pozycję i rozmiar ustawisz w CSS, np. przyklejając okienko do prawego dolnego rogu.

W systemach typu WordPress taki kod wstawia się zwykle w bloku „Własny HTML” albo w ustawieniach motywu.

## Krok 3: wygląd i zachowanie

- `data-webchat-title`: tytuł okna, `data-webchat-bubble-text`: napis na dymku,
- kolory: okienko korzysta ze zmiennych CSS strony, a dokładniej ustawisz je atrybutami `data-webchat-style-*`,
- `data-webchat-minimized`: czy czat startuje jako dymek (domyślnie tak),
- `data-webchat-send-start-event`: uruchamia powitanie agenta (temat Conversation Start),
- `data-webchat-mock-welcome`: pokazuje powitanie w przeglądarce bez łączenia się z agentem, czyli szybciej i bez zużycia przy samym wejściu na stronę.

## Na co uważać

- **Koszty.** Każda rozmowa z agentem zużywa kredyty Copilot. Na publicznej stronie rozmów może być dużo. Ustaw limity: piszemy o tym w artykule [o kredytach w Copilot Studio](https://przejmijai.pl/artykuly/copilot-studio-kredyty-limity-koszty).
- **Wersja `@latest`** zawsze ładuje najnowszą wersję biblioteki. W środowisku produkcyjnym bezpieczniej wpisać konkretny numer wersji.
- **Biblioteka nie obsługuje** sekretów Direct Line ani własnych rozszerzeń WebChat.
- **RODO:** jeśli czat zapisuje rozmowy, wspomnij o tym w polityce prywatności strony.

Przy obsłudze klientów warto też znać harness Customer Conversation, przeznaczony do czatu na stronie i telefonu z przekazaniem do konsultanta. Przegląd harnessów znajdziesz w artykule [Microsoft Copilot harness czy standard](https://przejmijai.pl/artykuly/copilot-studio-microsoft-copilot-harness-czy-standard).
