Príklady promptov

Helpdesk

Objednávky, produkty, ceny a sklad - čo vidí zákazník na webe a čo je v K2. Treba rolu mcp:helpdesk.

Hľadanie v logoch

nástroj log_search

Čo sa v systéme stalo s objednávkou, platbou, zásielkou alebo produktom – podľa záznamov API.

Prenos objednávky do K2

Čo hovoria logy o objednávke [číslo dokladu, napr. PZ/2026/…]? Prečo neprešla do K2?

Čo uvidíte: posledné záznamy o odoslaní objednávky do K2 vrátane odpovede alebo chyby z K2.

Konkrétny deň

Nájdi v logoch request k proforme s VS [variabilný symbol] z [dátum].

Čo uvidíte: záznamy z celého toho dňa (až 30 dní dozadu) – volanie do K2 a jeho odpoveď.

BoxPI a iné volania api-node

Boli dnes nejaké requesty na BoxPI?

Čo uvidíte: dnešné volania BoxPI (výpis balíkov, založenie balíkov, štítky) s časom a výsledkom.

Chyby API

Padá teraz API? Ukáž posledných pár chýb.

Čo uvidíte: najnovšie chybové záznamy z API s časom, kedy nastali.

Nič sa nenašlo

Hľadaj v logoch [text, ktorý sa nevyskytuje].

Čo uvidíte: že v prehľadanej časti nič také nie je. Ak poznáte deň, opýtajte sa s dátumom – prehľadá sa celý.

Vyhľadanie objednávky

nástroj order_lookup

Kde je objednávka z e-shopu a prečo (ne)prešla do K2.

Stav objednávky podľa čísla dokladu

Kde je objednávka [číslo dokladu, napr. PZ/2026/…]? Prešla už do K2?

Čo uvidíte: či je objednávka v K2, kedy vznikla, kto ju vytvoril, spôsob platby a dopravy a celkovú sumu.

Zákazník poslal len variabilný symbol

Zákazník platil s VS [variabilný symbol, 10 číslic]. Ktorá objednávka to je a je zaplatená?

Čo uvidíte: objednávku k tomuto VS, či je platba online a či už prišla úhrada.

Objednávka nie je v K2

Objednávka [číslo objednávky] sa neobjavila v K2. Prečo?

Čo uvidíte: dôvod – napríklad čaká na online úhradu, platba expirovala, chýba zákazník alebo sa prenos do K2 oneskoril – a čo s tým robiť.

Len holé číslo bez krajiny a roka

Nájdi objednávku [číslo bez prefixu, napr. 262].

Čo uvidíte: zoznam objednávok s týmto číslom z rôznych krajín a rokov; Claude sa opýta, ktorú myslíte.

Úloha v Asane spomína objednávku

Pozri si úlohu v Asane [odkaz na úlohu] a skontroluj objednávku, ktorá je v nej spomenutá. V akom je stave a čo s ňou treba urobiť?

Čo uvidíte: o čo v úlohe ide a k tomu stav objednávky z e-shopu a K2. Funguje, keď máte v asistentovi pripojenú aj Asanu.

Nič sa nenašlo

Pozri objednávku [neexistujúci VS].

Čo uvidíte: že objednávka neexistuje, a radu skúsiť iné číslo (číslo dokladu, VS alebo RID).

Vyhľadanie produktu

nástroj product_lookup

Prečo sa produkt na webe (ne)zobrazuje, nemá cenu alebo ukazuje iný sklad.

Celkový stav produktu

Ako je na tom produkt [K2 kód, napr. 63661] na webe? Zobrazuje sa, dá sa objednať a koľko je skladom?

Čo uvidíte: či produkt návštevník vidí, či sa dá objednať, základnú cenu, sklad a minimálne objednané množstvo.

Produkt nemá cenu

Prečo produkt [K2 kód] nemá na webe cenu?

Čo uvidíte: dôvod – typ karty, pri ktorom web cenu zámerne neukazuje, skryté ceny značky, chýbajúca cena alebo externý cenník.

Zákazník z inej krajiny produkt nevidí

Zákazník z Maďarska hovorí, že nevidí produkt [K2 kód] / nevidí jeho cenu. Prečo?

Čo uvidíte: či má produkt alebo jeho značka obmedzenie krajín, alebo či značka v tej krajine skrýva ceny.

Podľa odkazu z webu

Čo je s týmto produktom? [URL detailu produktu z webu]

Čo uvidíte: to isté ako pri hľadaní podľa kódu – nástroj si kód vezme z odkazu.

Podľa výrobného čísla

Máme v katalógu [výrobné číslo dielu]?

Čo uvidíte: nájdenú kartu, alebo zoznam kariet, ak má výrobné číslo viac produktov.

Nič sa nenašlo

Nájdi produkt [neexistujúci kód].

Čo uvidíte: že produkt v katalógu nie je, a radu skúsiť K2 kód, odkaz alebo výrobné číslo.

Dokumentácia

