Revised:
1. get_account_info (zakres account.read)
Zwraca dane firmy zalogowanego użytkownika, jego rolę, plan subskrypcyjny oraz aktywne moduły. Asystenci wywołują to narzędzie w pierwszej kolejności, aby ustalić, czyje dane przeglądają.
2. list_warehouses (zakres inventory.read)
Zwraca listę magazynów i lokalizacji firmy oraz informację, które z nich są powiązane z lokalizacją Shopify.
3. search_products (zakres catalog.read)
Wyszukuje produkty po nazwie, SKU, kodzie kreskowym, marce lub modelu i zwraca skrócony wiersz dla każdego produktu z ceną, kategorią oraz stanem magazynowym. Wyniki są stronicowane; pełny rekord można pobrać za pomocą get_product.
4. get_product (zakres catalog.read)
Zwraca dane jednego produktu, jego stan magazynowy w podziale na lokalizacje oraz status publikacji na marketplace'ach.
5. get_inventory_summary (zakres inventory.read)
Zwraca łączną ilość zapasów w podziale na lokalizacje, dzięki czemu asystent może odpowiedzieć na pytanie, ile towaru firma posiada w każdym magazynie.
6. find_missing_product_data (zakres catalog.read)
Znajduje produkty, którym brakuje danych wymaganych do sprzedaży (zdjęcie, cena, kategoria, opis, kod kreskowy itp.) i wymienia brakujące elementy. Wyniki są stronicowane.
7. find_listing_problems (zakres catalog.read)
Znajduje produkty, które nie zostały wystawione na marketplace lub kanale sprzedaży, i wyjaśnia błąd prostym językiem, proponując rozwiązanie, np. brakujący numer EAN wymagany przez kategorię Allegro.
8. find_unfulfilled_orders (zakres orders.read)
Wyświetla otwarte zamówienia ze sklepów internetowych, marketplace'ów i B2B, które nie zostały jeszcze wysłane, wraz z ich źródłem, partnerem i statusem.
9. search_categories (zakres catalog.read)
Przeszukuje drzewo kategorii produktów według nazwy i zwraca identyfikatory i ścieżki kategorii; update_product ustawia kategorię na podstawie identyfikatora.
10. Jak działają narzędzia zapisu
Narzędzia zapisu wymagają zakresu catalog.write lub inventory.write oraz roli właściciela lub administratora. Każde działa w dwóch krokach: przy confirm=false zwraca tylko podgląd starych i nowych wartości; przy confirm=true i expected_version (wersja produktu z podglądu lub z get_product) zapisuje. Jeśli produkt w międzyczasie się zmienił, zapis zostaje odrzucony. Jedno wywołanie zmienia jeden produkt, każda zmiana jest rejestrowana ze źródłem mcp i niczego nie można usunąć.
11. update_product (zakres catalog.write)
Zmienia nazwę, opis, markę, typ, kategorię, kod kreskowy, SKU, cenę sprzedaży lub status (aktywny lub szkic) jednego produktu. Ustawiona tu cena jest ceną ręczną, której AI w tle nigdy nie nadpisuje. SKU zmienia się osobnym wywołaniem.
12. adjust_stock (zakres inventory.write)
Ustawia, zwiększa lub zmniejsza stan jednego produktu w jednej lokalizacji zwykłym ruchem magazynowym, dzięki czemu aktualizują się także dziennik ruchów i synchronizacja stanów z Shopify.
13. set_channel_listing (zakres catalog.write)
Włącza, wyłącza lub przywraca regułę kanału dla jednego produktu na jednym marketplace lub kanale. Produktów używanych, odnowionych lub uszkodzonych nigdy nie można włączyć na kanałach przyjmujących tylko nowe produkty (eMAG, Árukereső, Árgép, Pepita).
14. create_product (zakres catalog.write)
Tworzy nowy produkt na podstawie kodu kreskowego lub nazwy, opcjonalnie ze stanem początkowym w jednej lokalizacji. AI w tle go rozpoznaje i uzupełnia resztę w zwykłym limicie maksymalnie 5 wywołań AI na produkt; istniejący kod kreskowy nigdy nie jest duplikowany.
