> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Asystent AI

> Opisz, co chcesz zrobić, a Asystent AI zaproponuje gotowe akcje do zatwierdzenia.

Asystent AI to Twój pomocnik w panelu. Zamiast samodzielnie szukać odpowiednich sekcji i wypełniać formularze, możesz po prostu opisać własnymi słowami, co chcesz osiągnąć — a asystent przygotuje dla Ciebie gotowe akcje do zatwierdzenia.

<Frame caption="Asystent AI otwiera się z przycisku w prawym dolnym rogu panelu.">
  <img src="https://mintcdn.com/andcze/6Qp9zwUm8VUzRssf/images/panel/ai-assistant.png?fit=max&auto=format&n=6Qp9zwUm8VUzRssf&q=85&s=ced4e377241888d835159a6fa801495c" alt="Okno czatu Asystenta AI w panelu sklepu" width="1280" height="720" data-path="images/panel/ai-assistant.png" />
</Frame>

## Gdzie go znajdziesz

Asystent AI jest zawsze pod ręką — to **przycisk z napisem „Asystent AI"** w **prawym dolnym rogu panelu**, oznaczony ikoną iskierek. Kliknij go, aby otworzyć okno czatu. Gdy czat jest otwarty, na przycisku pojawia się znak `x` — kliknij go ponownie (lub `x` w nagłówku okna), aby zamknąć czat i wrócić do pracy. Okno czatu „unosi się" nad panelem i nie zabiera miejsca Twoim treściom.

<Note>
  Asystent zawsze działa w **bieżącym sklepie** — tym, który masz aktualnie otwarty w panelu. Jego nazwa jest wypisana w nagłówku okna czatu, żebyś zawsze wiedział, którego sklepu dotyczą akcje. Wszystko, co asystent wykona, dotyczy właśnie tego sklepu.
</Note>

<Note>
  Asystent widzą tylko osoby, które mają **uprawnienie do edycji sklepu**. Jeśli pracujesz w zespole, a współpracownik ma jedynie podgląd, przycisk asystenta po prostu się u niego nie pojawi. Jako właściciel widzisz go zawsze.
</Note>

## Co widzisz po otwarciu czatu

Zanim cokolwiek napiszesz, okno czatu pokazuje trzy rzeczy, które pomagają zacząć:

<Columns cols={2}>
  <Card title="Krótka informacja" icon="info">
    Na samej górze widnieje notka, że asystent korzysta z zewnętrznego AI, jego treści mogą być niedokładne (warto je zweryfikować przed publikacją), a każda akcja dotyczy bieżącego sklepu i **wymaga Twojego zatwierdzenia**.
  </Card>

  <Card title="Szybkie akcje" icon="grid-2x2">
    Siatka skrótów do najczęstszych sekcji panelu. Jedno kliknięcie przenosi Cię na miejsce — bez pisania.
  </Card>

  <Card title="Przykłady" icon="sparkles">
    Gotowe propozycje poleceń. Kliknij dowolny, a asystent od razu zacznie nad nim pracować — nie musisz nic wpisywać.
  </Card>
</Columns>

### Szybkie akcje (skróty)

To kafelki, które jednym kliknięciem zamykają czat i przenoszą Cię prosto do wybranej sekcji panelu. Masz tu osiem najczęściej używanych miejsc:

<Columns cols={2}>
  <Card title="Produkty" icon="boxes">
    Lista wszystkich przedmiotów na sprzedaż.
  </Card>

  <Card title="Nowy produkt" icon="plus">
    Otwiera formularz dodawania produktu (w trybie kreatora).
  </Card>

  <Card title="Serwery" icon="server">
    Twoje serwery, na które trafiają zakupy.
  </Card>

  <Card title="Kody rabatowe" icon="ticket">
    Zarządzanie zniżkami dla graczy.
  </Card>

  <Card title="Zamówienia" icon="receipt">
    Lista i szczegóły zakupów.
  </Card>

  <Card title="Edytor strony" icon="layout-panel-top">
    Zmiana wyglądu i układu sklepu.
  </Card>

  <Card title="Płatności" icon="credit-card">
    Metody płatności i operatorzy.
  </Card>

  <Card title="Statystyki" icon="bar-chart-3">
    Analityka sprzedaży i ruchu.
  </Card>
</Columns>

### Przykładowe podpowiedzi

Pod szybkimi akcjami znajdziesz kilka gotowych poleceń, które możesz kliknąć zamiast wpisywać ręcznie. To świetny sposób, by poznać możliwości asystenta. Przykładowe podpowiedzi to m.in.:

