Obtenir des informations grâce à l'analyse des recherches

Vous pouvez utiliser l'analyse de Amazon Kendra recherche pour savoir comment votre application de recherche aide ou non vos utilisateurs à trouver des informations.

Amazon Kendra Les analyses fournissent un aperçu de la manière dont vos utilisateurs interagissent avec votre application de recherche et de l'efficacité de la configuration de votre application de recherche. Vous pouvez consulter les données des métriques à l'aide de l'GetSnapshotsAPI ou en sélectionnant Analytics dans le panneau de navigation de la console.

Vous pouvez afficher les données générées par GetSnapshots votre propre tableau de bord personnalisé. Vous pouvez également utiliser le tableau de bord des métriques fourni dans la console, qui inclut des graphiques visuels. Grâce à un tableau de bord visuel, vous pouvez identifier les tendances ou les modèles du comportement des utilisateurs au fil du temps ou détecter des problèmes liés à la configuration de votre application de recherche. Par exemple, un graphique linéaire qui montre un nombre constant de requêtes par jour et une augmentation constante peut indiquer une adoption et une utilisation accrues. D'un autre côté, une chute brutale peut indiquer qu'un problème doit être étudié.

Vous pouvez utiliser les métriques pour établir des liens entre différents points de données afin de résoudre les problèmes liés à la manière dont vos utilisateurs recherchent des informations ou découvrent des opportunités commerciales. Par exemple, le document « Comment fonctionne l'IA ? » est le document le plus cliqué dans les résultats de recherche, et la requête la plus recherchée est « Comment fonctionne le machine learning ? ». Cela vous renseigne sur les termes et la langue préférés utilisés par vos utilisateurs. Vous pouvez intégrer ces termes dans vos documents ou utiliser des synonymes personnalisés pour les rendre plus consultables par vos utilisateurs.

Métriques pour la recherche

Il existe 10 indicateurs permettant d'analyser les performances de votre application de recherche ou les informations recherchées par vos utilisateurs. Pour récupérer les données métriques, vous devez spécifier le nom de chaîne des données métriques que vous souhaitez récupérer lorsque vous appelezGetSnapshots.

Vous devez également fournir un intervalle de temps ou une fenêtre de temps pour afficher les données des métriques. L'intervalle de temps utilise le fuseau horaire de votre index. Vous pouvez consulter les données dans les fenêtres temporelles suivantes :

• THIS_WEEK: La semaine en cours, commençant le dimanche et se terminant la veille de la date en cours.

• ONE_WEEK_AGO: La semaine précédente, commençant le dimanche et se terminant le samedi suivant.

• TWO_WEEKS_AGO: La semaine précédant la semaine précédente, commençant le dimanche et se terminant le samedi suivant.

• THIS_MONTH: Le mois en cours, commençant le premier jour du mois et se terminant la veille de la date en cours.

• ONE_MONTH_AGO: Le mois précédent, commençant le premier jour du mois et se terminant le dernier jour du mois.

• TWO_MONTHS_AGO: Le mois précédant le mois précédent, commençant le premier jour du mois et se terminant le dernier jour du mois.

Dans la console, les fenêtres horaires prises en charge sont Cette semaine, Semaine précédente, Ce mois, Mois précédent.

Taux de clics

Proportion de requêtes qui mènent à un clic vers un document dans les résultats de recherche. Cela vous permet de savoir si la configuration de votre application de recherche aide les utilisateurs à trouver les informations pertinentes pour leurs requêtes. Pour les requêtes qui renvoient des réponses instantanées, les utilisateurs n'ont peut-être pas besoin de cliquer sur un document pour obtenir plus d'informations. Pour de plus amples informations, veuillez consulter Taux de réponse instantané. Vous devez appeler SubmitFeedbackpour vous assurer que les commentaires reçus lors des clics sont collectés.

Pour récupérer des données sur le taux de clics à l'aide de l'GetSnapshotsAPI, spécifiez le metricType as. AGG_QUERY_DOC_METRICS Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation.

Taux de clics nul

Proportion de requêtes n'entraînant aucun clic dans les résultats de recherche. Cela vous permet de comprendre les lacunes de votre contenu en fournissant des résultats de recherche non pertinents. Pour les requêtes qui renvoient des réponses instantanées, les utilisateurs n'ont peut-être pas besoin de cliquer sur un document pour obtenir plus d'informations. Pour de plus amples informations, veuillez consulter Taux de réponse instantané. En outre, vos paramètres de recherche, tels que le réglage des configurations, peuvent avoir un impact sur la manière dont les documents sont renvoyés dans les résultats de recherche.

