Listano Docs
AI-integrációListano Control MCP

Ajánlott munkafolyamat

A Listano Control MCP katalóguseszközök biztonságos használatának sorrendje.

Ajánlott munkafolyamat

Kövesse ezt a munkafolyamatot ajánlatok létrehozása, szerkesztése vagy közzététele előtt.

A cél az ismétlődő ajánlatok, érvénytelen adatok, hiányos fordítások és nem biztonságos közzétételek elkerülése.

Szokásos katalógus-munkafolyamat

  1. Azonosítsa a hitelesített vállalatot
    Hívja meg a whoami eszközt a vállalat és az elérhető hatókörök megerősítéséhez.

  2. Olvassa el a katalógus útmutatást
    Hívja meg a catalog-readme eszközt a katalógusadatok módosítása előtt.

  3. Ellenőrizze a támogatott nyelveket
    Hívja meg a get-supported-languages eszközt fordítások létrehozása előtt.

  4. Keressen a létrehozás előtt
    Hívja meg a list-offerings eszközt minden elérhető cím, SKU, márka, URL vagy azonosító felhasználásával.

  5. Hozza létre vagy válassza ki az ajánlatot
    Csak akkor hozzon létre új vázlatot, ha nincs megfelelő meglévő ajánlat.

  6. Írja be az alapmezőket
    Használja a new-offering eszközt az első létrehozáshoz, vagy az update-offering-core eszközt a főnyelvi skaláris mezők frissítéséhez.

  7. Írja be az ajánlatfordításokat
    Használja az upsert-offering-translations eszközt a támogatott nem főnyelvekhez.

  8. Írja be az attribútum alapokat
    Használja az upsert-offering-attributes eszközt tényszerű vevő-összehasonlítási attribútumokhoz.

  9. Írja be az attribútumfordításokat
    Használja az upsert-offering-attribute-translations eszközt minden olyan attribútumhoz, amelynek lefordított címkékre, leírásokra vagy értékcímkékre van szüksége.

  10. Ellenőrizze a közzétételre való felkészültséget
    Mindig hívja meg a check-offering-publish-readiness eszközt közzététel előtt.

  11. Csak akkor tegye közzé, ha kész
    Hívja meg a publish-offering eszközt csak akkor, ha a felkészültség ellenőrzése publishable: true értéket ad vissza.

  12. Javítson és próbálja újra, ha szükséges
    Ha a felkészültség ellenőrzése hibákat ad vissza, javítsa a vázlatot és ellenőrizze újra a felkészültséget.

Ajánlat létrehozásának munkafolyamata

whoami
catalog-readme
get-supported-languages
list-offerings
new-offering
upsert-offering-translations
upsert-offering-attributes
upsert-offering-attribute-translations
check-offering-publish-readiness
publish-offering

Csak akkor hívja meg a publish-offering eszközt, ha a közzétételt kérték és a felkészültség ellenőrzése sikerrel járt.

Ajánlat módosításának munkafolyamata

whoami
catalog-readme
list-offerings or get-offering
update-offering-core
upsert-offering-translations
upsert-offering-attributes
upsert-offering-attribute-translations
check-offering-publish-readiness
publish-offering

Ha több ajánlat is megfelelhet a kérésnek, ne módosítson semmit. Kérje meg a felhasználót, hogy válassza ki a megfelelő ajánlatot.

Fordítási szabályok

  • Ne vegye bele az ajánlat főnyelvét a fordítási adatokba.
  • Csak támogatott nyelvkódokat használjon.
  • Az ajánlatfordítások additívak: az adott hívásban szereplő nyelvek lecserélődnek, a nem szereplők megmaradnak.
  • Közzététel előtt minden támogatott nem főnyelvnek jelen kell lennie.

Attribútumszabályok

  • Az attribútum name egy stabil gépi kulcs.
  • Meglévő attribútum frissítéséhez ugyanazt a name értéket használja.
  • Ha egy attribútumnak van unit értéke, akkor a value értéknek számnak kell lennie.
  • Ha egy attribútumnak van valueLabel értéke, akkor a value értéknek stringnek kell lennie.
  • Ha egy attribútumnak van description értéke, a közzétételhez lefordított leírások szükségesek.
  • Ha egy attribútumnak van valueLabel értéke, a közzétételhez lefordított értékcímkék szükségesek.

Biztonságos viselkedés

Ne találjon ki termékjellemzőket, kategóriakódokat, HS-kódokat, eredetadatokat, tanúsítványokat, mennyiségeket, árakat vagy műszaki specifikációkat.

Ha a forrásadat hiányos, hagyja az ajánlatot vázlatként, és jelezze, mi hiányzik.