Odstraňování problémů s vyhledáváním v backendu – Yext Help

Pokud se u vás objevují problémy s kvalitou výsledků vyhledávání, např. algoritmus vrací jiné výsledky, než byste očekávali, jedná se o problém s backendem.

Níže jsou uvedeny doporučené kroky, jak začít s odstraňováním problémů s backendem. Změny konfigurace by se měly projevit okamžitě, proto při ukládání změn znovu spusťte vyhledávání a ověřte, zda je problém vyřešen. Jakmile problém vyřešíte, můžete přeskočit zbývající kroky. Pokud se problém nadále objevuje i po dokončení těchto kroků, další pokyny naleznete v článcích nápovědy k řešení konkrétních problémů.

Obecný postup ladění backendu najdete v článku nápovědy Ladění backendu. Na této stránce použijeme koncepty popsané v daném dokumentu.

Otevřete protokol vyhledávání pro dotaz, u kterého se objevují problémy. Můžete to udělat dvěma způsoby:
1. Přejděte přímo na obrazovku Protokoly vyhledávání
  1. V navigačním panelu klikněte na Search a pak klikněte na požadované rozhraní Search.
  2. Klikněte na Protokoly vyhledávání.
  3. Klikněte na požadovaný protokol vyhledávání. V případě potřeby můžete také použít panel vyhledávání.
2. Spusťte test vyhledávání a odtud otevřete protokol vyhledávání
  1. V navigačním panelu klikněte na Search a pak klikněte na požadované rozhraní Search.
  2. Kliknutím na Test vyhledáváníotevřete test vyhledávání na celou obrazovku nebo kliknutím na jednu z obrazovek Konfigurace na navigačním panelu otevřete test vyhledávání v postranním panelu.
  3. Spustit test vyhledávání.
  4. Klikněte na Ladění dotazu.
Zkontrolujte požadavek rozhraní API: Klikněte na rozevírací tlačítko a v rozevírací nabídce klikněte na Zobrazit kód.
1. Pokud se objeví chyba BACKEND_ERROR, znamená to, že existuje základní problém. Odešlete žádost o podporu, aby ji mohl posoudit náš technický tým.
Zkontrolujte verze a štítky konfigurace: Tyto údaje jsou uvedeny v metadatech v horní části protokolu vyhledávání. Ujistěte se, že používáte správnou verzi a štítek (staging nebo produkční prostředí). Neočekávané výsledky jsou často způsobeny tím, že prostředí odkazuje na zastaralou verzi konfigurace.
1. Pokud používáte nesprávný štítek, spusťte vyhledávání znovu ve správném odkazu pro nasazení nebo opravte štítek v testu vyhledávání.
2. Pokud potřebujete tyto verze aktualizovat nebo chcete zjistit, které verze jsou k dispozici:
  1. V navigačním panelu klikněte na Search a pak klikněte na požadované rozhraní Search.
  2. Klikněte na Historie revizí.
  3. Kliknutím na rozevírací nabídku příslušného štítku zobrazíte dostupné verze a zvolíte verzi, kterou chcete nastavit.
  4. Všechny verze v rozevírací nabídce zobrazují datum a čas uložení. Pokud chcete získat další informace, přejděte na obrazovku Historie revizí, kde zjistíte, kdo verzi aktualizoval, a můžete si stáhnout konfiguraci.
Zkontrolujte své národní prostředí: národní prostředí vašeho vyhledávání musí odpovídat národním prostředím subjektů, které se pokoušíte vrátit. Pokud vaše profily subjektů používají národní prostředí „English“ (en), musí být požadované národní prostředí přesně „en“. Požadavky na jiná podobná národní prostředí, například „en_GB“ nebo „en_US“, vrátí pouze profily s přesně tímto národním prostředím.
1. Zkontrolujte národní prostředí profilů subjektů.
  1. Pokud váš účet používá pouze jeden jazyk, přejděte do Nastavení účtu a klikněte na Osobní nastavení. Zkontrolujte, co je vyplněno v poli Primární jazyk účtu.
  2. Pokud váš účet používá více jazyků, může každý subjekt používat jiné národní prostředí. Jazyk můžete zkontrolovat u jednotlivých subjektů nebo exportovat subjekty a zahrnout pole „Jazyk profilu“.
  3. Porovnejte jazyky s národními prostředími pomocí tohoto referenčního dokumentu Jazyky a národní prostředí.
