Sdílet prostřednictvím

Časté otázky k účtu Intelligent Recommendations

  • Článek

Tento článek poskytuje odpovědi na běžné otázky nebo problémy, které mohou nastat při používání Intelligent Recommendations.

Obsah

Údržba účtu

Tato část je určena pro otázky související s konfigurací nebo správou účtů Intelligent Recommendations.

Zpět na začátek

Jak vytvořím účet Intelligent Recommendations?

Postup konfigurace účtu naleznete v části Přehled konfigurace.

Zpět na začátek

Jak vytvořím prostředky pro modelování a poskytování služeb?

Kroky, jak vytvořit prostředky pro modelování a poskytování, najdete v kroku 5 stručného průvodce vytvořením účtu.

Zpět na začátek

Jak mohu kontaktovat tým podpory Intelligent Recommendations?

V případě otázek nebo problémů, které nebyly zodpovězeny, se můžete obrátit na tým podpory Intelligent Recommendations otevřením lístku podpory na portálu Microsoft Azure.

  1. V nabídce vlevo vyberte Nápověda + podpora.
  2. Vyberte Vytvořit žádost o podporu.
  3. Vyplňte formulář. Byl vytvořen lístek podpory.

Zpět na začátek

Kde najdu adresu URL obslužného koncového bodu?

Postup, jak najít adresu URL obslužného koncového bodu, najdete v účtu Intelligent Recommendations na Azure Portal a vyhledejte zdroj koncového bodu, který chcete použít. Odtud můžete zkopírovat adresu URL obslužného koncového bodu. Další informace naleznete v rychlém průvodci pro zobrazení výsledků doporučení.

Zpět na začátek

Jak vyřešit chyby v datové smlouvě?

Chcete-li porozumět protokolům chyb, které se vracejí v datové smlouvě, přejděte na Typy chyb.

Zpět na začátek

Jak mohu zobrazit protokoly chyb pro svou instanci modelování?

Chcete-li zobrazit protokoly chyb pro vaši instanci modelování, nastavte svůj účet tak, aby umožňoval modelování chyb. Pro více informací přejděte na Nastavení protokolování chyb. Další informace o typech chyb, které lze vrátit, naleznete v části Typy chyb.

Zpět na začátek

Proč nevidím žádné protokoly zapsané do mé složky protokolů?

Pokud nevidíte žádné protokoly zapsané do vyhrazené složky protokolů, můžete zkontrolovat, zda má váš účet IR přístup k zápisu do příslušného kontejneru:

  1. Přejděte na účet Intelligent Recommendations.
  2. Vyberte kartu Sestavy.
  3. Klikněte na tlačítko "Zkontrolovat přístup".
  4. Pokud vrácená zpráva říká, že "Chybí konfigurace pro přístup k účtu úložiště", je třeba udělit oprávnění k zápisu pro přístup k přidruženému kontejneru. Pokud je ve vrácené zprávě uvedeno, že "Požadovaný účet úložiště neexistuje nebo nemáte oprávnění", zkontrolujte, zda je zadaná adresa URL správná.

Co se stane, když nesprávně nakonfiguruji časové razítko?

Pokud narazíte na problémy s časovými razítky, bude produkt odstraněn ze seznamu dostupných kandidátů a odfiltrován z doporučení. Chcete-li tento problém vyřešit, začněte kontrolou vstupů datových entit ItemsAndVariants a ujistěte se, že datum vydání je v podporovaném formátu data a času (což je „yyyy-MM-ddTHH: mm:ss.fffZ“).

Zpět na začátek

Problémy se čtením souborů CSV model.json

Otevření souborů CSV v aplikaci Excel nebo v jakémkoli jiném nástroji, který není kompatibilní s CSV, může odstranit prázdné sloupce, které jsou vyžadovány ve formátu CSV pro datové entity. Doporučujeme otevřít a zkontrolovat soubory CSV v Poznámkovém bloku nebo podobné aplikaci, která nezmění obsah.

Zpět na začátek

