Viri

Referenca orodij WareRushAI MCP

Orodja strežnika WareRushAI MCP za branje in pisanje, njihovi obsegi in kaj vračajo ali spreminjajo.

Revised:

1. get_account_info (obseg account.read)

Vrne podjetje prijavljenega uporabnika, njegovo vlogo, naročniški paket in omogočene module. Pomočniki to orodje pokličejo najprej, da ugotovijo, čigave podatke pregledujejo.

2. list_warehouses (obseg inventory.read)

Prikaže seznam skladišč in lokacij podjetja ter navede, katera od njih je povezana z lokacijo v Shopify.

3. search_products (obseg catalog.read)

Išče izdelke po imenu, kodi SKU, črtni kodi, blagovni znamki ali modelu ter vrne kratek vrstični pregled za posamezen izdelek s ceno, kategorijo in zalogo. Rezultati so oštevilčeni po straneh; za celoten zapis uporabite get_product.

4. get_product (obseg catalog.read)

Vrne podatke posameznega izdelka, njegovo zalogo po lokacijah in stanje objave na spletnih tržnicah.

5. get_inventory_summary (obseg inventory.read)

Vrne skupno količino zaloge po lokacijah, da lahko pomočnik odgovori na vprašanje, koliko zaloge ima podjetje v posameznem skladišču.

6. find_missing_product_data (obseg catalog.read)

Poišče izdelke, ki jim manjkajo podatki, potrebni za prodajo (slika, cena, kategorija, opis, črtna koda in podobno), ter navede, kaj manjka. Rezultati so oštevilčeni po straneh.

7. find_listing_problems (obseg catalog.read)

Poišče izdelke, ki niso bili objavljeni na spletni tržnici ali prodajnem kanalu, ter pojasni napako z enostavno rešitvijo, na primer manjkajočo kodo EAN, ki jo zahteva kategorija Allegro.

8. find_unfulfilled_orders (obseg orders.read)

Prikazuje odprta naročila iz spletnih trgovin, spletnih tržnic in B2B kanalov, ki še niso bila odposlana, skupaj z njihovim virom, partnerjem in statusom.

9. search_categories (obseg catalog.read)

Po imenu išče v drevesu kategorij izdelkov in vrne ID-je in poti kategorij; update_product z ID-jem nastavi kategorijo.

10. Kako delujejo orodja za pisanje

Orodja za pisanje zahtevajo obseg catalog.write ali inventory.write in vlogo lastnika ali skrbnika. Vsako deluje v dveh korakih: s confirm=false vrne le predogled starih in novih vrednosti; s confirm=true in expected_version (različica izdelka iz predogleda ali iz get_product) shrani. Če se je izdelek medtem spremenil, se shranjevanje zavrne. En klic spremeni en izdelek, vsaka sprememba se zabeleži z izvorom mcp in ničesar ni mogoče izbrisati.

11. update_product (obseg catalog.write)

Spremeni ime, opis, blagovno znamko, vrsto, kategorijo, črtno kodo, SKU, prodajno ceno ali stanje (aktivno ali osnutek) enega izdelka. Tu nastavljena cena šteje kot ročna cena, ki je AI v ozadju nikoli ne prepiše. SKU se spremeni v ločenem klicu.

12. adjust_stock (obseg inventory.write)

Nastavi, doda ali odvzame zalogo enega izdelka na eni lokaciji z običajnim premikom zaloge, zato se posodobita tudi dnevnik premikov in sinhronizacija zaloge s Shopifyjem.

13. set_channel_listing (obseg catalog.write)

Vklopi, izklopi ali vrne na pravilo kanala en izdelek na eni tržnici ali kanalu. Rabljenih, obnovljenih ali poškodovanih izdelkov nikoli ni mogoče vklopiti na kanalih, ki sprejemajo samo nove izdelke (eMAG, Árukereső, Árgép, Pepita).

14. create_product (obseg catalog.write)

Ustvari nov izdelek iz črtne kode ali imena, po želji z začetno zalogo na eni lokaciji. AI v ozadju ga prepozna in dopolni ostalo v običajni omejitvi največ 5 klicev AI na izdelek; obstoječa črtna koda se nikoli ne podvoji.