Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z OpenAI (GPT)

Asystent w panelu Endora Commerce może pracować na modelach GPT: na Twoim własnym kluczu API OpenAI i z identyfikatorem modelu, który wpisujesz sam. Poniżej: co dokładnie trafia do OpenAI, czego potrzebujesz po ich stronie i gdzie są granice tej integracji.

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

  1. Konto na platformie API OpenAI z aktywnym rozliczeniem. Subskrypcja ChatGPT nie daje dostępu do API, to osobny produkt i osobne rozliczenie.
  2. 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.
  3. 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.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.