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

Integracja z DeepSeek

DeepSeek jest jednym z czterech dostawców LLM, dla których Endora Commerce przechowuje konfigurację: klucz API, nazwę modelu i opcjonalny adres bazowy. Poniżej opisujemy, co dokładnie jest gotowe, a czego asystent w panelu jeszcze nie obsługuje.

Stan na dziś: konfiguracja tak, asystent jeszcze nie

Warto to powiedzieć na początku, bo od tego zależy decyzja. W module poświadczeń platformy typ „LLM” ma czterech dostawców: GPT (OpenAI), Gemini (Google), Claude (Anthropic) i DeepSeek. Dla każdego z nich zapisujesz ten sam zestaw pól:

  • klucz API - pole tajne, wymagane,
  • model - wymagany, wpisywany jako tekst, a nie wybierany z zamkniętej listy,
  • adres bazowy - opcjonalny, jeśli chcesz nadpisać domyślny punkt końcowy dostawcy.

Asystent w panelu ma natomiast w publicznym kodzie platformy adaptery dla trzech dostawców: Anthropic, Google i OpenAI. Jeśli w jego ustawieniach wskażesz konfigurację z dostawcą DeepSeek, asystent zgłosi stan „nieskonfigurowany” i nie wykona żadnego polecenia. To zachowanie celowe: przy poświadczeniach, których nie potrafi użyć, asystent zamyka się, zamiast próbować innego dostawcy.

W praktyce oznacza to, że konfigurację DeepSeek możesz już bezpiecznie przechowywać i wskazywać w ustawieniach, ale asystent zacznie z niej korzystać dopiero wtedy, gdy powstanie dla niego adapter DeepSeek.

Co dzieje się z kluczem DeepSeek w platformie

Konfigurację tworzysz raz, nadajesz jej nazwę i kod, a ustawienia odwołują się do niej przez ten kod. Wymiana klucza odbywa się w jednym miejscu.

  • Klucz jest szyfrowany w spoczynku i nigdy nie wraca w odpowiedzi w postaci jawnej: po zapisaniu widać tylko, że pole jest ustawione.
  • Utworzenie, edycja i usunięcie konfiguracji trafiają do dziennika audytu, z zamaskowanymi polami tajnymi.
  • Typ i dostawca są po zapisaniu zablokowane. Przejście z DeepSeek na innego dostawcę to nowa konfiguracja, a nie edycja starej.
  • Konfiguracji, do której odwołuje się jakieś ustawienie, nie da się usunąć.

Co DeepSeek udostępnia po swojej stronie

DeepSeek to dostawca modeli językowych z siedzibą w Chinach (Hangzhou DeepSeek Artificial Intelligence Co., Ltd.). Z jego dokumentacji API wynika kilka rzeczy istotnych dla takiej integracji:

  • API ma format zgodny z API OpenAI i Anthropic, a klucz generuje się w panelu platformy deweloperskiej DeepSeek.
  • Modele obsługują wywoływanie narzędzi. To warunek konieczny, bo asystent nie pisze zapytań do bazy, tylko wybiera operacje z zamkniętego katalogu narzędzi zarejestrowanych w kodzie. Tryb ścisłej zgodności ze schematem narzędzia jest u DeepSeek funkcją beta, dostępną pod osobnym adresem bazowym.
  • Nazwy modeli się zmieniają: dokumentacja opisuje starsze nazwy, które są nadal przyjmowane, ale obsługiwane już przez nowszy model. Dlatego nazwa modelu jest w platformie polem konfiguracji, a nie wartością zaszytą w kodzie.
  • Po przekroczeniu limitu równoległych zapytań API zwraca błąd 429. Przy dużym obciążeniu połączenie jest podtrzymywane, a jeśli przetwarzanie nie rozpocznie się w ciągu 10 minut, serwer je zamyka.

Osobna kwestia to lokalizacja danych. Polityka prywatności DeepSeek wskazuje Chiny jako miejsce przetwarzania i przechowywania danych. Do modelu trafia treść polecenia oraz wyniki wyszukiwań, na których asystent buduje plan, czyli na przykład nazwy produktów, magazynów czy dane zamówień. Zanim wybierzesz tego dostawcę, sprawdź aktualne warunki DeepSeek dla API i uzgodnij to z osobą odpowiadającą w firmie za ochronę danych.

Jak działa asystent, którego ta lista dotyczy

Asystent czyta polecenie wpisane w palecie poleceń zwykłym językiem, po polsku albo po angielsku, i buduje plan działania na modelu danych platformy. Pokazuje ten plan, zanim cokolwiek zrobi, i wykonuje go dopiero po Twoim potwierdzeniu. Każda akcja zostaje w granicach Twoich uprawnień i trafia do dziennika audytu, razem z treścią polecenia, dostawcą i modelem.

Kilka faktów, które nie zależą od dostawcy:

  • plan niepotwierdzony w ciągu 10 minut wygasa,
  • jedno polecenie może domyślnie objąć najwyżej 500 rekordów, a większy plan jest blokowany już na etapie podglądu,
  • zmiana konfiguracji działa od następnego polecenia, bez restartu.

Co wybrać dziś

Jeśli asystent ma działać od razu, wskaż w jego ustawieniach konfigurację jednego z trzech obsługiwanych dostawców: Claude, Gemini albo GPT. Zakres poleceń jest ten sam, różni się tylko model, który odpowiada.

Jeśli DeepSeek jest wymaganiem Twojej organizacji, na przykład ze względu na dywersyfikację dostawców, brakującym elementem jest adapter po stronie asystenta. To zmiana w kodzie modułu asystenta, a nie w ustawieniach. Żeby ustalić zakres i termin takiej pracy we wdrożeniu, napisz do nas.

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.