Vanliga frågor om Intelligent Recommendations konto
Denna artikel innehåller svar på vanliga frågor eller problem som kan uppstå när du använder Intelligent Recommendations.
Innehåll
-
Kontounderhåll
- Hur skapar jag ett konto för Intelligent Recommendations?
- Hur skapar jag modellerings- och betjäningsresurser?
- Hur kontaktar du supportteamet?
- Var hittar jag url:en till serveringspunkten?
- Mitt datakontrakt har fel, vad betyder de?
- Hur visar jag felloggarna för min modellinstans?
- Varför visas inga loggar som är skrivna i mappen Loggar?
- Vad händer om jag felkonfigurerar datumtidsstämpeln?
- Mina Model.JSON-filer/CSV-filer läses inte korrekt?
- Vilken metod rekommenderas för att uppdatera mina indata på rätt sätt?
-
API-resultat och felloggning
- Hur kontrollerar jag om jag är en behörig användare för att göra API-förfrågningar?
- Begäran har misslyckats, men URL:en är korrekt?
- Jag har just skapat ett konto, men inga resultat visas?
- Hur spårar jag status för en modell i mitt IR-konto?
- Var är mina loggningsfiler eller varför är de tomma?
- Varför returnerar inte resultat enbart för vissa produkter eller listor?
- Vad ska jag göra om mina trendande resultat är tomma?
- Vad ska jag göra om mina "val för dig" resultat är tomma?
- Varför ser jag inga rekommendationer med liknande utseende?
- Var hittar jag den fullständiga listan med API-statuskoder?
- Vilka parametrar stöds av Intelligent Recommendations för spårning av API-begäranden?
Kontounderhåll
Det här avsnittet innehåller frågor om hur du konfigurerar eller underhåller konton för Intelligent Recommendations.
Hur skapar jag ett konto för Intelligent Recommendations?
Instruktioner för hur du konfigurerar ditt konto finns i konfigurationsöversikten.
Hur skapar jag modellerings- och betjäningsresurser?
Steg för steg hur du skapar modeller och visar resurser finns i steg 5 i snabbstartsguiden för att skapa konton.
Hur kontaktar jag supportteamet för Intelligent Recommendations?
Om du har frågor eller problem som inte har besvarats ovan kan du kontakta supportteamet för Intelligent Recommendations genom att öppna en supportbiljett på Microsoft Azure-portalen.
- På menyn till vänster, välj Hjälp + support.
- Välj Skapa en supportbegäran.
- Fyll i formuläret. En supportbegäran skapas.
Var hittar jag till betjäning slutpunkts-URL?
För steg om hur du hittar URL:en för betjäningslutpunkt, gå till ditt Intelligent Recommendations-konto i Azure Portal och sök efter den slutpunktsresurs du vill använda. Därefter kan du kopiera betjäning slutpunkts-URL. Mer information finns i snabbstartsguiden för att visa resultat för rekommendationer.
Hur man löser fel i datakontraktet?
Information om vilka felloggar som returneras i datakontraktet finns i typer av fel.
Hur visar jag felloggarna för min modellinstans?
Om du vill visa felloggarna för din modellinstans, konfigurera ditt konto så att felmodellering aktiveras. Mer information finns i Konfigurera felloggning. Mer information om de typer av fel som kan returneras finns i Olika typer av fel.
Varför visas inga loggar som är skrivna i mappen Loggar?
Om det inte går att se några loggar som är skrivna i den särskilda loggmappen kan du kontrollera om ditt IR-konto har behörighet att skriva till den relevanta behållaren:
- Gå till konto för Intelligent Recommendations.
- Välj fliken Rapporter.
- Klicka på knappen "Kontrollera åtkomst"
- Om det returnerade meddelandet anger att "Konfigurationen för åtkomst till lagringskontot saknas" måste du bevilja skrivbehörighet för att få åtkomst till den associerade behållaren. Om det returnerade meddelandet anger "Det begärda lagringskontot finns inte eller också har du inte behörighet" ska du kontrollera att URL:en är korrekt.
Vad händer om jag felkonfigurerar datumtidsstämpeln?
Om du stöter på problem med dina tidsstämplar kommer produkten att tas bort från listan över tillgängliga kandidater och filtreras bort från rekommendationer. För att åtgärda det här problemet, börja med att kontrollera ItemsAndVariants-dataentitetens, indata och se till att versionsdatumet är i det format som stöds för datum och tid (vilket är "åååå-MM-ddTHH: mm:ss.fffZ").
Problem med att läsa CSV för model.json
Om du öppnar CSV-filerna i Excel eller ett annat verktyg som inte är CSV-vänligt kan bort tomma kolumner som behövs i CSV-formatet för dataentiteter komma att tas bort. Vi föreslår att du öppnar och kontrollerar dina CSV-filer i Anteckningar eller liknande program som inte ändrar innehållet.
Vilken metod rekommenderas för att uppdatera mina indata på rätt sätt?
Om du försöker att både skapa och uppdatera dina indata samtidigt kan det ibland leda till modellering av data från blandade dataversioner och icke önskade rekommendationsresultat. Se våra metodtips för mer information om hur du uppdaterar dina indata på rätt sätt.
API-resultat och felloggning
Det här avsnittet handlar om frågor som rör API-resultat eller felloggningsdokumentation.
Hur kontrollerar jag om jag är en behörig användare för att göra API-förfrågningar?
Användare måste läggas till i listan över behöriga användare för en slutpunktsresurs innan de kan anropa tjänsten. Mer information om hur du kontrollerar status för behöriga användare finns i steg 2 i snabbstartsguiden för att skapa API-förfrågningar.
Begäran har misslyckats, men URL:en är korrekt.
Om URL:en är korrekt är det möjligt att användaren som begär den inte har lagts till i listan över behöriga användare för slutpunkt resurs.
Mer information om hur du kontrollerar status för behöriga användare finns i steg 2 i snabbstartsguiden för att skapa API-förfrågningar.
Jag har just skapat ett konto, men inga resultat visas.
Om tjänsten just har startat tar tjänsten en stund på sig innan resultaten är tillgängliga. Du kan spåra modellstatusen för alla modeller du har skapat. Mer information finns i vår guide Statusrapport för modellering.
Du kan också läsa loggarna i mappen för att få information om eventuella problem med ditt datakontrakt och om du behöver utföra ändringar eller korrigeringar.
Om du fortfarande inte kan se några resultat bör du se till att du har gett ditt Intelligent Recommendations-konto behörighet att läsa data från relevant behållare:
- Gå till konto för Intelligent Recommendations.
- Välj fliken "Modellering".
- Välj relevant modellkomponent.
- Välj fliken "Anslutningssträng".
- Klicka på knappen "Kontrollera åtkomst".
- Om det returnerade meddelandet anger att "Konfigurationen för åtkomst till lagringskontot saknas" måste du bevilja läsbehörighet för att få åtkomst till den associerade behållaren. Om det returnerade meddelandet anger "Det begärda lagringskontot finns inte eller också har du inte behörighet" ska du kontrollera att URL:en är korrekt.
Bekräfta också att rätt mappar och filer finns på lagringskontot. Mer information finns i Hämta filen model.json och konfigurera rotmappen.
Hur spårar jag modellstatus för mina modeller?
Intelligent Recommendations-kunder kan spåra modellstatusen för alla modeller de har skapat på sina konton. När du har konfigurerat en modell skapar tjänsten regelbundet en statusloggfil för att rapportera om aktuell status för alla algoritmer (för din modellnivå). Mer information om hur du öppnar dessa loggar finns i Guiden Statusrapporter för modellering.
Var är mina loggningsfiler eller varför är de tomma?
Dina loggfiler kan vara tomma om du inte beviljade rätt Storage Blob-datadeltagare behörigheter eller pekade på den felaktiga anslutningssträngen. Bekräfta genom att följa vår snabbstartsguide.
Kontrollera också att dina felloggningsfiler har konfigurerats korrekt, och kontrollera att anslutningssträngen för modelleringsinstansen pekar till den mapp som innehåller dina loggningsfiler.
Varför returnerar inte resultat enbart för vissa produkter eller listor?
I allmänhet kan bristande interaktioner för ett visst objekt eller en viss användare påverka kvaliteten på resultaten, eller avsaknaden av att några resultat returneras. Ibland behöver nya produkter också lite tid för att anskaffa signaler innan de visas i vissa rekommendationslistor. Du kan alltid titta närmare på din produkts prestanda med hjälp av instrumentpanelerna.
Vad ska jag göra om mina trendande resultat är tomma?
API för trending list tar hänsyn till både produktens ålder och dess interaktioner räknas in när ett objekt i listan visas.
Räkna först antalet interaktioner i ett fast tidsfönster, därefter våra modellfaktorer i produktens ålder (antal dagar sedan dess utgivningsdatum såsom det anges i katalogen). Ju nyare ett objekt är, ju högre poäng, och som en produkt "ålder" förfaller dess poäng exponentialt.
Om du vill kontrollera resultaten i Trending måste du justera två konfigurerbara fält i entitetsmappen Reco-konfigurationsdata:
- TrendingListMaxAgeDays anger maximal ålder i dagar för en produkt. En produkt som släppts för fler än TrendingListMaxAgeDays för flera dagar sedan visas inte i trendinglistan.
- TrendingListTransactionsIntervalDays anger i vilket tidsfönster interaktioner aggregeras. Ett objekt kan vara äldre än detta värde, men endast interaktioner som är mindre än TrendingListTransactionsIntervalDays dagar sedan räknas.
Ändra inställningarna i dataentiteten Reco-konfiguration och publicera modellen på nytt. Då bör du börja se resultaten av rekommendationerna.
Vad ska jag göra om mina "val för dig" resultat är tomma?
Funktionen "val för dig" är endast tillgänglig för modellinstanser med en funktion som markerats som Standard eller Premium. Om du har bekräftat att funktionsuppsättningen har konfigurerats korrekt tar du en närmare titt på användarna som du försöker få rekommendationer för. Ett användar-ID utan tidigare interaktionsdata (till exempel tidigare köp) returnerar inte resultat när du anropar "val för dig". Bekräfta också huruvida användaren nyligen har avanmält sig från att ta emot anpassade rekommendationer. Alla användare som har avanmält sig från personlig anpassning får inte anpassade rekommendationer.
Varför ser jag inga rekommendationer med liknande utseende?
Rekommendationer om Liknande utseende bygger på liknande bilder, och dessa rekommendationer visas endast för kunder som har valt Premium-funktionsuppsättningen och har delat bilder på sina objekt i datakontraktet. Bekräfta att du har valt Premium-funktionsuppsättningen för din modell och att bilderna är korrekt konfigurerade enligt beskrivningen i Bild till objektmappning dataenheter.
Var hittar jag den fullständiga listan med API-statuskoder?
Den fullständiga listan med API-statuskoder är tillgängliga på sidan med exempel på API-förfrågningar, här.
Vilka parametrar stöds av Intelligent Recommendations för spårning av API-begäranden?
Det är valfritt att lägga till ett eller flera av följande spårnings-ID som rubrikparametrar i API-begärandena. Om du stöter på problem med dina API-begäranden kan vi spåra och undersöka dina förfrågningar effektivare genom att lägga till en eller flera av dessa parametrar enligt de relevanta ID:n du anger.
| Nyckelparametern Rubrik | Beskrivning |
|---|---|
| CorrelationId | |
| spårnings-ID | |
| överordnat-id | Kan användas efter dina behov för att gruppera förfrågningar, till exempel samma användare, region osv. |
Dessa rubrikparametrar kan läggas till i valfri begärandetyp, oavsett URI, frågeparametrar, scenario osv.
Se även
Snabbstartsguide: Konfigurera och köra Intelligent Recommendations med exempeldata
Snabbstartsguide: Ringa ett autentiserat API-samtal
API-statuskoder
Felloggar
Konfiguration – översikt
Översikt över datakontrakt