Udostępnij za pośrednictwem

Konto Intelligent Recommendations — Często zadawane pytania

  • Artykuł

Ten artykuł zawiera odpowiedzi na typowe pytania lub problemy, które mogą wystąpić podczas korzystania z Intelligent Recommendations.

Zawartość

Zarządzanie kontem

W tej sekcji o można uzyskać pytania dotyczące konfigurowania i konserwacji kont Intelligent Recommendations.

Powrót do początku

Jak utworzyć konto Intelligent Recommendations?

Kroki procesu konfigurowania konta zawiera omówienie konfiguracji.

Powrót do początku

Jak tworzyć modelowanie i służące zasoby?

Kroki tworzenia modelowania i obsługi zasobów można znaleźć w kroku 5 przewodnika szybki start tworzenia kont.

Powrót do początku

Jak się skontaktować z zespołem pomocy technicznej dotyczącej Intelligent Recommendations?

W przypadku pytań lub problemów, na które nie znajdziesz odpowiedzi w przewodniku rozwiązywania problemów, możesz dotrzeć do zespołu pomocy technicznej dotyczącej Intelligent Recommendations, otwierając bilet pomocy technicznej w portalu Microsoft Azure Portal.

  1. W menu po lewej stronie wybierz polecenie Pomoc i obsługa techniczna.
  2. Wybierz Utwórz żądanie pomocy technicznej.
  3. Wypełnij formularz. Zostanie utworzony bilet pomocy technicznej.

Powrót do początku

Gdzie mogę znaleźć adres URL punktów końcowych obsługi?

Aby uzyskać instrukcje dotyczące znajdowania adresu URL punktu końcowego usługi, przejdź do konta Intelligent Recommendations w witrynie Azure Portal i wyszukaj zasób punktu końcowego do użycia. Stamtąd możesz skopiować punkt końcowy obsługującego adresu URL. Aby uzyskać więcej informacji, przejdź do przewodnika Szybki start, aby dowiedzieć się, jak wyświetlić wyniki rekomendacji.

Powrót do początku

Jak rozwiązać błędy w kontrakcie danych?

Aby dowiedzieć się, które dzienniki błędów są zwracane w kontrakcie danych, przejdź do Typy błędów.

Powrót do początku

Jak wyświetlić dzienniki błędów dla mojego wystąpienia modelowania?

Aby wyświetlić dzienniki błędów dla wystąpienia modelowania, skonfiguruj konto w celu włączenia modelowania błędów. Aby uzyskać więcej informacji, przejdź do strony Konfigurowanie rejestrowania błędu. Aby uzyskać więcej informacji o typach błędów, które mogą być zwracane, przejdź do Typy błędów.

Powrót do początku

Dlaczego nie widzę żadnych dzienników wpisanych w folderze dzienników?

Jeśli nie ma dostępu do dzienników wpisanych w przeznaczonym do tego folderze dzienników, można sprawdzić, czy konto IR użytkownika ma dostęp do zapisu odpowiednich kontenerów:

  1. Otwórz konto w serwisie Intelligent Recommendations.
  2. Wybierz kartę Raporty.
  3. Kliknij przycisk Sprawdź dostęp
  4. Jeśli zwrócony komunikat zawiera komunikat „Nie ma konfiguracji dostępu do konta magazynu”, musisz przyznać uprawnienia do zapisu, aby uzyskać dostęp do skojarzonego konteneru. Jeśli zwrócony komunikat informuje o tym, że żądane konto magazynu nie istnieje lub użytkownik nie ma uprawnień, należy się upewnić, że podany adres URL jest poprawny.

Co się dzieje w przypadku nieprawidłowej konfiguracji znacznika czasu daty?

Jeśli masz problemy z sygnaturami czasowymi, produkt jest usuwany z listy dostępnych kandydatów i odfiltrowany z rekomendacji. Aby rozwiązać ten problem, zacznij od sprawdzenia danych wejściowych encji danych ItemsAndVariants i upewnij się, że data wydania jest w obsługiwanym formacie daty i godziny (czyli „rrrr-MM-ddTHH: mm:ss.fffZ”).

Powrót do początku

Problemy z przeczytaniem model.json CSV

Otwarcie pliku CSV w programie Excel lub innym narzędziu, które nie obsługuje formatu CSV, może usunąć puste kolumny wymagane w formacie CSV dla encji danych. Zalecamy otwarcie i sprawdzenie plików CSV w Notatniku lub powiązanej aplikacji, która nie spowoduje zmodyfikowania zawartości.

