Domande frequenti sull'account Raccomandazioni intelligenti
Questo articolo fornisce le risposte a domande o problemi comuni che potrebbero sorgere durante l'utilizzo di Raccomandazioni intelligenti.
Contenuto
-
Manutenzione dell'account
- Come faccio a creare un account Raccomandazioni intelligenti?
- Come faccio a creare le risorse di modellazione e servizio?
- Come contatto il team di supporto?
- Dove posso trovare l'URL del punto di servizio?
- Il mio contratto dati contiene errori, cosa significa?
- Come posso visualizzare i log degli errori per la mia istanza di modellazione?
- Perché non riesco a vedere alcun registro scritto nella mia cartella dei registri?
- Cosa succede se configuro in modo errato il timestamp della data?
- I file o i CSV Model.JSON non vengono letti correttamente?
- Qual è l'approccio consigliato per aggiornare correttamente i miei dati di input?
-
Risultati API e registrazione degli errori
- Come posso verificare se sono un utente autorizzato a effettuare richieste API?
- La richiesta non è riuscita, ma l'URL è corretto?
- Ho appena creato un account, ma non vedo risultati.
- Come posso monitorare lo stato di un modello nel mio account IR?
- Dove sono i miei file di registrazione o perché sono vuoti?
- Perché solo alcuni prodotti o determinati elenchi non restituiscono risultati?
- Cosa devo fare se i miei risultati di tendenza sono vuoti?
- Cosa devo fare se i miei risultati "Scelti per te" sono vuoti?
- Perché non vedo le raccomandazioni per prodotti simili?
- Dove posso trovare l'elenco completo dei codici di stato API?.
- Quali parametri supporta Raccomandazioni intelligenti per il monitoraggio delle richieste API?
Manutenzione dell'account
Questa sezione è per le domande relative alla configurazione o alla gestione degli account Raccomandazioni intelligenti.
Come faccio a creare un account Raccomandazioni intelligenti?
Per i passaggi su come configurare il tuo account, vai a Panoramica della configurazione.
Come faccio a creare le risorse di modellazione e servizio?
Per i passaggi su come creare risorse di modellazione e servizio, vedi il passaggio 5 della guida rapida alla creazione dell'account.
Come posso contattare il team di supporto di Raccomandazioni intelligenti?
Per domande o problemi senza risposta qui, puoi contattare il team di supporto di Raccomandazioni intelligenti aprendo un ticket di supporto nel portale di Microsoft Azure.
- Nel menu a sinistra seleziona Guida + supporto.
- Seleziona Crea una richiesta di supporto.
- Completare il modulo. Viene creato un ticket di supporto.
Dove posso trovare l'URL dell'endpoint di servizio?
Per la procedura su come individuare l'URL dell'endpoint di servizio, vai al tuo account Raccomandazioni intelligenti nel portale di Azure e cerca la risorsa endpoint che vuoi usare. Da lì, puoi copiare l'URL dell'endpoint di servizio. Per ulteriori informazioni, vai alla guida introduttiva per visualizzare i risultati dei suggerimenti.
Come risolvere gli errori nel contratto dati?
Per comprendere i log degli errori restituiti nel contratto dati, vai a Tipi di errori.
Come posso visualizzare i log degli errori per la mia istanza di modellazione?
Per visualizzare i log degli errori per la tua istanza di modellazione, configura il tuo account per abilitare la modellazione degli errori. Per altre informazioni, vedi Configurare la registrazione degli errori. Per ulteriori informazioni sui tipi di errori che possono essere restituiti, vai a Tipi di errori.
Perché non riesco a vedere alcun registro scritto nella mia cartella dei registri?
Se non sei in grado di vedere i log scritti nella tua cartella dei log dedicata, puoi verificare se il tuo account IR ha accesso per scrivere nel contenitore pertinente:
- Vai all'account Raccomandazioni intelligenti.
- Selezionare la scheda Report.
- Fai clic sul pulsante "Verifica accesso"
- Se il messaggio restituito indica che "Manca la configurazione per l'accesso all'account di archiviazione", è necessario concedere le autorizzazioni di scrittura per accedere al contenitore associato. Se il messaggio restituito indica che "L'account di archiviazione richiesto non esiste o non si dispone delle autorizzazioni", assicurati che l'URL specificato sia corretto.
Cosa succede se configuro in modo errato il timestamp della data?
Se riscontri problemi con i tuoi timestamp, il prodotto viene rimosso dall'elenco dei candidati disponibili e filtrato dai consigli. Per risolvere questo problema, inizia controllando gli input dell'entità dati ItemsAndVariants e assicurati che la data di rilascio sia nel formato data-ora supportato (ovvero "aaaa-MM-ggTHH: mm:ss.fffZ").
Problemi durante la lettura dei file CSV model.json
L'apertura dei CSV in Excel o in qualsiasi altro strumento non compatibile con CSV può rimuovere le colonne vuote richieste nel formato CSV per le entità di dati. Ti suggeriamo di aprire e controllare i tuoi CSV in Blocco note o in un'app correlata che non modificherà il contenuto.
Qual è l'approccio consigliato per aggiornare correttamente i miei dati di input?
Se tenti di modellare e aggiornare i dati di input contemporaneamente, a volte è possibile che si abbiano la modellazione di dati da versioni miste di set di dati e risultati di raccomandazioni indesiderati. Consulta la nostra Guida alle procedure consigliate per ulteriori informazioni su come aggiornare correttamente i dati di input.
Risultati API e registrazione degli errori
Questa sezione è per le domande relative ai risultati dell'API o alla documentazione della registrazione degli errori.
Come posso verificare se sono un utente autorizzato a effettuare richieste API?
Gli utenti devono essere aggiunti all'elenco degli utenti autorizzati per una risorsa endpoint prima di poter chiamare correttamente il servizio. Per maggiori informazioni su come controllare lo stato degli utenti autorizzati, vai al passaggio 2 della guida rapida per la creazione di richieste API.
La richiesta non è riuscita, ma l'URL è corretto.
Se l'URL è corretto, è possibile che l'utente che ha effettuato la richiesta non sia nell'elenco degli utenti autorizzati per questa risorsa endpoint.
Per maggiori informazioni su come controllare lo stato degli utenti autorizzati, vai al passaggio 2 della guida rapida per la creazione di richieste API.
Ho appena creato un account, ma non vedo risultati.
Se è appena stato avviato, il servizio impiega del tempo prima che i risultati siano disponibili. Puoi tenere traccia dello stato di modellazione per ciascuno dei modelli che hai creato. Per ulteriori informazioni, consulta la nostra Guida ai report sullo stato di modellazione.
Puoi anche esaminare la cartella dei registri per conoscere eventuali problemi con il tuo contratto dati e determinare se è necessario apportare modifiche o correzioni.
Se non riesci ancora a visualizzare alcun risultato, assicurati di aver concesso al tuo account Raccomandazioni intelligenti l'autorizzazione a leggere i dati dal contenitore pertinente:
- Vai all'account Raccomandazioni intelligenti.
- Seleziona la scheda "Creazione di modelli".
- Scegli il componente di modellazione pertinente.
- Seleziona la scheda "Stringa di connessione".
- Fai clic sul pulsante "Verifica accesso".
- Se il messaggio restituito indica che "Manca la configurazione per l'accesso all'account di archiviazione", è necessario concedere le autorizzazioni di lettura per accedere al contenitore associato. Se il messaggio restituito indica che "L'account di archiviazione richiesto non esiste o non si dispone delle autorizzazioni", assicurati che l'URL specificato sia corretto.
Verifica anche che le cartelle e i file corretti siano inseriti nell'account di archiviazione. Per ulteriori informazioni, vedi Scaricare il file model.json e configurare la cartella radice.
Come posso monitorare lo stato di modellazione?
I clienti di Raccomandazioni intelligenti possono tener traccia dello stato di modellazione per ciascuno dei modelli che hanno creato sui propri account. Dopo aver configurato un modello, il servizio creerà periodicamente un file di registro dello stato per segnalare lo stato corrente di tutti gli algoritmi (per il livello di modellazione). Per altre informazioni su come accedere a questi registri, vedi Guida ai report sullo stato di modellazione.
Dove sono i miei file di registrazione o perché sono vuoti?
I tuoi file di registrazione potrebbero essere vuoti se non hai concesso le autorizzazioni corrette Collaboratore dati BLOB di archiviazione o puntato alla stringa di connessione errata. Per confermare, segui la nostra guida introduttiva.
Inoltre, assicurati che i tuoi file di registrazione degli errori siano stati configurati correttamente e verifica che la stringa di connessione per l'istanza di modellazione punti alla cartella che contiene i file di registrazione.
Perché solo alcuni prodotti o determinati elenchi non restituiscono risultati?
In generale, interazioni insufficienti per un determinato elemento o utente possono influire sulla qualità dei risultati o sulla mancanza di risultati restituiti. A volte anche i nuovi prodotti hanno bisogno di un po' di tempo per acquisire segnali prima di essere visualizzati in determinati elenchi di raccomandazioni. Puoi sempre osservare più da vicino le prestazioni del tuo prodotto utilizzando i dashboard.
Cosa devo fare se i miei risultati di tendenza sono vuoti?
L'API elenco delle tendenze tiene conto sia dell'età di un prodotto che del conteggio delle interazioni quando valuta (classifica) ogni elemento nell'elenco.
Dapprima conta il numero di interazioni in un intervallo di tempo prestabilito, quindi il modello prende in considerazione l'età del prodotto (giorni dalla data di rilascio come appare nel catalogo). Più un elemento è nuovo, più alto è il punteggio e, man mano che un prodotto "invecchia", il suo punteggio decresce in modo esponenziale.
Per controllare i risultati in Tendenza, dovrai rettificare due campi configurabili nella Cartella dell'entità di dati Configurazione raccomandazioni:
- TrendingListMaxAgeDays imposta l'età massima in giorni di un prodotto. Un prodotto che è stato rilasciato oltre i giorni definiti per TrendingListMaxAgeDays non apparirà nell'elenco delle tendenze.
- TrendingListTransactionsIntervalDays imposta la finestra temporale in cui vengono aggregate le interazioni. Un elemento può essere più vecchio di questo valore, ma vengono conteggiate solo le interazioni con un valore inferiore ai giorni impostati per TrendingListTransactionsIntervalDays.
Regola queste impostazioni nell'entità di dati Configurazione raccomandazioni e ripubblica il tuo modello. Quindi dovresti iniziare a vedere i risultati delle raccomandazioni.
Cosa devo fare se i miei risultati "Scelti per te" sono vuoti?
La funzionalità "scelti per te" è disponibile solo per le istanze di modellazione con un set di funzionalità contrassegnato come Standard o Premium. Se hai confermato che il set di funzionalità è stato configurato correttamente, dai un'occhiata più da vicino agli utenti per i quali stai cercando di ottenere raccomandazioni. Un ID utente senza dati storici di interazione (come acquisti precedenti) non restituirà risultati quando si chiama "scelti per te". Conferma anche se l'utente ha recentemente scelto di non ricevere consigli personalizzati. Qualsiasi utente che ha rinunciato alla personalizzazione non riceverà consigli personalizzati.
Perché non vedo le raccomandazioni per prodotti simili?
Le raccomandazioni per prodotti simili si basano su immagini simili e queste raccomandazioni verranno mostrate solo ai clienti che hanno selezionato il set di funzionalità Premium e hanno condiviso le foto degli articoli nel contratto dati. Conferma di aver selezionato il set di funzionalità Premium per il tuo modello e di avere le immagini configurate correttamente come indicato nelle Entità di dati di mappatura da immagine a elemento.
Dove posso trovare l'elenco completo dei codici di stato API?
L'elenco completo di codici di stato API è disponibile nella pagina Richieste API di esempio, qui.
Quali parametri supporta Raccomandazioni intelligenti per il monitoraggio delle richieste API?
È facoltativo aggiungere uno o più dei seguenti ID di tracciamento come parametri di intestazione alle tue richieste API. Se riscontri problemi con le tue richieste API, aggiungendo uno o più di questi parametri possiamo tracciare ed esaminare le tue richieste in modo più efficace in base agli ID pertinenti che fornisci.
| Parametro chiave intestazione | description |
|---|---|
| CorrelationId | |
| trace-id | |
| parent-id | Può essere utilizzato in base alle tue esigenze per raggruppare le richieste, ad esempio dello stesso utente, area, ecc. |
Questi parametri di intestazione possono essere aggiunti a qualsiasi tipo di richiesta, indipendentemente da URI, parametri di query, scenario e così via.
Vedi anche
Guida rapida: impostare ed eseguire Raccomandazioni intelligenti con dati di esempio
Guida rapida: effettuare una chiamata API autenticata
Codici di stato dell'API
Registri errori
Panoramica della configurazione
Panoramica del contratto dati