Revised:
1. get_account_info (rozsah account.read)
Vráti organizáciu prihláseného používateľa, jeho rolu, plán predplatného a povolené moduly. Asistenti tento nástroj volajú ako prvý, aby zistili, na koho dáta sa pozerajú.
2. list_warehouses (rozsah inventory.read)
Zobrazí zoznam skladov a lokalít organizácie a informáciu o tom, ktorá z nich je prepojená s lokalitou v Shopify.
3. search_products (rozsah catalog.read)
Vyhľadáva produkty podľa názvu, SKU, čiarového kódu, značky alebo modelu a vracia stručný riadok pre každý produkt s cenou, kategóriou a stavom zásob. Výsledky sú stránkované; pre úplný záznam použite get_product.
4. get_product (rozsah catalog.read)
Vráti údaje o jednom produkte, jeho zásoby podľa jednotlivých lokalít a stav zalistovania na predajných kanáloch (marketplaces).
5. get_inventory_summary (rozsah inventory.read)
Vráti celkové množstvo zásob podľa lokalít, aby asistent mohol odpovedať na otázku, koľko zásob má organizácia v každom sklade.
6. find_missing_product_data (rozsah catalog.read)
Vyhľadá produkty, ktorým chýbajú údaje potrebné na predaj (obrázok, cena, kategória, popis, čiarový kód a podobne) a uvedie, čo presne chýba. Výsledky sú stránkované.
7. find_listing_problems (rozsah catalog.read)
Vyhľadá produkty, ktoré sa nezalistovali na trhovisku alebo predajnom kanáli, a vysvetlí chybu zrozumiteľným návrhom na riešenie – napríklad chýbajúci kód EAN vyžadovaný kategóriou Allegro.
8. find_unfulfilled_orders (rozsah orders.read)
Vypíše otvorené objednávky z e-shopov, trhovísk a B2B, ktoré ešte neboli odoslané, spolu s ich zdrojom, partnerom a stavom.
9. search_categories (rozsah catalog.read)
Vyhľadáva v strome produktových kategórií podľa názvu a vracia ID a cesty kategórií; update_product podľa ID nastaví kategóriu.
10. Ako fungujú nástroje na zápis
Nástroje na zápis vyžadujú rozsah catalog.write alebo inventory.write a rolu vlastníka alebo správcu. Každý pracuje v dvoch krokoch: s confirm=false vráti iba náhľad starých a nových hodnôt; s confirm=true a expected_version (verzia produktu z náhľadu alebo z get_product) uloží. Ak sa produkt medzitým zmenil, uloženie sa odmietne. Jedno volanie mení jeden produkt, každá zmena sa zaznamená s pôvodom mcp a nič sa nedá vymazať.
11. update_product (rozsah catalog.write)
Mení názov, popis, značku, typ, kategóriu, čiarový kód, SKU, predajnú cenu alebo stav (aktívny alebo koncept) jedného produktu. Tu zadaná cena je ručná cena, ktorú AI na pozadí nikdy neprepíše. SKU sa mení samostatným volaním.
12. adjust_stock (rozsah inventory.write)
Nastaví, pridá alebo odoberie zásobu jedného produktu v jednej lokácii bežným skladovým pohybom, takže sa aktualizuje aj denník pohybov a synchronizácia zásob so Shopify.
13. set_channel_listing (rozsah catalog.write)
Zapne, vypne alebo vráti na pravidlo kanála jeden produkt na jednom trhovisku alebo kanáli. Použité, repasované alebo poškodené produkty sa nikdy nedajú zapnúť na kanáloch, ktoré prijímajú iba nové produkty (eMAG, Árukereső, Árgép, Pepita).
14. create_product (rozsah catalog.write)
Vytvorí nový produkt podľa čiarového kódu alebo názvu, voliteľne s počiatočnou zásobou v jednej lokácii. AI na pozadí ho identifikuje a doplní zvyšok v bežnom limite najviac 5 volaní AI na produkt; existujúci čiarový kód sa nikdy neduplikuje.