Powrót do początku

Jeśli jednocześnie spróbujesz modelować i aktualizować dane wejściowe, może czasami doprowadzić do modelowania danych z różnych wersji danych i niepożądanych wyników dotyczących rekomendacji. Zobacz nasz Przewodnik po najlepszych praktykach, aby dowiedzieć się więcej na temat prawidłowego wprowadzania danych.

Powrót do początku

Wyniki interfejsu API i rejestrowanie błędów

W tej sekcji o można znaleźć pytania dotyczące wyników interfejsu API lub dokumentacji rejestrowania błędów.

Powrót do początku

Jak sprawdzić, czy jestem autoryzowanym użytkownikiem do tworzenia żądań interfejsów API?

Użytkowników należy dodać do listy autoryzowanych użytkowników zasób punkt końcowy, aby mogli pomyślnie wywoływać usługę. Aby uzyskać więcej informacji na temat sprawdzania stanu autoryzowanych użytkowników, przejdź do kroku 2 przewodnika Szybki start w celu tworzenia żądań interfejsu API.

Powrót do początku

Żądanie zakończyło się niepowodzeniem, ale adres URL jest poprawny.

Jeśli adres URL jest poprawny, możliwe jest, że użytkownik, który je zamówi, nie znajduje się na liście autoryzowanych użytkowników tego punkt końcowy zasobu.

Aby uzyskać więcej informacji na temat sprawdzania stanu autoryzowanych użytkowników, przejdź do kroku 2 przewodnika Szybki start w celu tworzenia żądań interfejsu API.

Powrót do początku

Utworzyłem konto, ale nie widzę wyników.

Jeśli usługa dopiero została uruchomiona, mija trochę czasu przed udostępnieniem wyników. Można śledzić stan modelowania dla każdego z utworzonych modeli. Aby uzyskać więcej informacji, zobacz nasz Przewodnik po raportach o stanie modelowania.

Możesz również sprawdzić folder dzienników, aby uzyskać informacje o problemach związanych z kontraktem danych oraz o tym, czy trzeba wprowadzić zmiany lub poprawki.

Jeśli nadal nie widać żadnych wyników, upewnij się, że zostało udzielone na koncie usługi Intelligent Recommendations uprawnienie do odczytywania danych z odpowiedniego konteneru:

  1. Otwórz konto w serwisie Intelligent Recommendations.
  2. Wybierz kartę Modelowanie.
  3. Wybierz odpowiedni składnik modelowania.
  4. Wybierz kartę Parametry połączenia.
  5. Kliknij przycisk Sprawdź dostęp.
  6. Jeśli zwrócony komunikat informuje „Nie ma konfiguracji dostępu do konta magazynu”, musisz przyznać uprawnienia do odczytu, aby uzyskać dostęp do skojarzonego konteneru. Jeśli zwrócony komunikat informuje o tym, że żądane konto magazynu nie istnieje lub użytkownik nie ma uprawnień, należy się upewnić, że podany adres URL jest poprawny.

Sprawdź także, czy odpowiednie foldery i pliki zostały umieszczone na koncie magazynu. Aby uzyskać więcej informacji, zobacz, jak pobrać plik model.json i skonfigurować folder główny.

Powrót do początku

Jak śledzić stan moich modeli?

Klienci usługi Intelligent Recommendations mogą śledzić stan modelowania dla każdego z modeli utworzonych na ich kontach. Po skonfigurowaniu modelu usługa okresowo tworzy plik dziennika stanu, który będzie raportować aktualny stan wszystkich algorytmów (dla warstwy modelowania). Więcej informacji na temat uzyskiwania dostępu do tych dzienników można znaleźć w Przewodniku po raportach o stanie modelu.

Powrót do początku

Gdzie są moje pliki rejestrowania lub dlaczego są puste?

Pliki rejestrowania mogą być puste, jeśli nie nadasz poprawnej wartości uprawnień Współautora danych Storage Blob lub nie będzie można znaleźć niepoprawnego ciągu połączenia. Aby potwierdzić, skorzystaj z naszego przewodnika Szybki start.

Upewnij się, też że pliki rejestrowania błędów zostały poprawnie skonfigurowane i zweryfikuj, czy parametry połączenia wystąpienia modelowania wskazują folder zawierający pliki rejestrowania.

Powrót do początku

Dlaczego tylko niektóre produkty lub określone listy nie zwrócono wyników?