Pour récupérer des données avec un taux de clic nul à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asAGG_QUERY_DOC_METRICS. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation.

Taux de résultats de recherche nul

Proportion de requêtes n'aboutissant à aucun résultat de recherche. Cela vous permet de comprendre les lacunes de votre contenu en ne fournissant aucun résultat de recherche pertinent.

Pour récupérer des données sur un taux de résultats de recherche nul à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asAGG_QUERY_DOC_METRICS. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation.

Taux de réponse instantané

Proportion de requêtes ayant reçu une réponse instantanée ou une FAQ renvoyées. Cela vous aide à comprendre le rôle des réponses instantanées dans la fourniture d'informations.

Pour récupérer des données sur le taux de réponse instantané à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asAGG_QUERY_DOC_METRICS. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation.

Requêtes les plus fréquentes

Les 100 requêtes les plus recherchées par vos utilisateurs. Cela vous permet de comprendre quelles sont les requêtes les plus populaires et le type d'informations qui intéressent le plus vos utilisateurs.

Les indicateurs incluent le nombre de fois où la requête a fait l'objet d'une recherche, la proportion de clics sur un document, la proportion de clics non cliqués sur un document, la profondeur moyenne des clics dans les résultats de recherche pour la requête, la proportion de réponses instantanées à la requête et le niveau de confiance moyen pour les 10 premiers résultats de recherche d'une requête.

Pour récupérer des données sur les principales requêtes à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asQUERIES_BY_COUNT. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation de la console, puis en sélectionnant les requêtes les plus fréquentes sous Listes de requêtes.

Requêtes les plus fréquentes sans aucun clic

Les 100 requêtes les plus fréquentes qui n'ont généré aucun clic dans les résultats de recherche. Cela vous permet de comprendre les lacunes dans votre contenu, en cas de manque de documents pertinents pour certaines requêtes ou lorsque la configuration de votre application de recherche renvoie des résultats de recherche non pertinents. Pour les requêtes qui renvoient des réponses instantanées, les utilisateurs n'ont peut-être pas besoin de cliquer sur un document pour obtenir plus d'informations. Pour de plus amples informations, veuillez consulter Taux de réponse instantané.

Les indicateurs incluent le nombre de fois où la requête n'a généré aucun clic, la proportion de zéro clic pour la requête, la proportion de réponses instantanées pour la requête et le niveau de confiance moyen pour les 10 premiers résultats de recherche d'une requête.

Pour récupérer les données des principales requêtes sans aucun clic à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asQUERIES_BY_ZERO_CLICK_RATE. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation de la console, puis en sélectionnant les requêtes les plus cliquées dans les listes de requêtes.

Requêtes les plus fréquentes sans aucun résultat

Les 100 requêtes les plus fréquentes qui n'ont donné aucun résultat de recherche. Cela vous permet de comprendre toute lacune dans votre contenu, lorsqu'aucun document ne correspond à certaines requêtes. Vos utilisateurs peuvent également utiliser des termes spécialisés susceptibles de ne pas aboutir à des résultats de recherche, ce qui vous invite à créer des synonymes personnalisés pour gérer cette situation.

Les mesures incluent le nombre de fois où la requête n'aboutit à aucun résultat de recherche, la proportion de zéro résultat de recherche pour la requête et la proportion de fois où la requête est recherchée par rapport à toutes les requêtes.

Pour récupérer des données sur les requêtes les plus fréquentes sans aucun résultat de recherche à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asQUERIES_BY_ZERO_RESULT_RATE. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation de la console, puis en sélectionnant les requêtes ayant obtenu les meilleurs résultats sous Listes de requêtes.

Cliquez en haut de la page sur les documents

Les 100 documents les plus consultés dans les résultats de recherche. Cela vous permet de comprendre quels documents ou résultats de recherche sont les plus pertinents pour vos utilisateurs lorsqu'ils demandent des informations.

Les indicateurs incluent le nombre de clics sur le document, le nombre de likes qu'un document reçoit de la part de vos utilisateurs (pouce levé), le nombre de dégoûts qu'un document reçoit de la part de vos utilisateurs (pouce vers le bas).