* „Dodaj rangę VIP za 19,99 zł z krótkim opisem"
* „Napisz chwytliwy opis dla rangi MVP"
* „Stwórz kod rabatowy -20% o nazwie LATO"
* „Zaproponuj 3 pomysły na produkty do sklepu"

<Tip>
  Kliknięcie podpowiedzi działa tak samo, jakbyś wpisał ją sam — asystent od razu zaczyna nad nią pracować. To najszybszy sposób, by zobaczyć, jak całość działa, zanim wymyślisz własne polecenie.
</Tip>

## Jak to działa

<Steps>
  <Step title="Otwórz czat">
    Kliknij przycisk Asystenta AI w prawym dolnym rogu panelu.
  </Step>

  <Step title="Opisz, co chcesz zrobić">
    Napisz własnymi słowami, czego potrzebujesz — na przykład „utwórz produkt ranga VIP za 19,99" albo „napisz opis tej rangi". Nie musisz znać żadnych nazw technicznych ani układu menu. Wiadomość wysyłasz przyciskiem strzałki albo klawiszem `Enter` (a `Shift` + `Enter` przechodzi do nowej linii bez wysyłania).
  </Step>

  <Step title="Poczekaj na odpowiedź">
    Asystent przeanalizuje Twoją prośbę — w trakcie zobaczysz informację **„Asystent pracuje…"**. Po chwili odpowie i — jeśli to pasuje do Twojej prośby — zaproponuje konkretną akcję.
  </Step>

  <Step title="Sprawdź propozycję">
    Propozycja akcji pojawia się jako wyróżniona karta z dokładnym podglądem: co dokładnie zostanie utworzone lub zmienione (nazwa, cena, treść itd.). Dzięki temu wiesz, na co się zgadzasz, zanim klikniesz.
  </Step>

  <Step title="Zatwierdź lub odrzuć">
    Nic nie dzieje się automatycznie. Akcja zostanie wykonana **dopiero po Twoim zatwierdzeniu**. Jeśli coś Ci nie pasuje — kliknij **Odrzuć** i poproś asystenta o zmianę.
  </Step>

  <Step title="Asystent wykona zadanie">
    Po zatwierdzeniu asystent wykona akcję w Twoim sklepie, pokaże krótkie potwierdzenie i — przy tworzeniu produktu, serwera czy kodu rabatowego — automatycznie przeniesie Cię do odpowiedniej sekcji, abyś mógł sprawdzić efekt.
  </Step>
</Steps>

<Note>
  Asystent „pamięta" całą rozmowę w danym oknie, więc możesz pracować krok po kroku — np. najpierw poprosić o produkt, potem dopytać o zmianę ceny, a na końcu o opis. Zna też Twoje obecne **produkty i serwery**, więc może się do nich odnieść (np. napisać opis dla rangi, którą już masz).
</Note>

## Karta propozycji — co dokładnie zobaczysz

Gdy asystent proponuje akcję, nie wykonuje jej od razu. Zamiast tego pokazuje **kartę z podglądem** — czytelne zestawienie tego, co zamierza zrobić. W zależności od rodzaju akcji zobaczysz różne pola:

<AccordionGroup>
  <Accordion title="Tworzenie produktu">
    Na karcie zobaczysz **Nazwę**, **Cenę**, **Serwer**, krótki **Opis** oraz **Komendę realizacji** (jeśli asystent ją przygotował). Na dole jest pole **Status**: jeśli komenda jest gotowa, produkt powstanie jako **aktywny — gotowy do sprzedaży**; jeśli komendy brakuje, powstanie jako **szkic (nieaktywny)** i będziesz musiał uzupełnić komendę w panelu, zanim produkt zacznie działać.
  </Accordion>

  <Accordion title="Tworzenie serwera">
    Zobaczysz **Nazwę** i **Adres** serwera. Serwer jest potrzebny, zanim dodasz pierwszy produkt — asystent może go założyć za Ciebie.
  </Accordion>

  <Accordion title="Tworzenie kodu rabatowego">
    Karta pokazuje **Kod** (np. `LATO`), wielkość **Rabatu** (procentowy albo kwotowy) oraz **Zakres** — czy zniżka obejmuje cały sklep, wybrane serwery, czy wybrane produkty. Asystent uzupełnia rozsądne ustawienia domyślne (np. limit użyć i datę ważności), które potem możesz dopracować w sekcji Kody rabatowe.
  </Accordion>

  <Accordion title="Ustawienie ogłoszenia w sklepie">
    Zobaczysz **Treść** ogłoszenia. Po zatwierdzeniu pojawi się ono jako baner u góry Twojej strony sklepu — świetne do ogłaszania promocji czy nowości.
  </Accordion>

  <Accordion title="Wysłanie ogłoszenia na Discord">
    Zobaczysz **Treść** wiadomości, która trafi na Twój serwer Discord. Aby to zadziałało, sklep musi mieć skonfigurowane połączenie z Discordem (ustawiasz je w ustawieniach sklepu).
  </Accordion>

  <Accordion title="Przejście do sekcji">
    Czasem asystent nie tworzy niczego, tylko proponuje, że **przeniesie Cię do właściwej sekcji** panelu. Wtedy na karcie widnieje nazwa docelowego miejsca, a przycisk nosi nazwę „Przejdź".
  </Accordion>