Pokud se pokusíte o modelování a aktualizaci vstupních dat současně, může to někdy vést k modelování dat ze smíšených verzí dat a nežádoucím výsledkům doporučení. Další informace o správné aktualizaci vstupních dat naleznete v našem Průvodci doporučenými postupy.

Zpět na začátek

Protokolování výsledků rozhraní API a chyb

Tato část je určena pro otázky týkající se výsledků API nebo dokumentace k protokolování chyb.

Zpět na začátek

Jak mohu zkontrolovat, zda jsem oprávněný uživatel pro zadávání požadavků API?

Před úspěšným voláním služby musí být uživatelé přidáni do seznamu autorizovaných uživatelů pro zdroj koncového bodu. Další informace o tom, jak zkontrolovat stav oprávněných uživatelů, naleznete v kroku 2 stručného průvodce vytvářením požadavků API.

Zpět na začátek

Požadavek selhal, ale adresa URL je správná.

Pokud je adresa URL správná, je možné, že uživatel, který požadavek podává, není na seznamu oprávněných uživatelů pro tento zdroj koncového bodu.

Další informace o tom, jak zkontrolovat stav oprávněných uživatelů, naleznete v kroku 2 stručného průvodce vytvářením požadavků API.

Zpět na začátek

Právě jsem vytvořil(a) účet, ale nezobrazují se mi výsledky.

Pokud se služba právě spustila, chvíli trvá, než jsou k dispozici výsledky. Můžete sledovat stav modelování pro každý z modelů, které jste vytvořili. Další informace naleznete v našem Průvodci zprávami o stavu modelování.

Můžete se také podívat do složky protokolů, kde se dozvíte o jakýchkoli problémech s vaší datovou smlouvou a o tom, zda potřebujete provést nějaké změny nebo opravy.

Pokud se vám stále nedaří zobrazit žádné výsledky, ujistěte se, že jste svému účtu Intelligent Recommendations udělili oprávnění ke čtení dat z příslušného kontejneru:

  1. Přejděte na účet Intelligent Recommendations.
  2. Vyberte kartu Modelování.
  3. Vyberte příslušnou modelovací komponentu.
  4. Vyberte kartu "Připojovací řetězec".
  5. Klikněte na tlačítko "Zkontrolovat přístup".
  6. Pokud vrácená zpráva říká, že "Chybí konfigurace pro přístup k účtu úložiště", je třeba udělit oprávnění ke čtení pro přístup k přidruženému kontejneru. Pokud je ve vrácené zprávě uvedeno, že "Požadovaný účet úložiště neexistuje nebo nemáte oprávnění", zkontrolujte, zda je zadaná adresa URL správná.

Ověřte také, zda jsou v účtu úložiště umístěny správné složky a soubory. Další informace naleznete v části Stažení souboru model.json a konfigurace kořenové složky.

Zpět na začátek

Jak mohu sledovat stav modelování?

Zákazníci Intelligent Recommendations mohou sledovat stav modelování pro každý z modelů, který vytvořili na svých účtech. Poté, co nakonfigurujete model, bude služba pravidelně vytvářet soubor protokolu stavu, který bude podávat zprávy o aktuálním stavu všech algoritmů (pro vaši úroveň modelování). Další informace o přístupu k těmto protokolům naleznete v Průvodci zprávami o stavu modelování.

Zpět na začátek

Kde jsou moje soubory protokolování nebo proč jsou prázdné?

Vaše protokolovací soubory mohou být prázdné, pokud jste neudělili správná oprávnění Přispěvatel dat objektu blob úložiště nebo jste ukázali na nesprávný připojovací řetězec. Chcete-li to potvrdit, postupujte podle našeho rychlého průvodce.

Také se ujistěte, že vaše soubory protokolování chyb byly správně nakonfigurovány, a ověřte, že váš připojovací řetězec pro instanci modelování ukazuje na složku, která obsahuje vaše soubory protokolování.

Zpět na začátek

Proč pouze některé produkty nebo určité seznamy nevrací výsledky?

