Prywatność, rozwiązywanie problemów i hooki dla deweloperów — WebMCP

Dane i prywatność

Moduł przechowuje wszystko w bazie danych Twojego sklepu. Nic nie jest wysyłane do PrestaChamps.

Wizyta z linku asystenta jest pamiętana przez 30 dni we własnym cookie Twojego sklepu (bez nowego cookie): tylko kanał, asystent i czas. Oceny i opinie są odczytywane z Twojego modułu opinii, gdy asystent o nie pyta, nigdy nie są kopiowane.

Prośby o zwrot i anulowanie nie przechowują własnego zapisu w module. Prośba o zwrot to zwrot produktów PrestaShop, tak jakby klient użył formularza zwrotu na stronie swojego zamówienia. Prośba o anulowanie to wiadomość przy zamówieniu w Obsłudze klienta PrestaShop, napisana z konta klienta; w przeciwieństwie do formularza wiadomości ze strony zamówienia nie przechowuje adresu IP. Ich dzienne limity to liczniki jak limity żądań powyżej.

Moduł usuwa wygasłe zapisy samodzielnie, najwyżej co 6 godzin. Usunięcie klienta usuwa jego połączenia, tokeny, przygotowane realizacje zamówienia i testy; jego wiersze dziennika znikają po Liczbie dni przechowywania dziennika. Przygotowane realizacje zamówienia testu AI (Testuj z agentem AI) są przechowywane 30 dni jak każde inne. Gdy moduł jest wyłączony, niczego nie usuwa, nawet gdy klient zostaje usunięty: odinstaluj go, aby usunąć jego dane.

Co wspomnieć w polityce prywatności: że kupujący mogą połączyć asystenta AI ze swoim kontem, co moduł przechowuje z tych połączeń (powyżej) i że dostawca asystenta (OpenAI, Anthropic) decyduje o tym, co przechowuje z rozmowy; oraz, jeśli testujesz jako prawdziwi klienci w Testuj z agentem AI, że ich zamówienia i ceny są wysyłane do dostawcy AI, z którym testujesz.

Odinstalowanie. Odinstalowanie modułu usuwa jego otwarte koszyki testowe, a następnie wszystko powyższe: każdą tabelę i każde ustawienie modułu. robots.txt pozostaje bez zmian (wygeneruj go ponownie w Preferencje › Ruch i SEO, aby usunąć grupę modułu).

Linki do płatności po wyłączeniu lub odinstalowaniu. Wyłączenie lub odinstalowanie modułu kończy każde zalogowanie linku do płatności natychmiast. Przeglądarka, która otworzyła taki link, może nadal pokazywać nazwę, adres e-mail i adresy kupującego w swoich danych strony do czasu wygaśnięcia jej cookie sklepu, ponieważ PrestaShop sam odczytuje klienta z tego cookie (zgłoszone do PrestaShop).

↑ Powrót na górę

Rozwiązywanie problemów

Zacznij od Diagnostyki: każdy wiersz poniżej to sprawdzenie z jej listy, wraz z tym, co oznacza i jak je naprawić. Gdy asystenci w telefonie są wyłączeni, pięć wierszy „Asystenci w telefonie” ma charakter wyłącznie informacyjny.

