Do czego platforma używa GPT
Model nie odpowiada kupującym i nie generuje treści sklepu. Obsługuje jedną rzecz: tryb poleceń w języku naturalnym w palecie poleceń panelu (⌘K / Ctrl+K). Operator pisze po polsku albo po angielsku, na przykład „ustaw stan Bolts 0193 w magazynie Default na 120”, a GPT zamienia to zdanie na wywołania narzędzi, które platforma sama mu udostępnia.
Lista tych narzędzi jest zamknięta i zapisana w kodzie. Dziś obejmuje wyszukiwanie produktów, kategorii, magazynów i zamówień oraz zmiany: stan magazynowy, przypisanie produktów do kategorii i usunięcie z niej, status i widoczność produktów, status zamówienia (pojedynczo lub masowo). Model nie może wykonać zapytania SQL ani wywołać dowolnego endpointu.
Co trafia do OpenAI, a co zostaje u Ciebie
Zapytanie wychodzi z backendu platformy, nie z przeglądarki operatora, więc klucz API nie opuszcza serwera. Do OpenAI wysyłane są:
- treść polecenia wpisanego przez operatora,
- opisy narzędzi, do których ten operator ma uprawnienia (pozostałych model w ogóle nie widzi),
- wyniki wyszukiwań tylko do odczytu potrzebnych do rozpoznania nazw, czyli krótkie listy pasujących produktów, kategorii, magazynów lub zamówień.
Sama zmiana nie jest wykonywana przez model. Platforma składa z jego wywołań plan, wylicza po swojej stronie nazwy, liczbę rekordów i bieżące wartości, pokazuje kartę planu i czeka na potwierdzenie. Tekst wygenerowany przez model nie jest wyświetlany operatorowi, a wyniki narzędzi są traktowane wyłącznie jako dane, więc produkt nazwany jak instrukcja nie zmieni zachowania asystenta. Przy wykonaniu każda operacja ponownie sprawdza uprawnienia, a w dzienniku audytu zostaje wpis z treścią polecenia, dostawcą i modelem.
Po stronie OpenAI obowiązują ich zasady dla API: dane przesyłane przez API nie służą do trenowania modeli, o ile sam nie wyrazisz na to zgody, a logi monitoringu nadużyć są domyślnie przechowywane do 30 dni. Szczegóły opisuje dokumentacja kontroli danych OpenAI.
Co przygotować po stronie OpenAI
- Konto na platformie API OpenAI z aktywnym rozliczeniem. Subskrypcja ChatGPT nie daje dostępu do API, to osobny produkt i osobne rozliczenie.
- Projekt i klucz API utworzony w tym projekcie. Osobny projekt dla Endora Commerce ułatwia rozdzielenie kosztów i limitów od innych zastosowań w firmie.
- Identyfikator modelu, który obsługuje wywoływanie funkcji (function calling) przez Chat Completions. Platforma nie ma zaszytej listy modeli: wpisujesz identyfikator ręcznie i zmieniasz go, gdy OpenAI udostępni nowszy.
Konfiguracja w panelu
Klucz i model zapisujesz raz, na ekranie Poświadczenia, jako konfigurację typu LLM z dostawcą OpenAI (GPT). Pola to API Key, Model i opcjonalny Base URL. Klucz jest szyfrowany (AES-256-GCM), po zapisaniu nie da się go odczytać z panelu ani z API, a w dzienniku audytu jest zamaskowany. Backend musi mieć ustawioną zmienną SETTINGS_SECRET_ENCRYPTION_KEY, inaczej zapis sekretu się nie powiedzie.
Następnie w Ustawieniach, w grupie asystenta, wskazujesz tę konfigurację w polu poświadczeń LLM i włączasz asystenta. Zmiana działa od następnego polecenia, bez restartu. Operatorzy potrzebują uprawnienia prompt_actions:use, a każda planowana operacja dodatkowo wymaga tego samego uprawnienia co jej ręczny odpowiednik.
Ograniczenia, o których warto wiedzieć
- Stały adres API. Asystent wywołuje
api.openai.com/v1/chat/completions. OpenAI wymaga dla projektów z rezydencją danych poza USA osobnego prefiksu domeny, a taka rezydencja wymaga ich wcześniejszej akceptacji. Jeśli to dla Ciebie warunek, omów to z nami przed wdrożeniem. - Limity OpenAI. Limity zapytań i tokenów zależą od progu wykorzystania konta i od modelu, obowiązują na poziomie organizacji i projektu (dokumentacja limitów). Jedno polecenie to kilka zapytań do modelu, nie jedno.
- Limity platformy. Interpretacja polecenia ma ograniczony czas i liczbę rund. Plan wygasa po 10 minutach bez potwierdzenia. Jedno polecenie może domyślnie objąć do 500 rekordów (wartość zmienisz w ustawieniach), a operacje masowe powyżej 50 rekordów wykonują się w tle.
Ten sam klucz w wyszukiwarce
Drugie miejsce, w którym przydaje się OpenAI, to wyszukiwanie hybrydowe w Meilisearch. Ustawienie embeddera wyszukiwarki także wskazuje konfigurację typu LLM, tyle że w polu Model stoi model embeddingów, a Base URL prowadzi do punktu zgodnego z API OpenAI. W praktyce oznacza to dwie konfiguracje, bo asystent i embedder potrzebują różnych modeli.
Kiedy GPT, a kiedy inny dostawca
GPT jest naturalnym wyborem, gdy firma ma już organizację w OpenAI, uzgodnione warunki przetwarzania danych i budżet na API. Jeśli te same ustalenia macie z Google albo Anthropic, sięgnij po Gemini lub Claude: asystent działa na nich tak samo, a zmiana dostawcy polega na wskazaniu innej konfiguracji w ustawieniach. Zakres tego, co asystent potrafi, nie zależy od modelu, tylko od narzędzi zarejestrowanych przez moduły platformy.