Hľadanie v dokumentácii platformy SOS. Treba rolu mcp:docs.

Dokument z dokumentácie SOS

nástroj docs_get

Celý dokument z dokumentácie platformy SOS – keď chcete vidieť všetko, nielen úryvok.

Celý dokument

Ukáž mi celý dokument o doprave a cenníkoch špedičných.

Čo uvidíte: celý text dokumentu tak, ako je v dokumentácii, aj s tým, kedy bol naposledy aktualizovaný.

Súvisiaci dokument

V tom dokumente je odkaz na [názov súvisiaceho dokumentu] – otvor ho.

Čo uvidíte: celý súvisiaci dokument, na ktorý pôvodný odkazuje.

Dokument neexistuje

Otvor dokument [názov, ktorý v dokumentácii nie je].

Čo uvidíte: že taký dokument v dokumentácii nie je, a návrh vyhľadať tému podľa obsahu.

Postup písania dokumentácie SOS

nástroj docs_playbook

Ako napísať alebo doplniť dokumentáciu projektu tak, aby ju našli kolegovia aj AI.

Zdokumentovať celý projekt

Zdokumentuj tento projekt podľa štandardu SOS.

Čo uvidíte: návrh zoznamu dokumentov zoskupený podľa oblastí na schválenie; po schválení dokumenty v priečinku .docs/.

Doplniť dokumentáciu po zmene

Na tejto vetve som zmenil výpočet ceny dopravy, aktualizuj k tomu dokumentáciu.

Čo uvidíte: ktoré dokumenty o doprave sa menia alebo pribúdajú, a po schválení ich nové znenie.

Ako sa dokumentácia píše

Aké pravidlá platia pre dokumentáciu SOS?

Čo uvidíte: stručný prehľad štandardu – frontmatter, typy dokumentov, čo do dokumentu nepatrí.

Hľadanie v dokumentácii SOS

nástroj docs_search

Čo o tom hovorí dokumentácia platformy SOS – ako niečo funguje, čo systém vie a nevie a prečo je to tak.

Ako niečo funguje

Ako funguje doprava a špedícia? Podľa čoho sa počíta cena dopravy?

Čo uvidíte: odpoveď z dokumentácie s odkazom na dokumenty, z ktorých pochádza – najprv biznis pohľad, potom technický detail.

Prečo je niečo tak

Prečo sme prešli z Redisu na Valkey?

Čo uvidíte: zdôvodnenie z architektonického rozhodnutia – čo sa riešilo, aké boli možnosti a prečo sa vybrala táto.

Len jedna aplikácia

Čo presne robí API pri indexovaní produktov do Elasticsearchu? Pozri len technickú dokumentáciu API.

Čo uvidíte: technický popis z dokumentácie aplikácie API, bez biznis dokumentov.

Či systém niečo vie

Vie systém [funkcia, napr. rozdeliť objednávku na viac dodávok]?

Čo uvidíte: čo dokumentácia o funkcii hovorí – čo vie, aké má obmedzenia a ako ťažké by bolo ju zmeniť.

Dokumentácia to nepokrýva

Ako sa v systéme nastavuje [téma, ktorú dokumentácia nemá]?

Čo uvidíte: že dokumentácia k tomu nič presné nemá – asistent to povie a nebude si odpoveď vymýšľať.

Prihlásenie

Pod kým ste prihlásení a k čomu máte prístup. Stačí prihlásenie.

Hlásenie vývojárom

nástroj report_issue

Keď vám SOS MCP neporadí, nesedí s tým, čo viete, alebo chcete niečo navrhnúť, asistent to pošle vývojárom.

Asistent sa mýli

To nie je pravda, [čo je v skutočnosti správne]. Nahlás to vývojárom.

Čo uvidíte: asistent opravu prijme a jednou vetou povie, že ju nahlásil vývojárom. Často to urobí aj sám, keď ho opravíte.

Chýba niečo, čo potrebujete

Potrebujem vidieť [čo vám chýba, napr. históriu cien produktu] – keď to nevieš, daj vedieť vývojárom, že by sa to hodilo.

Čo uvidíte: že na to nástroj zatiaľ nie je, a potvrdenie, že požiadavka odišla vývojárom.

Nápad alebo sťažnosť

Nahlás vývojárom: [váš nápad alebo čo vám prekáža].

Čo uvidíte: potvrdenie s číslom hlásenia; vývojár vám môže odpísať na váš e-mail.

Kto som a čo smiem

nástroj whoami

Pod kým ste prihlásení do SOS MCP a ku ktorým nástrojom máte prístup.

Overenie prihlásenia

Pod kým som prihlásený do SOS MCP a čo môžem používať?

Čo uvidíte: vaše meno, roly, oblasti nástrojov, ku ktorým máte prístup, a dokedy prihlásenie platí.

Chýba nástroj

Prečo nevidím nástroj na vyhľadanie objednávky?

Čo uvidíte: ktoré oblasti máte povolené; ak helpdesk medzi nimi nie je, treba požiadať o pridanie roly.