• Moduł włączony dla tego sklepu – zawodzi, gdy moduł nie jest włączony dla tego sklepu w Menedżerze modułów (Otwórz Menedżer modułów), jest wyłączony w swoich ustawieniach (Otwórz ustawienia) lub gdy sklep jest w trybie przerwy technicznej (odwiedzający i asystenci widzą wtedy stronę przerwy technicznej; Otwórz ustawienia przerwy technicznej).
• Udostępnione narzędzia – zawodzi, gdy żadne narzędzie nie jest włączone („asystenci nie znajdują niczego do użycia w Twoim sklepie”), wymaga uwagi, gdy włączone są tylko zmiany koszyka (asystenci nie mogą przeszukać ani odczytać Twojego katalogu, aby znaleźć, co dodać). Poprawka: Wybierz narzędzia.
• Bezpieczne strony (HTTPS) – zawodzi bez HTTPS: przeglądarki udostępniają WebMCP tylko na bezpiecznych stronach. „HTTPS jest włączony tylko dla niektórych stron”: włącz HTTPS na każdej stronie (Otwórz ustawienia ogólne). Sklep na Twoim własnym komputerze pokazuje „Bezpieczne tylko do celów deweloperskich”.
• Połączenie ze stronami sklepu – „Moduł nie jest w pełni połączony z Twoimi stronami sklepu, więc mogą one nie udostępniać narzędzi.” Poprawka: Napraw hooki na tej samej karcie.
• Tokeny Origin Trial – informacja bez tokena: „Bez tokena tylko przeglądarki z włączoną flagą testową WebMCP widzą Twoje narzędzia.” (Dodaj token). Ostrzega, gdy token jest dla innego adresu, nie dotyczy programu testowego WebMCP, wygasł lub kończy się w ciągu 14 dni.
• Indeks wyszukiwania – zobacz Indeks wyszukiwania.
• Sklep odpowiada – moduł wywołuje własny adres sklepu z Twojego serwera. „Twój serwer nie mógł otworzyć własnego adresu sklepu (częste za zaporami i w Dockerze)”: użyj Otwórz sprawdzenie sklepu w swojej przeglądarce. „Sklep wysyła ten adres gdzie indziej, zamiast odpowiadać”: sprawdź adres swojego sklepu i reguły przekierowań. „Sklep odpowiada „niedostępny””: zwykle tryb przerwy technicznej. Po naprawie Wyczyść pamięć podręczną.
• Wyszukiwarka sklepu – informacja: który moduł odpowiada na wyszukiwania Twojego sklepu („Wyszukiwania w sklepie korzystają z własnej wyszukiwarki PrestaShop.” lub „Na wyszukiwania w sklepie odpowiada …”); „Moduł wyszukiwania zakończył żądanie zamiast odpowiedzieć”: jego mechanizm awaryjny przekierowuje do strony wyszukiwania sklepu; asystenci otrzymują wtedy własną wyszukiwarkę PrestaShop.
• Asystenci w telefonie: bezpieczny adres (HTTPS) – zawodzi bez SSL: ChatGPT i Claude łączą się tylko ze sklepami z HTTPS (Otwórz ustawienia ogólne). Sklep na Twoim własnym komputerze przechodzi jako „Tylko do celów deweloperskich”.
• Asystenci w telefonie: przyjazne adresy URL – zawodzi, gdy przyjazne adresy URL są wyłączone (Otwórz ustawienia SEO i URL).
• Asystenci w telefonie: adresy wykrywania – sklep pobiera własne dokumenty /.well-known/oauth-…, w których asystenci dowiadują się, jak kupujący się logują. Wymaga uwagi, gdy odpowiadają tylko własne kopie modułu (większość asystentów nadal się łączy); zawodzi, gdy żadna nie odpowiada lub gdy nazywają inny adres (sprawdź domenę sklepu i ustawienie SSL). Poprawka: Twój serwer WWW musi przekazywać adresy zaczynające się od /.well-known/oauth- do PrestaShop; na Apache żadna reguła .htaccess nie może zatrzymać /.well-known/ przed regułami PrestaShop; na Nginx dodaj location dla /.well-known/oauth-, który przekazuje do index.php. Za zaporą serwer może nie dosięgnąć własnego adresu: użyj zamiast tego Otwórz dokument w swojej przeglądarce.
• Asystenci w telefonie: nagłówek logowania – zawodzi, gdy Twój serwer gubi logowanie, które wysyłają połączeni asystenci (nagłówek Authorization): nie mogą wtedy korzystać z koszyka, zamówień ani realizacji zamówienia. Poprawka: Apache z PHP jako CGI lub FastCGI: dodaj CGIPassAuth On do .htaccess sklepu lub zachowaj wiersz PrestaShop kopiujący nagłówek do HTTP_AUTHORIZATION; Nginx: dodaj fastcgi_param HTTP_AUTHORIZATION $http_authorization do location PHP.
• Asystenci w telefonie: ten sam koszyk w sklepie internetowym – informacja, gdy Wyświetl ponownie koszyk po zalogowaniu jest wyłączone: kupujący, który zaloguje się na Twojej stronie, otrzymuje wtedy nowy, pusty koszyk zamiast koszyka asystenta (link do płatności nadal otwiera koszyk asystenta). Poprawka: Otwórz ustawienia klientów i włącz je.
• Katalogi agentów AI – informacja, gdy Opisz ten sklep dla katalogów agentów AI jest wyłączone; wymaga uwagi, gdy robots.txt nadal kieruje katalogi do opisu (otwórz Ustawienia › Ustawienia zaawansowane › Katalogi agentów AI i zapisz). Zawodzi, gdy przyjazne adresy URL są wyłączone (Preferencje › Ruch i SEO), gdy opis lub przewodnik dla agentów AI nie odpowiada (sprawdź, czy moduł jest włączony dla tego sklepu, a następnie wyczyść pamięć podręczną sklepu) lub gdy opis łamie format (szczegóły wymieniają każdy problem). Wymaga uwagi, gdy Twój serwer nie mógł otworzyć własnego adresu (Otwórz opis zamiast tego w swojej przeglądarce); gdy Twój serwer nie przekazuje /.well-known/ard.json i /.well-known/ai-catalog.json do PrestaShop (Apache: żadna reguła w .htaccess nie może zatrzymać /.well-known/ przed regułami PrestaShop; Nginx: location dla tych dwóch adresów przekazujący do index.php); gdy /llms.txt nie odpowiada podsumowaniem modułu (Nginx: niech location dla plików .txt przechodzi awaryjnie do index.php); gdy robots.txt nie ma jeszcze wiersza Agentmap: lub ma nieaktualny (otwórz Ustawienia › Ustawienia zaawansowane › Katalogi agentów AI i zapisz); lub gdy jego wiersz Agentmap: nazywa inną domenę (usuń ten wiersz, jeśli nie jest Twój). Zobacz Katalogi agentów AI i llms.txt.
• Formularze dla agentów AI – informacja, gdy Oznaczaj formularze dla agentów AI jest wyłączone („Chrome Lighthouse wymienia formularze Twojego sklepu jako nieoznaczone dla agentów AI”; Otwórz ustawienia) lub Udostępniaj narzędzia w tym sklepie jest wyłączone. Wymaga uwagi, gdy strony sklepu zgłosiły w ostatnich 7 dniach formularze, które Chrome liczy jako problemy WebMCP (tylko przy włączonym Trybie diagnostycznym): formularz motywu lub innego modułu mający tylko jeden z atrybutów toolname i tooldescription (nadaj mu oba lub żaden), formularz używający nazwy jednego z narzędzi modułu (zmień nazwę), dwa formularze na jednej stronie o tej samej nazwie, oznaczony formularz z polem bez nazwy lub etykiety albo przyciski radio poza zestawem pól (napraw to w motywie) lub formularze oznaczone jako nieprzeznaczone dla agentów, które przeglądarka mimo to zaoferowała (wyłącz Oznaczaj formularze dla agentów AI i poszukaj aktualizacji modułu). Zobacz Narzędzia formularzy na Twoich stronach.
• Oceny i opinie – który moduł opinii odczytują odpowiedzi o produktach („Odpowiedzi o produktach zawierają oceny i najnowsze opinie z …”). Informacja, gdy Pokazuj oceny i opinie agentom AI jest wyłączone (Otwórz ustawienia), gdy żaden moduł opinii, który ta wersja potrafi odczytać, nie jest aktywny, lub gdy aktywny trzyma swoje opinie na własnych serwerach, zbiera opinie o sklepie, a nie o produktach, albo nie może być jeszcze odczytany przez tę wersję; wymaga uwagi, gdy moduł jest aktywny, ale jego tabele opinii nie mogą być odczytane. Zobacz Oceny i opinie.
• Dostawa do Twoich głównych krajów – wymaga uwagi, gdy żaden przewoźnik nie dostarcza do Twojego domyślnego kraju ani do jednego z krajów, z których otrzymałeś najwięcej zamówień w ostatnich 90 dniach („Żaden przewoźnik nie dostarcza do: …. Kupujący i asystenci nie otrzymują tam żadnej opcji dostawy.”). Poprawka: Otwórz przewoźników i dodaj strefę tego kraju do przewoźnika.
• Zweryfikowani agenci AI – informacja, gdy Rozpoznawaj zweryfikowanych agentów AI jest wyłączone (Otwórz ustawienia) lub gdy żaden agent AI nie wysłał podpisanego żądania w minionym tygodniu (niewielu agentów jeszcze podpisuje). Przechodzi z liczbą żądań od zweryfikowanych agentów. Wymaga uwagi, gdy Twój PHP nie ma rozszerzenia sodium (poproś hosting o jego włączenie) lub gdy większość podpisów znanych agentów nie przeszła weryfikacji: może to powodować proxy lub CDN zmieniający adres sklepu albo błędny zegar serwera; Szczegóły wymieniają powody.
• Zapory i agenci AI – Twój serwer otwiera Twój sklep jak przeglądarka, następnie jak ChatGPT i inni agenci AI, a Twój serwer MCP jak ChatGPT. Przechodzi, gdy agenci dostają Twój sklep tak jak przeglądarka. Zawodzi, gdy zapora lub reguła botów odmawia im lub stawia wyzwanie, i nazywa ją wraz z tym, co zmienić: Cloudflare (polityki botów AI: ustaw Agent i Search na Allow; Bot Fight Mode nie da się obejść regułami), Imunify360, ModSecurity, LiteSpeed, Sucuri, Akamai, BitNinja lub limit hostingu odpowiadający „zbyt wiele żądań”. Wymaga uwagi, gdy Twój serwer nie może otworzyć własnego adresu (częste za zaporami i w Dockerze) lub gdy sam napotyka wyzwanie, więc nie może stwierdzić tego stąd.
• Prośby o zwrot i anulowanie – informacja, gdy oba narzędzia są wyłączone (Otwórz narzędzia). Wymaga uwagi, gdy Poproś o zwrot jest włączone, ale Twój sklep nie przyjmuje zwrotów produktów, więc każda prośba o zwrot jest odrzucana: włącz zwroty w Obsługa klienta › Zwroty produktów (Otwórz zwroty produktów). Pokazuje Twój okres zwrotu.
• Plik produktowy dla ChatGPT – informacja, gdy osobny moduł „OpenAI / ChatGPT Ads” nie jest zainstalowany. Wymaga uwagi, gdy jest zainstalowany, ale nieaktywny w tym sklepie, gdy jego plik produktowy jest wyłączony lub gdy jego dostarczanie (hostowany adres pliku lub SFTP) nie jest jeszcze wybrane (Otwórz jego ustawienia). Przechodzi, gdy obsługuje Twój plik.
• WebMCP w tej przeglądarce – informacja o przeglądarce, której teraz używasz (zobacz Ta przeglądarka i raporty ze sklepu).