Pour récupérer les données sur les documents sur lesquels vous avez cliqué en haut à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asDOCS_BY_CLICK_COUNT. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation de la console, puis en sélectionnant les documents les plus cliqués sous Listes de requêtes.

Nombre total de requêtes

Le nombre total de requêtes recherchées par vos utilisateurs. Cela vous permet de comprendre dans quelle mesure vos utilisateurs interagissent avec votre application de recherche.

Pour récupérer des données sur le nombre total de requêtes à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asAGG_QUERY_DOC_METRICS. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation.

Total des documents

Le nombre total de documents dans votre index. Cela vous permet de comparer la taille de votre index au nombre total de requêtes afin de vérifier s'il existe un nombre de documents adapté au volume de requêtes.

Pour récupérer des données sur l'ensemble des documents à l'aide de l'GetSnapshotsAPI, spécifiez le metricType asAGG_QUERY_DOC_METRICS. Vous pouvez également consulter cette métrique dans la console en sélectionnant Analytics dans le panneau de navigation.

Exemple de récupération de données métriques

Le code suivant est un exemple de récupération de données sur les principales requêtes du mois précédent.

Console

Pour récupérer les requêtes les plus fréquentes du mois précédent

1. Dans le volet de navigation de gauche, sous Index, sélectionnez votre index, puis Analytics.

2. Sur la page Analytics, sélectionnez le bouton Cette semaine pour modifier la fenêtre temporelle de récupération des données en Mois précédent.

3. Sur la page Analytics, sous Listes de requêtes, sélectionnez Principales requêtes.

CLI

Pour récupérer les requêtes les plus fréquentes du mois précédent

aws kendra get-snapshots \
--index-id index-id \
--interval "ONE_MONTH_AGO" \
--metric-type "QUERIES_BY_COUNT"  

Python

Pour récupérer les requêtes les plus fréquentes du mois précédent

import boto3

kendra = boto3.client("kendra")

index_id = "index-id"
interval = "ONE_MONTH_AGO"
metric_type = "QUERIES_BY_COUNT"

snapshots_response = kendra.get_snapshots(
    IndexId = index_id,
    Interval = interval,
    MetricType = metric_type
)

print("Top queries data: " + snapshots_response["snapshotsData"])

Java

Pour récupérer les requêtes les plus fréquentes du mois précédent

package com.amazonaws.kendra;

import software.amazon.awssdk.services.kendra.KendraClient;
import software.amazon.awssdk.services.kendra.model.GetSnapshotsRequest;
import software.amazon.awssdk.services.kendra.model.GetSnapshotsResponse;

