Chyby
Běžné chyby Listano Control MCP a návod k jejich řešení.
Nástroje Listano Control MCP mohou vracet chyby z důvodu ověřování, oprávnění, validace, kontrol připravenosti nebo selhání při načítání z backendu.
Nejbezpečnější postup při řešení je:
- zkontrolovat chybu
- zavolat
whoami, pokud jsou oprávnění nejasná - zavolat
get-offering, pokud je nejasný aktuální stav konceptu - opravit pouze konkrétní neplatná nebo chybějící data
- znovu zavolat
check-offering-publish-readinesspřed publikováním
Chyby oprávnění
Chyba oprávnění znamená, že ověřená integrace nemá požadovaný rozsah.
| Operace | Požadovaný rozsah |
|---|---|
| výpis/čtení/kontrola | catalog:read |
| vytvoření/aktualizace/překlad/zahození | catalog:write |
| publikování/ukončení | catalog:publish |
Řešení:
- zavolat
whoami - ověřit udělené rozsahy
- požádat o udělení chybějícího rozsahu
Chyby nenalezení
Nabídka nemusí být nalezena, když:
- je
offeringIdnesprávné - nabídka patří jiné společnosti
- integrace je ověřena pro jinou společnost
Řešení:
- zavolat
list-offeringss názvem, SKU nebo jiným známým identifikátorem - před mutací potvrdit vybranou nabídku
Chyby validace
Chyby validace obvykle znamenají, že tvar vstupu nebo hodnota pole je neplatná.
Běžné příčiny:
| Příčina | Řešení |
|---|---|
category_id bez category_label | Zadejte obě pole. |
| Neplatný kód jazyka | Použijte get-supported-languages. |
| Hlavní jazyk zahrnutý v překladech | Odeberte hlavní jazyk z překladového obsahu. |
| Neplatný kód jednotky | Použijte platný 3znakový kód jednotky. |
Atribut má unit, ale nečíselnou hodnotu | Použijte číselnou hodnotu. |
Atribut má valueLabel, ale neřetězcovou hodnotu | Použijte řetězcovou hodnotu. |
Pokus o změnu kind nebo language | Zahoďte koncept a vytvořte novou nabídku. |
Chyby připravenosti k publikování
check-offering-publish-readiness vrací:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Pokud je publishable false, nevolejte publish-offering.
Běžné problémy připravenosti:
- chybějící název, popis nebo měrná jednotka v hlavním jazyce
- chybějící překlady pro podporované jazyky kromě hlavního
- chybějící přeložená označení kategorií
- chybějící překlady atributů
- neplatná kombinace hodnoty/jednotky atributu
- chybějící přeložené popisy atributů nebo popisky hodnot
Řešení:
- opravit vrácené chyby
- znovu zavolat
check-offering-publish-readiness - publikovat pouze tehdy, když je
publishabletrue
Chyby životního cyklu konceptu
Pokud je kind nebo language nesprávné, nepokoušejte se je opravit patchem.
Tato pole jsou neměnná. Správným řešením je zahodit koncept pomocí discard-offering-draft a vytvořit novou nabídku.
Pokud nabídka již má publikovanou aktuální verzi, zahození konceptu neodstraní živou verzi.
Chyby publikování
publish-offering může selhat, pokud je koncept neúplný nebo neplatný.
Řešení:
- zavolat
check-offering-publish-readiness - opravit vrácené chyby
- zkusit publikovat až poté, co připravenost projde
Selhání načítání z backendu
Nástroj může vrátit selhání načítání, když backendový požadavek selže před vrácením platné odpovědi.
Řešení:
- zopakovat stejnou operaci pouze pro čtení, pokud je to vhodné
- vyhnout se opakování mutačních volání, pokud nebyl aktuální stav ověřen pomocí
get-offering - nahlásit chybovou zprávu, pokud selhání přetrvává