ENPołącz aplikację AI z xSale, aby sprawdzać zamówienia i oferty, przygotowywać podsumowania oraz wykonywać dostępne operacje. Zacznij od połączenia aplikacji, wyboru bazy xSale i zadania, które wymaga tylko odczytu danych.
Asystent, agent i MCP — co oznaczają te pojęcia?
- Asystent AI pomaga w rozmowie: odpowiada na pytania, analizuje dane i proponuje rozwiązania.
- Agent AI może wykonać zadanie w kilku krokach i korzystać z udostępnionych narzędzi. Zakres jego działania zależy od aplikacji, polecenia i uprawnień.
- Harness to środowisko, które prowadzi pracę agenta: udostępnia narzędzia, przekazuje kontekst i obsługuje potwierdzenia. W dokumentacji integracji do tej grupy zaliczamy Codex i Claude Code.
- MCP (Model Context Protocol) to protokół, przez który aplikacja AI korzysta z narzędzi xSale. MCP nie jest osobnym asystentem ani modelem AI.
Ta sama aplikacja może służyć jako asystent i wykonywać zadania jako agent. Samo podłączenie MCP nie daje dostępu do wszystkich danych ani funkcji xSale.
Jak zacząć pracę?
- Przeczytaj zasady bezpieczeństwa danych. Sprawdź ustawienia i warunki usługi AI, z której korzystasz.
- Połącz aplikację zgodnie z jedną z instrukcji poniżej.
- Poproś AI o pokazanie dostępnych baz xSale i wybierz właściwą. Podawaj bazę także wtedy, gdy zaczynasz nowe zadanie.
- Zacznij od małego zakresu, np. sprawdzenia statusu jednego zamówienia. Poproś o odczyt aktualnych danych i o niewprowadzanie zmian.
- Porównaj wynik z danymi w panelu xSale. Gdy wynik jest poprawny, przejdź do kolejnego zadania.
Wybierz aplikację
Co możesz zlecić AI?
W zależności od dostępnych narzędzi i uprawnień możesz zlecić m.in.:
- sprawdzenie listy, szczegółów i historii zamówień;
- podsumowanie liczby i wartości zamówień dla wskazanego okresu;
- odczyt danych ofert, kanałów sprzedaży, parametrów i opisów;
- sprawdzenie integracji dostępnych w wybranej bazie;
- przygotowanie i wykonanie dostępnych zmian, np. zmiany statusu zamówienia lub opisu oferty.
Zakres sprawdzisz w artykule Narzędzia MCP. Gotowe polecenia znajdziesz w przykładach pracy z AI.
Jak działa dostęp do danych?
Operacje w xSale zależą od uprawnień użytkownika i dostępu do wybranej organizacji, czyli bazy xSale. Aplikacja AI nie otrzymuje dodatkowych uprawnień przez samo połączenie. Dostęp do odczytu nie oznacza dostępu do zapisu.
W poleceniu określ bazę, obiekt i zakres zadania. Do wskazania zamówienia lub oferty używaj jednoznacznego identyfikatora. Gdy AI nie może pobrać danych, sprawdź połączenie i uprawnienia zamiast wklejać do rozmowy pełne dane klientów.
Jak zlecać zmiany?
Najpierw poproś o plan: bazę, identyfikatory obiektów, obecne wartości i proponowane zmiany. Sprawdź plan i dopiero wtedy zleć zapis. Po operacji poproś o ponowny odczyt danych.
Zmiana w xSale może uruchomić automatyzacje lub synchronizację z innymi systemami. Potwierdzenie zapisu w xSale nie oznacza, że procesy te już się zakończyły. W razie niejasnego wyniku skorzystaj z artykułu Problemy i zgłaszanie błędów.
Limity korzystania z MCP
Obowiązują limity tempa i równoległości żądań dla użytkownika, firmy i instancji usługi. Jedno narzędzie może wykonać kilka żądań do API. Sprawdź aktualne limity i sposób postępowania po ich przekroczeniu.
Możesz zamówić dodatkowe, wyższe limity dla swojej firmy. Zakres zwiększenia i warunki uzgodnisz z zespołem xSale przez formularz kontaktowy.