AI Bridge
AI Bridge to opcjonalny moduł, który udostępnia dane Twojego sklepu asystentom AI i narzędziom w sposób kontrolowany. Składa się z dwóch części. Pierwsza to zestaw zdolności (abilities) tylko do odczytu zarejestrowanych w WordPress Abilities API (WP 6.9+), dzięki czemu paleta poleceń edytora witryny, serwery MCP i asystenci AI mogą czytać te same fakty, które widzi administrator. Druga to dwie funkcje wspierane przez AI w panelu: podsumowanie produktu oraz szkic tekstów bezpieczeństwa GPSR, korzystające z WordPress AI Client (WP 7.0+) przez dostawcę skonfigurowanego w witrynie.
Moduł niczego nie zmienia automatycznie. Zdolności wyłącznie czytają dane, a funkcje AI tworzą propozycje do przeglądu, nigdy nie nadpisując pól wymagających ręcznej autoryzacji. Wtyczka nigdy nie przechowuje klucza dostawcy AI. To narzędzie pomocnicze, nie porada prawna ani gwarancja zgodności.
Włączenie modułu
Dział zatytułowany „Włączenie modułu”Moduł jest domyślnie wyłączony. Włącz go w WooCommerce > Polski > Moduły (sekcja “AI Bridge”, klucz modułu ai_bridge). Po włączeniu:
- na WordPress 6.9+ rejestrowane są zdolności handlowe (gdy Abilities API jest dostępne); na starszym WordPress moduł działa bez błędu, po prostu pomija rejestrację,
- funkcje AI (podsumowanie produktu, szkic GPSR) stają się dostępne tylko wtedy, gdy w witrynie skonfigurowano dostawcę AI obsługującego generowanie tekstu (przez WP AI Client / konektor, np. Anthropic, Google, OpenAI, Vercel AI Gateway). Bez skonfigurowanego dostawcy funkcje te po prostu się nie aktywują, a deterministyczny kanał AI Feed pozostaje nienaruszony.
Zdolności handlowe (tylko do odczytu)
Dział zatytułowany „Zdolności handlowe (tylko do odczytu)”Wszystkie zdolności należą do kategorii polski-commerce, są oznaczone jako readonly i show_in_rest, oraz chronione kontrolą uprawnienia WooCommerce manage_woocommerce. Każda jest podpięta do istniejącej usługi wtyczki, więc nie powiela logiki. Nic nie jest zmieniane.
| Zdolność (id) | Co zwraca | Wejście |
|---|---|---|
polski/get-omnibus-history | Historia cen i najniższa zanotowana cena produktu (jak w prezentacji wg dyrektywy Omnibus). | product_id |
polski/get-gpsr-data | Dane bezpieczeństwa produktu (GPSR): producent, importer, osoba odpowiedzialna, identyfikator, ostrzeżenia, instrukcje. | product_id |
polski/list-products-missing-gpsr | Opublikowane produkty, którym brakuje jednego lub więcej pól GPSR, aby znaleźć i uzupełnić luki. | limit (1-200), offset |
polski/get-compliance-status | Wynik heurystycznych kontroli skonfigurowanych stron prawnych (Regulamin, Prywatność, Zwroty, Reklamacje) z oceną. | page_type (opcjonalnie) |
polski/get-store-health | Najnowszy snapshot kondycji sklepu (status ogólny oraz czujniki błędów, płatności i sprzedaży). | (brak) |
polski/get-product-facts | Ustrukturyzowana lista faktów o produkcie (pary etykieta/wartość) udostępniana przez AI Feed: SKU, GTIN, cena, kategorie, czas dostawy i inne. | product_id |
Każde wywołanie przechodzi przez permission_callback sprawdzający manage_woocommerce. Użytkownik bez tego uprawnienia nie otrzyma danych. Zdolności są dostępne przez REST (/wp-json/wp-abilities/v1/...), gdy Abilities API jest aktywne.
Podsumowanie produktu (AI)
Dział zatytułowany „Podsumowanie produktu (AI)”Generowane na żądanie administratora podsumowanie faktograficzne produktu. Działa tylko, gdy moduł jest włączony i skonfigurowano dostawcę AI obsługującego tekst. Nic nie powstaje przy ładowaniu strony.
| Aspekt | Zachowanie |
|---|---|
| Źródło danych | Nazwa, krótki i długi opis produktu oraz lista faktów AI Feed - tylko dane już publikowane przez sklep. |
| Model | Instruowany, by korzystać wyłącznie z podanych faktów, nie wymyślać specyfikacji ani cen, bez sformułowań marketingowych i bez deklaracji prawnych. |
| Długość | Krótkie, 1-3 zdania; zapis ograniczony do 600 znaków. |
| Zapis | Przechowywane w meta produktu (_polski_ai_summary) wyłącznie po jawnym uruchomieniu przez administratora. |
| Brak dostawcy | Funkcja jest niedostępna; nic się nie dzieje, a pozostałe ścieżki działają bez zmian. |
Szkic tekstów bezpieczeństwa GPSR (AI)
Dział zatytułowany „Szkic tekstów bezpieczeństwa GPSR (AI)”Pomocnik tworzący szkic ostrzeżeń bezpieczeństwa i instrukcji użytkowania produktu jako punkt wyjścia do ręcznej weryfikacji. To wsparcie redakcyjne, nie porada prawna ani gwarancja zgodności.
| Aspekt | Zachowanie |
|---|---|
| Źródło danych | Publiczny opis produktu oraz już wprowadzone (przez człowieka) pola GPSR, aby szkic nie przeczył istniejącym danym. |
| Model | Instruowany, by używać wyłącznie podanych faktów, nie wymyślać zagrożeń ani certyfikatów oraz nie sugerować zgodności prawnej. |
| Zapis | Wyłącznie do osobnego, jednoznacznie nazwanego meta szkicu (_polski_ai_gpsr_draft). Nigdy nie nadpisuje prawdziwych pól GPSR. |
| Przegląd | Administrator musi przeczytać szkic i ręcznie przenieść treść do właściwych pól po weryfikacji. Każdy szkic zawiera notatkę, że jest tylko do przeglądu i nie stanowi gwarancji zgodności. |
| Długość | Każde pole szkicu ograniczone do 1500 znaków. |
Prywatność i klucze
Dział zatytułowany „Prywatność i klucze”Wtyczka nigdy nie przechowuje klucza dostawcy AI i sama nie wykonuje żądań sieciowych do dostawcy. Poświadczenia oraz wywołanie sieciowe należą do konektora AI skonfigurowanego w WordPress (model “przynieś własny klucz”). Do modelu trafiają wyłącznie dane, które sklep i tak już publikuje lub przechowuje.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”Zdolności nie pojawiają się - upewnij się, że masz WordPress 6.9+ z aktywnym Abilities API oraz że moduł AI Bridge jest włączony. Na starszym WordPress rejestracja jest pomijana bez błędu.
Funkcje AI są wyszarzone - skonfiguruj dostawcę AI obsługującego generowanie tekstu przez WP AI Client / konektor. Bez dostawcy podsumowanie i szkic GPSR pozostają nieaktywne.
Brak danych ze zdolności - sprawdź, czy bieżący użytkownik ma uprawnienie manage_woocommerce.
Zgłaszanie problemów: github.com/wppoland/polski/issues