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

Integracja z Anthropic Claude

Modele Claude mogą napędzać asystenta w panelu Endora Commerce na Twoim własnym kluczu API Anthropic. Poniżej: co dokładnie model robi, jakie dane do niego trafiają i co przygotować w Claude Console.

Do czego Claude służy w panelu

Claude to rodzina modeli językowych firmy Anthropic, dostępna przez Claude API. W Endora Commerce pełni jedną rolę: interpretuje polecenia wpisywane w palecie poleceń panelu administracyjnego. Operator pisze po polsku albo po angielsku, na przykład „ustaw stan Bolts 0193 w magazynie Default na 120”, a model zamienia to zdanie w wywołania narzędzi, które platforma mu udostępnia.

Model nie ma dostępu do bazy danych ani do dowolnych endpointów. Dostaje zamkniętą listę narzędzi zarejestrowanych w kodzie, obecnie są to:

  • wyszukiwanie produktów, kategorii, magazynów i zamówień (tylko odczyt),
  • ustawienie stanu magazynowego,
  • przypisanie produktów do kategorii i usunięcie ich z kategorii,
  • zmiana statusu i widoczności produktów,
  • zmiana statusu zamówienia, pojedynczo albo masowo.

Narzędzia, do których operator nie ma uprawnień, nie są modelowi w ogóle pokazywane. Lista rośnie razem z modułami, bo każdy moduł może zgłosić własne narzędzia.

Co widzi operator

Po wysłaniu polecenia pojawia się karta planu: konkretne operacje, obecna wartość, liczba rekordów i próbka przy zmianach masowych. Wszystko na tej karcie jest wyliczone przez serwer, a nie napisane przez model. Dopiero potwierdzenie uruchamia zmianę, a plan bez potwierdzenia wygasa po 10 minutach. Jeśli polecenie jest niejednoznaczne, asystent zadaje jedno pytanie doprecyzowujące z konkretnymi kandydatami, zamiast zgadywać.

Operacje obejmujące więcej niż 50 rekordów wykonują się w tle, a domyślny limit to 500 rekordów na jedno polecenie. Każde wykonanie trafia do dziennika audytu razem z treścią polecenia, nazwą dostawcy i modelu, więc po czasie widać, że daną zmianę zaplanował Claude i w której wersji. Szerszy opis asystenta jest na stronie funkcji.

Jakie dane trafiają do Anthropic

Do Claude API wysyłane są: treść polecenia, opisy dostępnych narzędzi oraz wyniki wyszukiwań, którymi asystent rozpoznaje rekordy wskazane w poleceniu. Klucz API nie opuszcza backendu, a wyniki narzędzi są traktowane wyłącznie jako dane, więc produkt nazwany jak instrukcja nie zmieni zachowania asystenta.

Według zasad Anthropic dane wejściowe i wyjściowe z produktów komercyjnych, w tym z API, domyślnie nie są używane do trenowania modeli. Warunki przetwarzania danych warto mimo to sprawdzić w umowie zawartej z Anthropic przez Twoją organizację.

Co przygotować po stronie Anthropic

  1. Konto organizacji w Claude Console i skonfigurowane rozliczenia.
  2. Klucz API utworzony dla jednej przestrzeni roboczej (workspace). Osobna przestrzeń dla panelu pozwala ustawić jej własny limit wydatków i oddzielić zużycie od innych zastosowań w firmie.
  3. Identyfikator modelu z dokumentacji Anthropic, na przykład claude-sonnet-5-5. Wszystkie obecne modele Claude obsługują wywoływanie narzędzi, czyli to, czego asystent wymaga.

Limity zapytań i miesięczny limit wydatków są przypisane do organizacji i zależą od jej poziomu użycia. Nowe organizacje zaczynają od niższych limitów, które rosną wraz z historią korzystania z API. Szczegóły opisuje dokumentacja limitów.

Konfiguracja w Endora Commerce

Na ekranie poświadczeń tworzysz konfigurację typu LLM, wybierasz dostawcę Anthropic (Claude), wpisujesz klucz API i nazwę modelu. Klucz jest szyfrowany, po zapisaniu nigdy nie wraca w odpowiedzi API i jest maskowany przy każdym odczycie. Tę konfigurację wskazujesz następnie w ustawieniach asystenta i włączasz go. Operatorzy potrzebują jeszcze uprawnienia prompt_actions:use, a każda zaplanowana operacja wymaga tego samego uprawnienia co jej ręczny odpowiednik.

Zmiana modelu albo klucza działa od następnego polecenia, bez restartu.

Na co uważać

  • Wycofywanie modeli. Identyfikator modelu wpisujesz ręcznie, a Anthropic wycofuje starsze modele według publikowanego harmonogramu. Po dacie wycofania trzeba podmienić identyfikator w konfiguracji.
  • Bezpośrednie Claude API. Integracja łączy się z api.anthropic.com. Nie obejmuje modeli Claude udostępnianych przez Amazon Bedrock czy Google Cloud.
  • Limit wydatków. Po jego osiągnięciu API odrzuca zapytania. Asystent nie zbuduje wtedy planu, ale nic się nie zmieni w danych, a panel działa dalej bez trybu poleceń.

Kiedy wybrać Claude

Zakres działania asystenta nie zależy od dostawcy: adaptery dla Claude, GPT i Gemini korzystają z tej samej listy narzędzi i tego samego mechanizmu potwierdzania. Claude jest naturalnym wyborem, gdy firma ma już umowę i rozliczenia z Anthropic albo standaryzuje się na tych modelach w innych narzędziach. Jeśli masz już konto i rozliczenia u innego z tych dostawców, prościej będzie zacząć od niego, a model zmienić później w konfiguracji. Pozostałe integracje znajdziesz w katalogu integracji.

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.