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

# AI edytor

> Opisz zmianę słowami — wbudowany agent edytuje pliki strony, buduje podgląd, a Ty decydujesz, co opublikować.

AI edytor (wbudowany agent ItemShop) to czat w panelu (**Workspace → Agent AI**), który zmienia pliki Twojej strony tak jak programista: czyta projekt, edytuje komponenty i style, uruchamia build i pokazuje wynik. Nie musisz znać TSX ani CSS, nic nie instalujesz — agent działa w chmurze ItemShop.

## Jak pracujesz z AI

**1. Napisz, co chcesz zmienić**

Na przykład: „Zmień kolor akcentu na zielony i dodaj nad produktami pasek z licznikiem graczy online”. Możesz dołączyć zrzut ekranu albo obraz jako wzór lub zasób.

**2. Obserwuj kroki**

Na żywo widzisz, które pliki agent czyta i zmienia oraz status builda. Rozmowę możesz w każdej chwili **zatrzymać**.

**3. Sprawdź diff i podgląd**

Zmienione pliki są widoczne w **Zmiany** z różnicami i autorem. Obok czatu jest podgląd strony z Twoimi produktami (komputer / telefon).

**4. Opublikuj albo odrzuć**

**Opublikuj** zatwierdza szkic jako nową rewizję, buduje go i wdraża na produkcję. Odrzucenie szkicu nie zmienia opublikowanej strony.

> [!NOTE]
>
> Agent pracuje **wyłącznie na szkicu** i nie ma narzędzia do publikacji. Nic nie trafia do graczy, dopóki sam nie klikniesz **Opublikuj**, a każdą publikację możesz wycofać ([rollback](https://andcze.mintlify.site/pl/site/build-hosting.md#wycofanie-zmian)).

Po zakończeniu edycji agent sam buduje szkic. Jeśli build się nie uda, dostaje log i poprawia błędy (do 3 prób).

## Przykładowe polecenia

| Cel | Polecenie |
| - | - |
| Branding | „Wstaw moje logo z biblioteki mediów i ustaw ciemny motyw jako domyślny.” |
| Układ | „Pokaż produkty w 3 kolumnach, a na telefonie w jednej.” |
| Nowa sekcja | „Dodaj sekcję FAQ pod produktami z 4 pytaniami o dostawę i zwroty.” |
| Dane sklepu | „Dodaj widżet ostatnich zakupów i cel miesięczny w prawej kolumnie.” |
| Naprawa | „Build się nie udał — przeczytaj log i napraw błąd.” |

> [!TIP]
>
> Najlepiej działają małe, konkretne prośby. Zamiast „zrób ładniej” napisz „zwiększ odstępy między kartami produktów i zaokrąglij rogi”.

## Co agent wie o sklepie

Agent dostaje kontekst sklepu (nazwa, serwery, produkty, kategorie) i listę plików projektu. Dane produktów są dla niego **tylko do odczytu** — strona wyświetla je przez SDK, więc agent nie wpisuje cen ani produktów na sztywno. Nie ma dostępu do kluczy płatności, danych kupujących ani ustawień konta.

Agent traktuje treści z narzędzi (pliki, opisy produktów) jako dane, nie polecenia. Nie zapisze też plików poza projektem, sekretów, plików środowiskowych, skryptów instalacyjnych (`postinstall` itp.) ani nie zmieni fragmentów kasy odpowiedzialnych za zgody i przekierowanie do płatności.

## Narzędzia agenta

Agent korzysta z podzbioru narzędzi [serwera MCP](https://andcze.mintlify.site/pl/developers/mcp.md) — tych samych, których używają zewnętrzni agenci:

| Narzędzie | Co robi |
| - | - |
| `get_shop_context`, `get_site` | Kontekst sklepu i stan strony. |
| `list_files`, `read_file`, `search_files` | Przegląda projekt. |
| `write_file`, `apply_patch`, `delete_file` | Zmienia pliki szkicu. |
| `get_site_config`, `update_site_config` | Czyta i zmienia `src/site.config.ts` (wygląd). |
| `list_revisions` | Historia rewizji. |
| `start_build`, `get_build`, `create_preview` | Buduje szkic, czyta log, tworzy podgląd. |
| `list_products`, `get_product` | Odczyt katalogu. |

## Modele i limity

Model wybierasz w czacie. Poziom **Dokładny** jest dostępny w planie Pro.

| Poziom | Do czego | Plan |
| - | - | - |
| Szybki | Drobne zmiany tekstów i kolorów | Darmowy, Pro |
| Zbalansowany | Większość zadań | Darmowy, Pro |
| Dokładny | Nowe strony i większe przebudowy | Pro |

| Limit | Darmowy | Pro |
| - | - | - |
| Tokeny AI na dzień (sklep, zeruje się o północy UTC) | 200 000 | 2 000 000 |
| Tokeny jednej rozmowy | 150 000 | 1 000 000 |
| Kroki modelu / wywołania narzędzi na jedną wiadomość | 24 / 60 | 60 / 150 |
| Domyślny poziom modelu | Zbalansowany | Dokładny |

Dodatkowo: jedna wiadomość może trwać do 10 minut, na użytkownika przypada 10 wiadomości na minutę, a w jednym sklepie mogą pracować równolegle 2 przebiegi. Przekroczenie limitu pokazuje komunikat w czacie (np. „Dzienny limit wykorzystany”). Rozmowy są prywatne dla użytkownika. Więcej o limitach strony: [Plany i limity](https://andcze.mintlify.site/pl/site/limits.md).

Wolisz pracować z własnym agentem? Podłącz go przez MCP — zobacz [Podłączanie agentów](https://andcze.mintlify.site/pl/site/agents.md).

> **[Build i hosting](https://andcze.mintlify.site/pl/site/build-hosting.md)**
>
> Podgląd, publikacja, rollback.

> **[Własny kod](https://andcze.mintlify.site/pl/site/custom-code.md)**
>
> Wolisz pisać sam? Wgraj swoje pliki.


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