Generalnie niewystarczające interakcje z danym elementem lub użytkownikiem mogą mieć wpływ na jakość wyników lub brak zwracanych wyników. Czasami nowe produkty wymagają też trochę czasu na uzyskanie sygnałów przed pojawieniem się na określonych listach rekomendacji. Zawsze można sprawdzić swoją wydajność produktu za pomocą pulpitów.

Powrót do początku

Popularne interfejs API listy uwzględnia zarówno wiek produktu, jak i liczbę jego interakcji przy punktacji (klasyfikacji) poszczególnych pozycji listy.

Najpierw liczysz interakcje w wybranym przedziale czasowym, a następnie nasz model uwzględnia wiek produktu (dni od daty jego premiery w katalogu). Im nowszy produkt, tym wyższy wynik, a ponieważ produkt „starzeje się”, jego wynik maleje wykładniczo.

Aby kontrolować wyniki w polu Popularne, należy dostosować dwa pola z możliwością dostosowania w folderze encji danych konfiguracji reco:

  • TrendingListMaxAgeDays ustawia maksymalny wiek produktu w dniach. Produkt, który został wydany więcej niż TrendingListMaxAgeDays dni temu, nie pojawi się na liście trendów.
  • TrendingListTransactionsIntervalDays ustawia okno czasu, w którym interakcje są agregowane. Pozycja może być starsza niż ta wartość, ale są liczone tylko interakcje mniejsze niż TrendingListTransactionsIntervalDays.

Dostosuj te ustawienia w encji danych konfiguracji reco i ponownie opublikować model. Następnie należy rozpocząć wyświetlanie wyników zalecenia.

Powrót do początku

Co zrobić, jeśli „wybrane dla ciebie” wyniki są puste?

Funkcja "picks for you" jest dostępna tylko w przypadku wystąpień modelu z zestawem funkcji oznaczonym jako Standard lub Premium. Jeśli potwierdziłeś, że zestaw funkcji został skonfigurowany poprawnie, przyjrzyj się bliżej użytkownikom, dla których próbujesz uzyskać rekomendacje. Identyfikator użytkownika bez historycznych danych interakcji (takich jak poprzednie zakupy) nie zwróci wyników podczas wywoływania „wybierze dla Ciebie”. Potwierdź również, czy użytkownik niedawno zrezygnował z otrzymywania spersonalizowanych rekomendacji. Każdy użytkownik, który zrezygnował z personalizacji, nie będzie otrzymywać spersonalizowanych rekomendacji.

Powrót do początku

Dlaczego nie widzę podobnych widoków zalecenia?

Rekomendacje dotyczące podobnego wyglądu są oparte na podobnych obrazach i będą widoczne tylko dla klientów, którzy wybrali zestaw funkcji Premium i udostępnili zdjęcia swoich produktów w umowie dotyczącej danych. Potwierdź, że wybrano funkcję Premium dla swojego modelu i że obrazy są poprawnie skonfigurowane zgodnie z przedstawionych w encji danych mapowania obrazów na elementy.

Powrót do początku

Gdzie mogę znaleźć pełną listę kodów statusu API?

Pełna lista kodów stanów interfejsu API jest dostępna na stronie przykładowych żądań interfejsów API, tutaj.

Jakie parametry obsługuje usługa Intelligent Recommendations w przypadku śledzenia żądań interfejsu API?

Opcjonalnie można dodać jeden lub więcej poniższych identyfikatorów śledzenia jako parametry nagłówka w żądaniach interfejsu API. W przypadku napotkania problemów z żądaniami interfejsu API, dodając co najmniej jeden z tych parametrów, można efektywniej śledzić i badać żądania według odpowiednich identyfikatorów nadanych przez użytkownika.

Parametr klucza nagłówka description
CorrelationId
trace-id
parent-id Można go używać zgodnie z potrzebami do grupowania żądań, na przykład według tego samego użytkownika, regionu itp.

Te parametry nagłówka można dodać do dowolnego typu żądania, niezależnie od typu zapytania, wartości URI, parametrów zapytania, scenariusza itp.

Zobacz też

Przewodnik szybkiego startu: Skonfiguruj i uruchom Intelligent Recommendations z przykładowymi danymi
Skrócony przewodnik: Wykonaj uwierzytelnione wywołanie interfejsu API
Kody statusu API
Dzienniki błędów
Omówienie konfiguracji
Omówienie kontraktu danych