public class TopQueriesExample {
    public static void main(String[] args) {
        KendraClient kendra = KendraClient.builder().build();

        String indexId = "indexID";
        String interval = "ONE_MONTH_AGO";
        String metricType = "QUERIES_BY_COUNT";

        GetSnapshotsRequest getSnapshotsRequest = GetSnapshotsRequest
            .builder()
            .indexId(indexId)
            .interval(interval)
            .metricType(metricType)
            .build();

        GetSnapshotsResponse getSnapshotsResponse = kendra.getSnapshots(GetSnapshotsRequest);

        System.out.println(String.format("Top queries data: ", getSnapshotsResponse.snapshotsData()))

Des indicateurs aux informations exploitables

Les informations exploitables sont des informations pertinentes extraites de données brutes et utilisées pour guider vos actions ou vos décisions. Pour extraire du sens des indicateurs et les utiliser pour générer des informations exploitables, il est important non seulement d'examiner les indicateurs de manière isolée, mais également d'établir des liens entre les indicateurs.

Par exemple, la première requête sans aucun clic est « Quelles régions sont actuellement disponibles ? ». Cependant, il a également un taux de réponse instantanée de 100 %. Cela suggère que vos utilisateurs reçoivent la réponse à cette question sans avoir à cliquer sur un résultat de recherche ou un document fournissant des informations sur les régions disponibles. Si vous considérez le zéro clic uniquement, vous n'obtiendrez pas l'histoire complète et vous pourriez tirer de mauvaises conclusions quant à la réussite de la configuration de votre application de recherche dans le traitement de cette requête.

La découverte d'une opportunité commerciale est un autre exemple d'information exploitable. Les entreprises recherchent souvent des opportunités pour développer leurs clients en analysant les indicateurs de recherche. Le document le plus cliqué est « Régions disponibles ». En outre, la plupart des requêtes les plus recherchées concernent des questions sur la disponibilité des produits dans la région océanique, avec un taux de réponse instantanée de 100 % et un taux de clics élevé pour obtenir plus d'informations sur les régions disponibles dans le cadre de la réponse. Cela suggère que votre produit ou service suscite de l'intérêt et de la demande dans cette région.

Visualisation et génération de rapports sur les analyses de recherche

Cinq indicateurs incluent des données de tendances que vous pouvez visualiser et rechercher des tendances ou des modèles au fil du temps. Si vous utilisez la console, des graphiques des données de tendances sont fournis. Si vous utilisez les API, vous pouvez récupérer les données de tendances pour créer vos propres graphiques ou visualisations. La plupart des graphiques de la console tracent les points de données quotidiens sur la période que vous avez choisie.

La console fournit un tableau de bord des indicateurs dans lequel vous pouvez sélectionner un graphique et la liste des principaux éléments que vous souhaitez consulter. Vous pouvez exporter les statistiques affichées sur votre tableau de bord au format CSV en sélectionnant Exporter sur la page d'accueil d'Analytics. Vous pouvez inclure ces rapports dans vos documents commerciaux ou vos présentations.

Vous pouvez visualiser les indicateurs suivants :

Graphique du nombre total de requêtes

Un graphique linéaire du nombre de requêtes émises par jour. Le graphique vous aide à visualiser les modèles d'engagement quotidien des utilisateurs. Parmi les exemples, citons une augmentation ou une diminution constante de l'engagement des utilisateurs, ou une chute drastique à 0 requêtes en raison d'un crash de votre application de recherche ou de problèmes avec votre site Web.

Si vous utilisez l'API, vous pouvez récupérer ces données en spécifiantTREND_QUERY_DOC_METRICS. Vous pouvez utiliser les données pour créer vos propres graphiques ou utiliser les graphiques fournis dans la console.

Graphique du taux de clics

Un graphique linéaire des proportions de clics par jour. Le graphique vous aide à visualiser les tendances du taux de clics quotidien. Parmi les exemples, citons une augmentation ou une diminution constante du taux de clics, ou une diminution du nombre de réponses instantanées susceptible d'influencer une augmentation du taux de clics.

Si vous utilisez l'API, vous pouvez récupérer ces données en spécifiantTREND_QUERY_DOC_METRICS. Vous pouvez utiliser les données pour créer vos propres graphiques ou utiliser les graphiques fournis dans la console.

Graphique du taux de clic nul

Un graphique linéaire de la proportion de zéro clic par jour. Le graphique vous aide à visualiser les modèles de taux de clics quotidiens nuls. Parmi les exemples, citons une augmentation ou une diminution constante du taux de clic nul, ou une augmentation du nombre de réponses instantanées susceptible d'influencer une augmentation du taux de zéro clic.

Si vous utilisez l'API, vous pouvez récupérer ces données en spécifiantTREND_QUERY_DOC_METRICS. Vous pouvez utiliser les données pour créer vos propres graphiques ou utiliser les graphiques fournis dans la console.

Graphique du taux de résultats de recherche nuls

Un graphique linéaire de la proportion de zéro résultat de recherche par jour. Le graphique vous aide à visualiser les tendances du taux quotidien de zéro résultat de recherche. Parmi les exemples, citons une augmentation ou une diminution constante du taux de résultats de recherche nuls, ou une forte diminution du nombre de documents dans votre index, susceptible d'influencer une augmentation du taux de zéro résultat de recherche.

Si vous utilisez l'API, vous pouvez récupérer ces données en spécifiantTREND_QUERY_DOC_METRICS. Vous pouvez utiliser les données pour créer vos propres graphiques ou utiliser les graphiques fournis dans la console.

Graphique du taux de réponse instantané

Un graphique linéaire de la proportion de requêtes ayant reçu une réponse instantanée ou une FAQ renvoyées. Le graphique vous aide à visualiser les tendances du taux de réponse instantanée quotidien. Parmi les exemples, citons l'augmentation ou la diminution constante du nombre de requêtes de type question-réponse, ou la diminution du nombre de clics susceptibles d'influencer une augmentation du nombre de réponses instantanées.

Si vous utilisez l'API, vous pouvez récupérer ces données en spécifiantTREND_QUERY_DOC_METRICS. Vous pouvez utiliser les données pour créer vos propres graphiques ou utiliser les graphiques fournis dans la console.