Inne częste pytania:

• Asystent mówi, że sklep nie ma narzędzi. Udostępniaj narzędzia w tym sklepie jest wyłączone, żadne narzędzie nie jest włączone w Narzędziach lub pamięć podręczna stron nadal serwuje strony sprzed zmiany: wyczyść ją.
• Asystent nie może dodać do koszyka. Dodaj do koszyka jest wyłączone w Narzędziach; na telefonie kupujący nie połączył swojego konta.
• Kupujący nie może się połączyć. Jego konto utworzono podczas zakupów jako gość (tworzy konto z hasłem) lub inna aplikacja niż ChatGPT lub Claude próbuje się połączyć, gdy Zezwól na dowolną aplikację asystenta jest wyłączone.
• Link do płatności mówi, że jest już nieważny. Został użyty lub wygasł: kupujący prosi asystenta o nowy.
• Asystent mówi, że sklep nie ma odpowiedzi o dostawie lub zwrotach. Napisz odpowiedź w FAQ dla agentów AI lub dodaj stronę o tym w Wygląd › Strony (zobacz FAQ dla agentów AI). Wyszukaj informacje o sklepie musi być włączone w Narzędziach.
• Kod rabatowy jest odrzucany z „Zbyt wiele nieudanych prób”. Z tej sesji lub adresu próbowano zbyt wielu kodów, których Twój sklep nie zna: próby znów działają po pewnym czasie (zobacz Kody rabatowe).
• Zamówienia od asystentów AI pozostają puste. Liczą się tylko ważne zamówienia i tylko te, których koszyk dotknął asystent lub które pochodziły z linku asystenta w ciągu 30 dni; sprawdź, czy Licz zamówienia od asystentów AI jest włączone (Ustawienia › Ustawienia zaawansowane › Rejestrowanie). Za pamięcią podręczną stron opróżnij ją raz po aktualizacji (zobacz Wizyty z linków AI za pamięcią podręczną stron).
• Asystent mówi, że nie może wysłać prośby o zwrot. Poproś o zwrot jest wyłączone w Narzędziach, klient nie jest zalogowany, Twój sklep nie przyjmuje zwrotów produktów, zamówienie nie jest jeszcze dostarczone lub minął jego okres zwrotu albo klient wysłał już dziś 5 próśb.
• Link do koszyka otwiera pusty koszyk. Linki do koszyka dla asystentów AI są wyłączone, produkty są niedostępne lub poza magazynem (strona koszyka je nazywa). Link napełnia koszyk przeglądarki, która go otworzy, a ten sam link dodaje swoje produkty tylko raz w ciągu 10 minut.
• Produkty dla agentów AI pokazują stare wyniki. Wyniki pochodzą z ostatniego sprawdzenia: wybierz Sprawdź ponownie.
• Asystenci nie wspominają Twojego tekstu dla agentów AI. Sprawdź, czy Przekazuj agentom AI swoje teksty o produktach (Ustawienia › Odpowiedzi o produktach) i narzędzie Pokaż szczegóły produktu są włączone oraz czy tekst istnieje w języku kupującego lub w Twoim języku domyślnym.
• Asystenci znajdują mniej produktów niż Twoja wyszukiwarka. Zobacz Indeks wyszukiwania.
• Wywołania są odrzucane z „zbyt wiele żądań” za CDN. Odwiedzający przybywający przez jeden węzeł CDN dzielą jego limity: wypełnij Zaufane serwery proxy opublikowanymi zakresami adresów Twojego CDN (Ustawienia › Ustawienia zaawansowane › Limity).
• Testuj z agentem AI mówi „Dodaj klucz AI lub wybierz wersję demonstracyjną.” Dodaj klucz w Klucze AI lub wybierz wersję demonstracyjną. „Dzisiejszy limit testów AI został osiągnięty.” Podnieś Dzienny budżet testów AI lub poczekaj do jutra; wersja demonstracyjna nadal działa. „… nie odpowiedział na czas.” / „Sklep nie mógł dosięgnąć ….” Twój serwer nie może otwierać połączeń HTTPS do dostawcy: poproś hosting o zezwolenie na wychodzące połączenia HTTPS do dostawcy AI, którego używasz (Anthropic, OpenAI lub Google).
• Audyt mówi „Twój serwer nie mógł otworzyć własnych stron sklepu.” Użyj Sprawdź z tej przeglądarki.
• Wynik nie zmienił się po naprawie. Paski i odpowiedzi pochodzą z ostatniego pełnego uruchomienia: uruchom pełny audyt ponownie.
• Audyt „Agentic browsing” Chrome Lighthouse wymienia elementy bez nazwy. Uruchom pełny audyt i otwórz Dostępność dla agentów AI: jego szczegóły nazywają każdy element, jego stronę i część szablonu, która go drukuje (zobacz Dostępność dla agentów AI). Elementy budowane przez skrypty widzi tylko Lighthouse.
• /llms.txt pokazuje inny tekst niż podsumowanie modułu. Plik o nazwie llms.txt w katalogu głównym sklepu jest serwowany zamiast niego: usuń go lub zmień jego nazwę, aby odpowiadało podsumowanie modułu.
• Link do płatności otwarty na telefonie odpowiada „Nie znaleziono strony”. Na PrestaShop 8 w Menedżerze modułów włączone jest Wyłącz na urządzeniach mobilnych dla modułu: linki do płatności nie otwierają się wtedy na telefonach (nic nie jest zalogowane). Wyłącz je dla tego modułu.

Gdy kontaktujesz się ze wsparciem PrestaChamps, podaj, które wiersze Diagnostyki wymagają uwagi oraz, jeśli dziennik jest włączony, czas i narzędzie nieudanego wywołania.

↑ Powrót na górę

Dla deweloperów

Inne moduły mogą oferować asystentom własne narzędzia przez hook modułu actionPchwebmcpRegisterTools: pojawiają się wtedy w Narzędziach jako „Dodane przez inny moduł”, wyłączone, dopóki ich nie włączysz, i są oferowane asystentom w telefonie tylko wtedy, gdy włączone jest Udostępniaj asystentom w telefonie narzędzia innych modułów. Przewodnik dla deweloperów (dostępny od PrestaChamps) opisuje hook, format narzędzi, poziomy dostępu, API sklepu i serwer MCP.

↑ Powrót na górę