FAQ sur le compte des Recommandations intelligentes
Cet article fournit des réponses aux questions ou problèmes courants qui peuvent survenir au moment de l’utilisation des recommandations intelligentes.
Contenu
-
Maintenance du compte
- Comment créer un compte Recommandations intelligentes ?
- Comment créer des ressources de modélisation et de service ?
- Comment contacter l’équipe du support technique ?
- Où puis-je trouver l’URL du point de service ?
- Mon contrat de données contient des erreurs, que signifient-elles ?
- Comment puis-je afficher les journaux d’erreurs de mon instance de modélisation ?
- Pourquoi ne puis-je voir aucun journal écrit dans mon dossier de journaux ?
- Que se passe-t-il si je configure mal l’horodatage ?
- Mes fichiers Model.JSON/CSV ne sont pas lus correctement ?
- Quelle est l’approche recommandée pour mettre à jour correctement mes données d’entrée ?
-
Journalisation des erreurs et des résultats API
- Comment puis-je vérifier si je suis un utilisateur autorisé à faire des demandes d’API ?
- L’outil indique que la demande a échoué, mais que l’URL est correcte.
- Je viens de créer un compte, mais je ne vois pas de résultats ?
- Comment puis-je suivre le statut d’un modèle dans mon compte IR ?
- Où sont mes fichiers de journalisation ou pourquoi sont-ils vides ?
- Pourquoi seuls certains produits ou certaines listes ne renvoient pas de résultats ?
- Que dois-je faire si mes résultats de tendance sont vides ?
- Que dois-je faire si mes résultats de "Nos choix pour vous" sont vides ?
- Pourquoi ne vois-je pas de recommandations de looks similaires ?
- Où puis-je trouver la liste complète des codes de statut API ?
- Quels paramètres la Recommandation intelligente prend-elle en charge pour le suivi des demandes d’API ?
Maintenance du compte
Cette section est destinée aux questions relatives à la configuration ou à la gestion des comptes Recommandations intelligentes.
Comment créer un compte Recommandations intelligentes ?
Pour connaître les étapes de configuration de votre compte, rendez-vous sur Présentation de la configuration.
Comment créer des ressources de modélisation et de service ?
Pour savoir comment créer des ressources de modélisation et de service, consultez l’étape 5 du guide de démarrage rapide de création de compte.
Comment puis-je contacter l’équipe du support technique du service Recommandations intelligentes ?
Pour les questions ou les problèmes sans réponse, vous pouvez contacter l’équipe du support technique Recommandations intelligentes en ouvrant un ticket d’assistance dans le portail Microsoft Azure.
- Dans le menu de gauche, sélectionnez Aide + Support.
- Sélectionnez Créer une demande de support.
- Complétez le formulaire. Un ticket de support est créé.
Où puis-je trouver l’URL du point de terminaison de service ?
Pour savoir comment localiser l’URL du point de terminaison de service, accédez à votre compte Recommandations intelligentes sur le portail Azure et recherchez la ressource du point de terminaison à utiliser. À partir de là, vous pouvez copier le point de terminaison de l’URL de service. Pour plus d’informations, rendez-vous sur le guide de démarrage rapide pour afficher les résultats des recommandations.
Comment résoudre les erreurs dans le contrat de données ?
Pour comprendre les journaux d’erreurs renvoyés dans le contrat de données, allez à Types d’erreurs.
Comment puis-je afficher les journaux d’erreurs de mon instance de modélisation ?
Pour afficher les journaux d’erreurs de votre instance de modélisation, vous devez configurer votre compte pour activer la modélisation des erreurs. Pour plus d’informations, rendez-vous sur Configurer la journalisation des erreurs. Pour plus d’informations sur les types d’erreurs pouvant être renvoyées, consultez Types d’erreurs.
Pourquoi ne puis-je voir aucun journal écrit dans mon dossier de journaux ?
Si vous ne parvenez pas à voir les journaux écrits dans votre dossier de journaux dédié, vous pouvez vérifier si votre compte IR a accès pour écrire dans le conteneur concerné :
- Accédez à votre compte Recommandations intelligentes.
- Sélectionnez l’onglet Rapports.
- Cliquez sur le bouton "Vérifier l’accès"
- Si le message renvoyé indique que "La configuration d’accès au compte de stockage est manquante", vous devez accorder des autorisations d’écriture pour accéder au conteneur associé. Si le message renvoyé indique que "Le compte de stockage demandé n’existe pas ou vous ne disposez pas des autorisations", veuillez vous assurer que l’URL indiquée est correcte.
Que se passe-t-il si je configure mal l’horodatage ?
Si vous rencontrez des problèmes avec vos horodatages, le produit sera supprimé de la liste des candidats disponibles et filtré des recommandations. Pour résoudre ce problème, commencez par vérifier les entrées de l’entité de données ItemsAndVariants et assurez-vous que la date de sortie est au format date-heure pris en charge (qui est "aaaa-MM-jjTHH : mm:ss.fffZ").
Problèmes de lecture des CSV model.json
L’ouverture des fichiers CSV dans Excel ou tout autre outil non compatible CSV peut supprimer les colonnes vides requises dans le format CSV pour les entités de données. Nous vous suggérons d’ouvrir et de vérifier vos CSV dans le Bloc-notes ou une application associée qui ne modifiera pas le contenu.
Quelle est l’approche recommandée pour mettre à jour correctement mes données d’entrée ?
Si vous essayez de modéliser et de mettre à jour vos données d’entrée en simultané, cela peut parfois entraîner la modélisation de données provenant de versions mixtes de données et des résultats de recommandation indésirables. Consultez notre Guide des meilleures pratiques pour plus d’informations sur la façon de mettre à jour correctement vos données d’entrée.
Journalisation des erreurs et des résultats d’API
Cette section est destinée aux questions relatives aux résultats de l’API ou à la documentation de journalisation des erreurs.
Comment puis-je vérifier si je suis un utilisateur autorisé à faire des demandes d’API ?
Les utilisateurs doivent être ajoutés à la liste des utilisateurs autorisés pour une ressource de point de terminaison avant d’appeler le service avec succès. Pour plus d’informations sur la façon de vérifier le statut des utilisateurs autorisés, rendez-vous à l’étape 2 du guide de démarrage rapide pour la création de demandes API.
L’outil indique que la demande a échoué, mais que l’URL est correcte.
Si l’URL est correcte, il est possible que l’utilisateur faisant la demande n’est pas sur la liste des utilisateurs autorisés pour cette ressource du point de terminaison.
Pour plus d’informations sur la façon de vérifier le statut des utilisateurs autorisés, rendez-vous à l’étape 2 du guide de démarrage rapide pour la création de demandes API.
Je viens de créer un compte, mais je ne vois pas de résultats.
S’il vient juste de démarrer, le service prend un certain temps avant que les résultats ne soient disponibles. Vous pouvez suivre l’état de la modélisation pour chacun des modèles que vous avez créés. Pour plus d’informations, consultez notre Guide des rapports sur le statut de la modélisation.
Vous pouvez également consulter le dossier des journaux pour en savoir plus sur les problèmes liés à votre contrat de données et si vous devez apporter des modifications ou des corrections.
Si vous ne voyez toujours aucun résultat, assurez-vous d’avoir autorisé votre compte Recommandations intelligentes à lire les données du conteneur concerné :
- Accédez à votre compte Recommandations intelligentes.
- Sélectionnez l’onglet Modélisation.
- Choisissez le composant de modélisation approprié.
- Sélectionner l’onglet chaîne de connexion.
- Cliquez sur le bouton "Vérifier l’accès".
- Si le message renvoyé indique que "La configuration d’accès au compte de stockage est manquante", vous devez accorder des autorisations de lecture pour accéder au conteneur associé. Si le message renvoyé indique que "Le compte de stockage demandé n’existe pas ou vous ne disposez pas des autorisations", veuillez vous assurer que l’URL indiquée est correcte.
En outre, vérifiez que les bons dossiers et fichiers sont placés dans le compte de stockage. Pour plus d’informations, rendez-vous sur Téléchargez le fichier model.json et configurez le dossier racine.
Comment suivre le statut de modélisation de mes modèles ?
Les clients Recommandations intelligentes peuvent suivre le statut de modélisation de chacun des modèles qu’ils ont créés sur leurs comptes. Après que vous avez configuré un modèle, le service crée périodiquement un fichier journal d’état pour rendre compte du statut actuel de tous les algorithmes (pour votre niveau de modélisation). Pour en savoir plus sur la façon d’accéder à ces journaux, consultez Guide des rapports sur le statut de la modélisation.
Où sont mes fichiers de journalisation ou pourquoi sont-ils vides ?
Vos fichiers de journalisation peuvent être vides si vous n’avez pas accordé les bonnes autorisations Contributeur aux données de blob de stockage ou pointé vers la chaîne de connexion incorrecte. Pour confirmer, suivez notre guide de démarrage rapide.
Assurez-vous également que vos fichiers de journalisation des erreurs ont été configurés correctement et vérifiez que votre chaîne de connexion pour votre instance de modélisation pointe vers le dossier qui contient vos fichiers de journalisation.
Pourquoi seuls certains produits ou certaines listes ne renvoient pas de résultats ?
En général, des interactions insuffisantes pour un élément ou un utilisateur donné peuvent affecter la qualité des résultats ou l’absence de résultats renvoyés. Parfois, les nouveaux produits ont également besoin de temps pour acquérir des signaux avant de s’afficher dans certaines listes de recommandations. Vous pouvez toujours examiner de plus près les performances de votre produit à l’aide des tableaux de bord.
Que dois-je faire si mes résultats de tendance sont vides ?
L’API de liste des tendances tient compte à la fois de l’âge d’un produit et de son nombre d’interactions à la notation (classement) de chaque élément de la liste.
Comptez d’abord le nombre d’interactions dans une fenêtre de temps définie, puis modélisez les facteurs selon l’âge du produit (jours depuis sa date de sortie telle qu’elle s’affiche dans le catalogue). Plus un article est récent, plus le score est élevé et, à mesure qu’un produit "vieillit", son score décroît de façon exponentielle.
Pour contrôler les résultats dans Tendance, vous devrez ajuster deux champs configurables dans le Dossier d’entité de données de Configuration de recommandation :
- TrendingListMaxAgeDays définit l’âge maximal en jours d’un produit. Un produit sorti il y a plus de TrendingListMaxAgeDays jours n’apparaîtra pas dans la liste des tendances.
- TrendingListTransactionsIntervalDays définit la fenêtre temporelle dans laquelle les interactions sont agrégées. Un élément peut être plus ancien que cette valeur, mais seules les interactions datant de moins de TrendingListTransactionsIntervalDays sont comptabilisées.
Ajustez ces paramètres dans votre entité de données de configuration de recommandation et republiez votre modèle. Ensuite, vous devriez commencer à voir les résultats des recommandations.
Que dois-je faire si mes résultats de "Nos choix pour vous" sont vides ?
La fonctionnalité "Nos choix pour vous" n’est disponible que pour les instances de modélisation avec un ensemble de fonctionnalités marqué comme Standard ou Premium. Si vous avez confirmé que l’ensemble de fonctionnalités a été configuré correctement, examinez de plus près les utilisateurs pour lesquels vous essayez d’obtenir des recommandations. Un ID utilisateur sans données d’interaction historiques (telles que les achats précédents) ne renverra pas de résultats lors de l’appel "Nos choix pour vous". Confirmez également si l’utilisateur a récemment choisi de ne pas recevoir de recommandations personnalisées. Tout utilisateur qui a désactivé la personnalisation ne recevra pas de recommandations personnalisées.
Pourquoi ne vois-je pas de recommandations de Looks similaires ?
Les recommandations Looks similaires sont basées sur des images similaires et ces recommandations ne seront présentées qu’aux clients qui ont sélectionné l’ensemble de fonctionnalités Premium et qui ont partagé des photos de leurs articles dans le contrat de données. Confirmez que vous avez sélectionné l’ensemble de fonctionnalités Premium pour votre modèle et configuré les images correctement comme indiqué dans Image des entités de données de mappage d’élément.
Où puis-je trouver la liste complète des codes de statut API ?
La liste complète des codes de statut API sont disponibles sur la page Exemples de demandes d’API, ici.
Quels paramètres la Recommandation intelligente prend-elle en charge pour le suivi des demandes d’API ?
Il est facultatif d’ajouter un ou plusieurs des ID de suivi suivants en tant que paramètres d’en-tête à vos demandes d’API. Si vous rencontrez des problèmes avec vos demandes d’API, en ajoutant un ou plusieurs de ces paramètres, nous pouvons suivre et étudier vos demandes plus efficacement en fonction des identifiants pertinents que vous fournissez.
Paramètre clé d’en-tête | description |
---|---|
CorrelationId | |
id suivi | |
parent-id | Peut être utilisé selon vos besoins pour regrouper les demandes, par exemple d’un même utilisateur, région, etc. |
Ces paramètres d’en-tête peuvent être ajoutés à n’importe quel type de requête, quels que soient l’URI, les paramètres de requête, le scénario, etc.
Voir aussi
Guide de démarrage rapide : configurer et exécuter des recommandations intelligentes avec des exemples de données
Guide de démarrage rapide : créer une demande d’API
Codes de statut API
Journaux d’erreurs
Présentation de la configuration
Présentation du contrat de données