</AccordionGroup>

<Note>
  Przycisk zatwierdzenia dopasowuje się do rodzaju akcji — przy produkcie zobaczysz **„Zatwierdź i utwórz"**, przy ogłoszeniu w sklepie **„Ustaw ogłoszenie"**, przy Discordzie **„Wyślij na Discord"**, a przy przejściu do sekcji po prostu **„Przejdź"**. Obok zawsze jest opcja **Odrzuć**.
</Note>

## Co potrafi asystent

Asystent rozumie polecenia opisane zwykłym językiem i zamienia je na gotowe akcje. Oto wszystko, w czym może pomóc:

<Columns cols={2}>
  <Card title="Tworzenie produktów" icon="package">
    Powiedz np. „utwórz rangę VIP za 19,99", a asystent przygotuje nowy produkt z podaną nazwą i ceną — gotowy do zatwierdzenia.
  </Card>

  <Card title="Dodawanie serwerów" icon="server">
    Jeśli nie masz jeszcze serwera, asystent może go założyć — to warunek, by dodać pierwszy produkt.
  </Card>

  <Card title="Pisanie opisów" icon="pen-line">
    Poproś o napisanie opisu produktu, a asystent zaproponuje gotowy tekst, który możesz przyjąć lub poprawić.
  </Card>

  <Card title="Kody rabatowe" icon="ticket">
    Poproś o utworzenie kodu rabatowego — na konkretną zniżkę, okazję lub wybrane produkty — a asystent przygotuje go do zatwierdzenia.
  </Card>

  <Card title="Ogłoszenia w sklepie" icon="megaphone">
    Poproś o ustawienie ogłoszenia (baneru), które zobaczą klienci odwiedzający Twój sklep.
  </Card>

  <Card title="Ogłoszenia na Discord" icon="message-circle">
    Asystent może wysłać ogłoszenie na Twój serwer Discord — np. informację o nowej promocji.
  </Card>

  <Card title="Pomysły i porady" icon="lightbulb">
    Zapytaj o pomysły na produkty, podpowiedź, jak coś ustawić, albo o krótkie wyjaśnienie — asystent odpowie po polsku.
  </Card>

  <Card title="Szybkie przejścia" icon="arrow-right">
    Asystent przeniesie Cię prosto do właściwej sekcji panelu, gdy będzie to potrzebne.
  </Card>
</Columns>

<Note>
  Asystent nie tylko wykonuje akcje — możesz z nim **zwyczajnie porozmawiać**. Jeśli zadasz pytanie, na które nie pasuje żadna akcja, po prostu otrzymasz odpowiedź tekstową (z pogrubieniami, listami i linkami, jeśli się przydadzą), bez karty do zatwierdzania.
</Note>

## Produkt jako szkic — ważny szczegół

Gdy poprosisz o utworzenie produktu, ale asystent nie ma od Ciebie **komendy realizacji** (czyli polecenia, które serwer wykona po zakupie), utworzy produkt jako **szkic (nieaktywny)**. Taki produkt jest zapisany, ale ukryty przed graczami.

<Warning>
  Produkt-szkic **nie sprzedaje się**, dopóki nie uzupełnisz komendy i nie włączysz go w panelu Produkty. To zabezpieczenie: dzięki niemu nigdy nie zdarzy się, że gracz zapłaci, a nic nie dostanie. Po utworzeniu produktu przez asystenta zajrzyj do sekcji Produkty, dodaj komendę i ustaw produkt jako aktywny.
</Warning>

