Problemy i zgłaszanie błędów

Najpierw ustal, czy problem dotyczy połączenia, uprawnień, dostępnych narzędzi czy wyniku zadania. Jeśli operacja mogła zmienić dane, sprawdź ich stan przed ponowieniem polecenia.

Nie można połączyć aplikacji z xSale

1. Porównaj konfigurację z instrukcją swojej aplikacji: ChatGPT, Claude, Codex lub Claude Code.
2. Sprawdź adres serwera MCP i metodę połączenia. Nie zastępuj adresu serwera adresem panelu xSale.
3. Sprawdź, czy autoryzacja została zakończona i czy używasz właściwego konta.
4. Jeśli autoryzacja wygasła, połącz konto ponownie. Nie wklejaj danych dostępowych do rozmowy z AI.
5. Zapisz dokładny komunikat błędu i godzinę zdarzenia. Jeśli problem trwa, dołącz te informacje do zgłoszenia.

Połączenie działa, ale AI nie widzi narzędzi

Aplikacja może wymagać ponownego pobrania listy narzędzi lub rozpoczęcia nowej sesji po zmianie konfiguracji. Sposób odświeżenia zależy od aplikacji i jej wersji.

• ChatGPT: sprawdź, czy połączenie xSale jest dostępne w używanej rozmowie. Jeżeli ustawienia połączenia udostępniają odświeżenie narzędzi, wykonaj je, a następnie sprawdź połączenie w nowej rozmowie.
• Codex: sprawdź stan połączenia MCP w środowisku, w którym wykonujesz zadanie. Po zmianie konfiguracji uruchom nową sesję i ponownie sprawdź dostępne narzędzia.
• Claude: sprawdź, czy połączenie xSale jest dostępne w bieżącej rozmowie. Użyj odświeżenia, jeśli aplikacja je udostępnia, lub ponownie połącz konto i rozpocznij nową rozmowę.
• Claude Code: sprawdź stan serwera MCP w używanej sesji i zakres konfiguracji. Po zmianie konfiguracji połącz serwer ponownie lub uruchom nową sesję.

Po odświeżeniu zleć prosty odczyt. Jeśli nadal brakuje narzędzi, zapisz ich widoczną listę oraz komunikat błędu. Nie testuj połączenia operacją zmieniającą dane.

Nie widać bazy albo operacja zwraca brak uprawnień

1. Sprawdź, do jakiego konta xSale podłączona jest aplikacja.
2. Poproś AI o listę dostępnych organizacji i wybierz właściwą bazę.
3. Sprawdź dostęp do tej bazy na tym samym koncie w panelu xSale.
4. Jeśli odczyt działa, a zapis jest odrzucany, sprawdź uprawnienia do konkretnej operacji z administratorem swojej organizacji.

Zmiana modelu AI nie nada dodatkowych uprawnień do xSale.

AI podaje błędny lub niepełny wynik

1. Wskaż bazę, identyfikator obiektu, okres i warunki wyboru danych.
2. Poproś o aktualny odczyt przez narzędzie xSale. Sprawdź, czy AI faktycznie wywołała narzędzie, czy tylko odpowiedziała na podstawie rozmowy.
3. Przy liście sprawdź filtry, limit i kolejne strony wyników. Przy podsumowaniu sprawdź daty, walutę i sposób liczenia wartości.
4. Podziel duże zadanie na mniejsze kroki. Porównaj wynik dla jednego zamówienia lub oferty z panelem xSale.
5. Jeżeli rozmowa zawiera dużo wcześniejszych ustaleń, rozpocznij nową i podaj krótki opis aktualnego zadania.

Kontekst, pamięć i model — co warto sprawdzić?

Kontekst to informacje dostępne AI podczas bieżącego zadania, np. polecenie, fragmenty rozmowy, pliki i wyniki narzędzi. W długiej rozmowie nie zakładaj, że każde wcześniejsze ustalenie nadal jest dostępne. Powtórz bazę, cel i ograniczenia przed ważną operacją.

Pamięć aplikacji, jeśli jest dostępna i włączona, służy do zachowania wybranych informacji między rozmowami. Nie traktuj jej jako aktualnego źródła danych xSale ani potwierdzenia uprawnień.

Model z rozumowaniem może pomóc przy złożonej analizie i zadaniach wieloetapowych. Nie naprawia jednak połączenia, brakujących narzędzi ani błędnych danych wejściowych. Jeśli aplikacja umożliwia wybór modelu, sprawdź taki model po wykluczeniu tych problemów. Nadal weryfikuj wynik przed zapisem.

Na wynik może wpływać również ustawiony poziom rozumowania, jeśli aplikacja udostępnia taki wybór. xSale może sprawdzić działanie swoich narzędzi MCP, ale nie kontroluje całego kontekstu ani wszystkich decyzji aplikacji AI. Zgłoszenie pomaga ustalić, czy problem powstał w narzędziu, konfiguracji czy interpretacji wyniku.

AI zgłasza zapis, ale wynik jest niejasny

1. Nie ponawiaj od razu operacji. Błąd lub przerwanie odpowiedzi nie przesądza, że zapis nie nastąpił.
2. Odczytaj stan obiektu w xSale i sprawdź, czy wartości się zmieniły.
3. Jeżeli zmiana jest w xSale, ale brakuje jej w ERP lub marketplace, sprawdź przebieg odpowiedniej synchronizacji.
4. Jeśli nie możesz ustalić wyniku, przerwij dalsze zmiany i zgłoś problem.

Jak zgłosić błąd?

W zgłoszeniu do wsparcia xSale podaj:

• aplikację AI, jej wersję, jeśli jest dostępna, nazwę modelu i ustawiony poziom rozumowania, jeśli można go wybrać;
• datę i godzinę zdarzenia wraz ze strefą czasową;
• bazę xSale oraz identyfikator zamówienia lub oferty potrzebny do diagnozy;
• polecenie, oczekiwany wynik i wynik uzyskany;
• nazwę narzędzia i dokładny komunikat błędu, jeśli są widoczne;
• informację, czy doszło do zmiany danych i co już sprawdzono.

Jeśli aplikacja pozwala udostępnić rozmowę, możesz dołączyć link dopiero po sprawdzeniu i usunięciu danych osobowych, poufnych oraz dostępowych. Jeśli nie możesz bezpiecznie oczyścić rozmowy lub funkcja udostępniania jest niedostępna, prześlij potrzebny fragment tekstu albo zrzut ekranu po usunięciu tych danych.

Link do rozmowy nie odtwarza całego kontekstu. Może nie obejmować konfiguracji połączenia, pamięci, instrukcji projektu, załączników lub wyników narzędzi. Dlatego zawsze dodaj krótki opis pozwalający odtworzyć problem.

Przed wysłaniem materiałów sprawdź zasady bezpieczeństwa danych.

Przekroczony limit żądań lub równoległych operacji

Przerwij kolejne próby, ogranicz liczbę równoległych zadań i odczekaj czas podany w odpowiedzi, jeśli jest dostępny. Jeśli zadanie mogło już zmienić dane, sprawdź ich stan przed ponowieniem. Zobacz limity, komunikaty błędów i możliwość zamówienia wyższych limitów.