Obecně platí, že nedostatečné interakce pro danou položku nebo uživatele mohou ovlivnit kvalitu výsledků nebo nedostatek vrácených výsledků. Někdy nové produkty také potřebují nějaký čas na získání signálů, než se objeví v určitých seznamech doporučení. Na výkon vašeho produktu se můžete blíže podívat pomocí řídicích panelů.

Zpět na začátek

Rozhraní API seznamu trendů bere při bodování (hodnocení) každé položky v seznamu v úvahu jak stáří produktu, tak počet jeho interakcí.

Nejprve spočítáme počet interakcí v nastaveném časovém okně, poté náš model zohlední stáří produktu (dny od data vydání, jak je uvedeno v katalogu). Čím novější položka je, tím vyšší je skóre a jak produkt „stárne“, jeho skóre exponenciálně klesá.

Chcete-li ovládat výsledky v Co letí, budete muset upravit dvě konfigurovatelná pole ve složce datové entity konfigurace Reco:

  • TrendingListMaxAgeDays nastavuje maximální stáří dne produktu. Produkt, který byl vydán před více než TrendingListMaxAgeDays dny, se v seznamu trendů nezobrazí.
  • TrendingListTransactionsIntervalDays nastavuje časové okno, ve kterém jsou interakce agregovány. Položka může být starší než tato hodnota, ale započítají se pouze interakce menší než před dny TrendingListTransactionsIntervalDays.

Upravte tato nastavení v datové entitě konfigurace doporučení a znovu publikujte svůj model. Pak byste měli začít vidět výsledky doporučení.

Zpět na začátek

Co mám dělat, když jsou mé výsledky „výběr pro vás“ prázdné?

Funkce „Výběr pro vás“ je dostupná pouze pro modelovací instance se sadou funkcí označenou jako Standard nebo Premium. Pokud jste si ověřili, že sada funkcí byla nakonfigurována správně, podívejte se blíže na uživatele, pro které se snažíte získat doporučení. ID uživatele bez historických údajů o interakcích (jako jsou předchozí nákupy) nebude při volání „výběr pro vás“ vracet výsledky. Také potvrďte, zda se uživatel nedávno odhlásil z přijímání personalizovaných doporučení. Žádný uživatel, který se odhlásil z personalizace, neobdrží personalizovaná doporučení.

Zpět na začátek

Proč nevidím doporučení podobného vzhledu?

Doporučení Podobné vzhledy jsou založena na podobných obrázcích a tato doporučení se zobrazí pouze zákazníkům, kteří si vybrali sadu funkcí Premium a sdíleli fotky svých položek v datové smlouvě. Potvrďte, že jste pro svůj model vybrali sadu funkcí Premium a že máte obrázky správně nakonfigurovány, jak je uvedeno v části Datové entity mapování obrázku na položku.

Zpět na začátek

Kde najdu úplný seznam stavových kódů API?

Úplný seznam stavových kódů API je k dispozici na stránce Vzorové požadavky API zde.

Které parametry Intelligent Recommendations podporuje pro sledování požadavků API?

Je volitelné přidat jedno nebo více z následujících ID měření jako parametry záhlaví k vašim požadavkům API. V případě, že narazíte na problémy s požadavky na rozhraní API, přidáním jednoho nebo více těchto parametrů můžeme vaše požadavky sledovat a zkoumat efektivněji podle příslušných ID, která poskytnete.

Parametr klíče hlavičky Popis
CorrelationId
trace-id
nadřazené id Lze použít podle vašich potřeb k seskupení požadavků, například stejného uživatele, regionu atd.

Tyto parametry hlavičky lze přidat k jakémukoli typu požadavku, bez ohledu na URI, parametry dotazu, scénář atd.

Viz také

Stručný průvodce: Nastavení a spuštění Intelligent Recommendations se vzorovými daty
Stručný průvodce: Provedení ověřeného volání rozhraní API
Stavové kódy rozhraní API
Protokoly chyb
Přehled konfigurace
Přehled datové smlouvy