<Tip>
  Jeśli od razu podasz asystentowi komendę (np. „utwórz rangę VIP za 19,99, komenda: `lp user {PLAYER} parent add vip`"), produkt może powstać od razu jako **aktywny**. I tak warto jednak zrobić testowy zakup, zanim ogłosisz go graczom.
</Tip>

## Czyszczenie i zamykanie czatu

* **Wyczyść czat** — w nagłówku okna (gdy w rozmowie jest już choć jedna wiadomość) pojawia się ikona kosza. Kliknięcie kasuje całą rozmowę i wraca do ekranu startowego z szybkimi akcjami. Przydatne, gdy chcesz zacząć temat od nowa.
* **Zamknij czat** — ikona `x` w nagłówku (lub ponowne kliknięcie przycisku asystenta) chowa okno. Rozmowa zostaje — gdy otworzysz czat ponownie, wrócisz do tego samego miejsca, dopóki jej nie wyczyścisz.

## Twoja kontrola nad akcjami

To Ty zawsze masz ostatnie słowo. Asystent nigdy nie wprowadza zmian na własną rękę.

<Warning>
  Każda akcja wymaga **Twojego zatwierdzenia**. Dopóki nie potwierdzisz, w sklepie nic się nie zmienia. Jeśli propozycja Ci nie odpowiada — kliknij **Odrzuć** albo po prostu jej nie zatwierdzaj.
</Warning>

<Tip>
  Zawsze sprawdź treść wygenerowaną przez AI, zanim ją opublikujesz. Asystent jest świetny do przygotowania tekstu czy ustawień, ale to Ty znasz swój sklep najlepiej — przeczytaj opis, sprawdź cenę i upewnij się, że wszystko się zgadza, zanim klienci to zobaczą.
</Tip>

## Najczęstsze pytania

<AccordionGroup>
  <Accordion title="Nie widzę przycisku asystenta — gdzie on jest?">
    Przycisk „Asystent AI" jest w prawym dolnym rogu każdej strony panelu. Jeśli go nie widzisz, prawdopodobnie Twoje konto w tym sklepie ma tylko podgląd, bez prawa do edycji — asystent pokazuje się jedynie osobom, które mogą wprowadzać zmiany. Poproś właściciela sklepu o odpowiednie uprawnienie w sekcji Zespół.
  </Accordion>

  <Accordion title="Asystent stworzył produkt, ale nie ma go w sklepie.">
    Najpewniej powstał jako **szkic (nieaktywny)** — bo nie miał komendy realizacji. Wejdź w sekcję Produkty, otwórz ten produkt, uzupełnij komendę i przełącz go na **aktywny**.
  </Accordion>

  <Accordion title="Czy mogę cofnąć akcję, którą zatwierdziłem?">
    Asystent nie ma przycisku „cofnij", ale wszystko, co utworzy, możesz normalnie zmienić lub usunąć w odpowiedniej sekcji panelu — np. skasować błędny produkt w Produktach albo zmienić ogłoszenie w ustawieniach. Dlatego najlepiej dokładnie sprawdzić kartę propozycji przed zatwierdzeniem.
  </Accordion>

  <Accordion title="Ogłoszenie na Discord nie dotarło.">
    Wysyłka na Discord działa tylko, gdy sklep ma skonfigurowane połączenie z Twoim serwerem Discord. Sprawdź ustawienia sklepu — jeśli połączenia nie ma, najpierw je dodaj, a potem ponów prośbę.
  </Accordion>

  <Accordion title="Czy asystent zna moje obecne produkty i serwery?">
    Tak. Przy każdej rozmowie zagląda do listy Twoich serwerów i produktów, więc może się do nich odnieść — np. napisać opis dla rangi, którą już masz, albo dobrać kod rabatowy do konkretnego produktu.
  </Accordion>

  <Accordion title="Dlaczego pojawia się napis, że treści mogą być niedokładne?">
    Asystent korzysta z zewnętrznej sztucznej inteligencji, która czasem może się pomylić w szczegółach (np. w cenie czy treści opisu). Dlatego zawsze sprawdzaj kartę propozycji i gotowe teksty, zanim je zatwierdzisz lub opublikujesz.
  </Accordion>
</AccordionGroup>

## Dobre praktyki

<Tip>
  * **Pisz po swojemu** — nie musisz pisać „idealnie". Opisz cel zwykłymi słowami, np. „zrób promocję -20% na weekend" albo „dodaj rangę Premium za 29,99".
  * **Im więcej szczegółów, tym lepiej** — podaj nazwę, cenę i kluczowe informacje, a propozycja będzie trafniejsza.
  * **Zawsze czytaj kartę propozycji** — to Twój ostatni moment, by wyłapać pomyłkę przed wykonaniem akcji.
  * **Uzupełniaj komendy produktów-szkiców** — produkt bez komendy się nie sprzeda; dodaj komendę i włącz go w panelu Produkty.
  * **Sprawdzaj teksty od AI** — opisy i ogłoszenia warto przeczytać przed publikacją; to Ty znasz swój sklep najlepiej.
  * **Pracuj krok po kroku** — możesz prowadzić rozmowę etapami: najpierw produkt, potem opis, na końcu kod rabatowy.
  * **Rób testowy zakup** — po utworzeniu produktu przez asystenta sprawdź w grze, czy zakup poprawnie się realizuje, zanim ogłosisz go graczom.
</Tip>