2. V navigačním panelu klikněte na Search a pak klikněte na požadované rozhraní Search.
3. Klikněte na Upravit jako JSON.
4. Vyplňte vlastnost supportedLocales seznamem relevantních národních prostředí oddělených čárkami. Ujistěte se, že je každé národní prostředí uvedeno v uvozovkách. Formát by měl vypadat takto:
```
"supportedLocales": ["de","es"],
```
Zkontrolujte to znovu za chvíli: Pokud se jedná o zcela nový účet nebo jste nedávno provedli značný počet aktualizací subjektů (nebo konfigurace, která ovlivňuje mnoho subjektů), může několik minut trvat, než se změny projeví. Spusťte za chvíli vyhledávání znovu a zjistěte, zda se výsledky změnily.
1. Podívejte se na web Yext Trust, zda nedochází k incidentu v rámci celého systému, který by mohl způsobovat zpoždění.
Zkontrolujte tokeny, ze kterých se vyhledávání skládá: Tokeny dotazu ovlivní, co se vyhledává, která pravidla dotazů se spustí a která synonyma se použijí. Zobrazují se v poli faktorů vyhledávání na pravé straně protokolu vyhledávání.
1. Pokud se ve vyhledávacím dotazu nacházejí slova, která jsou identifikována jako tokeny, ale způsobují zobrazení nesouvisejících výsledků (např. název vaší značky), nastavte je jako další stop slovo:
  1. V navigačním panelu klikněte na Search a pak klikněte na požadované rozhraní Search.
  2. Klikněte na Obecná nastavení.
  3. V části Další stop slova zadejte požadovaný výraz.
2. Pokud se ve vyhledávacím dotazu nacházejí slova, která nejsou identifikována jako tokeny, jedná se buď o integrované stop slovo (např. „nebo“, „z“ nebo „v“) nebo další stop slovo. Zkontrolujte vlastnost dalších stop slov podle výše uvedených kroků a v případě potřeby termín odstraňte.
3. Pokud se dotaz vyhledávání skládal z více slov (např. „faktory vyhledávání na úrovni vyhledávání“), z nichž každý byl považován za samostatný token (např. „na úrovni vyhledávání“, „vyhledávání“ a „faktory“), ale ve skutečnosti by měly být jedním tokenem, nastavte vlastní frázi.
  1. V navigačním panelu klikněte na Search a pak klikněte na požadované rozhraní Search.
  2. Klikněte na Obecná nastavení.
  3. V oddílu Vlastní fráze zadejte požadovanou frázi.
Zkontrolujte faktory vyhledávání nalezené v protokolu vyhledávání a zjistěte, zda byly použity příslušné faktory vyhledávání. Pokud ne, prostudujte si tyto konkrétní články nápovědy a prozkoumejte problém podrobněji:
- Synonyma: Zkontrolujte, zda byla použita nějaká synonyma
- Pravidla dotazů: Zkontrolujte, zda některá použitá pravidla dotazů nezpůsobila, že se výsledky liší od očekávaných.
- Řazení vertikál: Projděte si skóre jednotlivých vertikál a zjistěte, proč byly seřazeny v tomto pořadí.
- Odvozené filtry: Zkontrolujte, zda byly na jednotlivé vertikály použity nějaké odvozené filtry.

Další články o odstraňování problémů s vyhledáváním v backendu:

Pokud se problém nadále objevuje i po dokončení těchto kroků, další pokyny naleznete v článcích nápovědy k řešení konkrétních problémů. Pokud problémy přetrvávají i poté, co si je nechal(a) zkontrolovat ještě někdo další, odešlete ticket týmům Yext Product a Engineering.