Création d'une expérience de recherche sans code

PDFRSS

Vous pouvez créer et déployer une application Amazon Kendra de recherche sans avoir besoin de code frontal. Amazon Kendra Experience Builder vous aide à créer et à déployer une application de recherche entièrement fonctionnelle en quelques clics afin que vous puissiez commencer à rechercher immédiatement. Vous pouvez personnaliser votre page de recherche et ajuster votre recherche pour adapter l'expérience aux besoins de vos utilisateurs. Amazon Kendra génère une URL de point de terminaison unique et entièrement hébergée de votre page de recherche pour commencer à rechercher vos documents et FAQs. Vous pouvez rapidement établir une preuve de concept de votre expérience de recherche et la partager avec d'autres personnes.

Vous utilisez le modèle d'expérience de recherche disponible dans le générateur pour personnaliser votre recherche. Vous pouvez inviter d'autres personnes à collaborer au développement de votre expérience de recherche ou à évaluer les résultats de recherche à des fins d'optimisation. Une fois que votre expérience de recherche est prête pour que vos utilisateurs puissent commencer à effectuer des recherches, il vous suffit de partager l'URL sécurisée du point de terminaison.

Fonctionnement du moteur de recherche Experience Builder

Le processus global de création d'une expérience de recherche est le suivant :

1. Vous créez votre expérience de recherche en lui attribuant un nom, une description et en choisissant les sources de données que vous souhaitez utiliser pour votre expérience de recherche.

2. Vous configurez votre liste d'utilisateurs et de groupes, AWS IAM Identity Center puis vous leur attribuez des droits d'accès à votre expérience de recherche. Vous vous incluez en tant que propriétaire de l'expérience. Pour de plus amples informations, veuillez consulter Fournir un accès à votre page de recherche.

3. Vous ouvrez l' Amazon Kendra Experience Builder pour concevoir et ajuster votre page de recherche. Vous pouvez partager l'URL de votre point de terminaison correspondant à votre expérience de recherche avec d'autres personnes à qui vous attribuez des droits d'accès de modification ou des droits d'accès de consultation et de recherche.

Vous appelez l'CreateExperienceAPI pour créer et configurer votre expérience de recherche. Si vous utilisez la console, vous sélectionnez votre index, puis Experiences dans le menu de navigation pour configurer votre expérience.

Concevez et optimisez votre expérience de recherche

Une fois que vous avez créé et configuré votre expérience de recherche, vous l'ouvrez à l'aide d'une URL de point de terminaison pour commencer à personnaliser votre recherche en tant que propriétaire disposant de droits d'accès aux éditeurs. Vous tapez votre requête dans le champ de recherche, puis vous personnalisez votre recherche à l'aide des options d'édition du panneau latéral pour voir comment elles s'appliquent à votre page. Lorsque vous êtes prêt à publier, sélectionnez Publier. Vous pouvez également basculer entre le mode Live View, pour afficher la dernière version publiée de votre page de recherche, et le Basculer en mode build, pour modifier ou personnaliser votre page de recherche.

Les méthodes suivantes vous permettent de personnaliser votre expérience de recherche.

Filtre

Ajoutez une recherche à facettes ou filtrez par attributs de document. Cela inclut les attributs personnalisés. Vous pouvez ajouter un filtre à l'aide de vos propres champs de métadonnées configurés. Par exemple, pour effectuer une recherche par facettes par catégorie de ville, utilisez un attribut de document _category personnalisé qui contient toutes les catégories de villes.

Réponse suggérée

Ajoutez des réponses générées par le machine learning aux requêtes de vos utilisateurs. Par exemple, « Quelle est la difficulté de ce cours ? » . Amazon Kendra peut récupérer le texte le plus pertinent parmi tous les documents faisant référence à la difficulté d'un cours et suggérer la réponse la plus pertinente.

FAQ

Ajoutez un document FAQ pour fournir des réponses aux questions fréquemment posées. Par exemple, « Combien d'heures faudra-t-il pour suivre ce cours ? » . Amazon Kendra peut utiliser le document FAQ contenant la réponse à cette question et donner la bonne réponse.

Tri

Ajoutez le tri des résultats de recherche afin que vos utilisateurs puissent organiser les résultats par pertinence, date de création, date de dernière mise à jour et autres critères de tri.

Documents

Configurez le mode d'affichage des documents ou des résultats de recherche sur votre page de recherche. Vous pouvez configurer le nombre de résultats affichés sur la page, inclure une pagination telle que les numéros de page, activer un bouton de commentaires utilisateur et organiser la manière dont les champs de métadonnées des documents sont affichés dans un résultat de recherche.

Langue

Sélectionnez une langue pour filtrer les résultats de recherche ou les documents dans la langue sélectionnée.

Boîte de recherche

Configurez la taille et le texte de remplacement de votre champ de recherche, et autorisez les suggestions de requêtes.

Réglage de la pertinence

Renforcez les champs de métadonnées des documents pour donner plus de poids à ces champs lorsque vos utilisateurs recherchent des documents. Vous pouvez ajouter un poids qui commence à 1 et augmente progressivement jusqu'à 10. Vous pouvez améliorer les types de champs texte, de date et numériques. Par exemple, pour donner _created_at plus _last_updated_at de poids ou d'importance qu'aux autres champs, attribuez-leur une pondération de 1 à 10, en fonction de leur importance. Vous pouvez appliquer différentes configurations de réglage de la pertinence pour chaque application ou expérience de recherche.

Fournir un accès à votre page de recherche

L'accès à votre expérience de recherche se fait via IAM Identity Center. Lorsque vous configurez votre expérience de recherche, vous autorisez les autres personnes répertoriées dans votre répertoire Identity Center à accéder à votre page Amazon Kendra de recherche. Ils reçoivent un e-mail leur demandant de se connecter à l'aide de leurs informations d'identification dans IAM Identity Center pour accéder à la page de recherche. Vous devez configurer IAM Identity Center au niveau de l'organisation ou du titulaire du compte dans AWS Organizations. Pour plus d'informations sur la configuration d'IAM Identity Center, consultez Getting started with IAM Identity Center.

Vous activez les identités des utilisateurs dans IAM Identity Center en fonction de votre expérience de recherche et vous attribuez des autorisations d'accès au Viewer ou au Owner à l'aide de l'API ou de la console.

• Afficheur : autorisé à émettre des requêtes, à recevoir des suggestions de réponses pertinentes pour sa recherche et à apporter ses commentaires Amazon Kendra afin d'améliorer continuellement la recherche.

• Propriétaire : autorisé à personnaliser le design de la page de recherche, à ajuster la recherche et à utiliser l'application de recherche en tant que visualiseur. La désactivation de l'accès aux spectateurs dans la console n'est actuellement pas prise en charge.

Pour attribuer à d'autres personnes l'accès à votre expérience de recherche, vous devez d'abord activer les identités des utilisateurs dans IAM Identity Center en fonction de votre Amazon Kendra expérience en utilisant l'ExperienceConfigurationobjet. Vous spécifiez le nom du champ qui contient les identifiants de vos utilisateurs, tels que le nom d'utilisateur ou l'adresse e-mail. Vous autorisez ensuite votre liste d'utilisateurs à accéder à votre expérience de recherche à l'aide de l'AssociateEntitiesToExperienceAPI et définissez leurs autorisations en tant que Viewer ou Owner à l'aide de l'AssociatePersonasToEntitiesAPI. Vous spécifiez chaque utilisateur ou groupe utilisant l'EntityConfigurationobjet et indiquez si cet utilisateur ou ce groupe est un visualiseur ou un propriétaire utilisant l'EntityPersonaConfiguratonobjet.

Pour autoriser d'autres personnes à accéder à votre expérience de recherche à l'aide de la console, vous devez d'abord créer une expérience, confirmer votre identité et confirmer que vous êtes propriétaire. Vous pouvez ensuite désigner d'autres utilisateurs ou groupes en tant que spectateurs ou propriétaires. Dans la console, sélectionnez votre index, puis sélectionnez Expériences dans le menu de navigation. Après avoir créé votre expérience, vous pouvez la sélectionner dans la liste. Accédez à Gestion des accès pour attribuer des utilisateurs ou des groupes en tant que spectateurs ou propriétaires.

Configuration d'une expérience de recherche

Voici un exemple de configuration ou de création d'une expérience de recherche.

Console

Pour créer une expérience Amazon Kendra de recherche

1. Dans le volet de navigation de gauche, sous Indexes, sélectionnez Expériences, puis sélectionnez Créer une expérience.

2. Sur la page Configurer l'expérience, entrez le nom et la description de votre expérience, choisissez vos sources de contenu et choisissez le rôle IAM pour votre expérience. Pour plus d'informations sur les rôles IAM, consultez la section Rôles IAM pour Amazon Kendra les expériences.

3. Sur la page Confirmez votre identité à partir d'un annuaire Identity Center, sélectionnez votre nom d'utilisateur tel que votre adresse e-mail. Si vous n'avez pas de répertoire Identity Center, entrez simplement votre nom complet et votre adresse e-mail pour créer un annuaire Identity Center. Cela vous inclut en tant qu'utilisateur de l'expérience et vous attribue automatiquement les droits d'accès de propriétaire.

4. Sur la page Vérifier pour ouvrir Experience Builder, passez en revue les détails de votre configuration, sélectionnez Créer une expérience et ouvrez Experience Builder pour commencer à modifier votre page de recherche.

CLI

Pour créer une Amazon Kendra expérience

aws kendra create-experience \
 --name experience-name \
 --description "experience description" \
 --index-id index-id \
 --role-arn arn:aws:iam::account-id:role/role-name \
 --configuration '{"ExperienceConfiguration":[{"ContentSourceConfiguration":{"DataSourceIds":["data-source-1","data-source-2"]}, "UserIdentityConfiguration":"identity attribute name"}]}' 

aws kendra describe-experience \
 --endpoints experience-endpoint-URL(s)

Python

Pour créer une Amazon Kendra expérience

import boto3
from botocore.exceptions import ClientError
import pprint
import time

kendra = boto3.client("kendra")

print("Create an experience.")

# Provide a name for the experience
name = "experience-name"
# Provide an optional description for the experience
description = "experience description"
# Provide the index ID for the experience
index_id = "index-id"
# Provide the IAM role ARN required for Amazon Kendra experiences
role_arn = "arn:aws:iam::${account-id}:role/${role-name}"
# Configure the experience
configuration = {"ExperienceConfiguration":
        [{
            "ContentSourceConfiguration":{"DataSourceIds":["data-source-1","data-source-2"]},
            "UserIdentityConfiguration":"identity attribute name"
        }]
    }

try:
    experience_response = kendra.create_experience(
        Name = name,
        Description = description,
        IndexId = index_id,
        RoleArn = role_arn,
        Configuration = configuration
    )

    pprint.pprint(experience_response)

    experience_endpoints = experience_response["Endpoints"]

    print("Wait for Amazon Kendra to create the experience.")

    while True:
        # Get the details of the experience, such as the status
        experience_description = kendra.describe_experience(
            Endpoints = experience_endpoints
        )
        status = experience_description["Status"]
        print(" Creating experience. Status: "+status)
        time.sleep(60)
        if status != "CREATING":
            break

except  ClientError as e:
        print("%s" % e)

print("Program ends.")

Java

Pour créer un Amazon Kendra

package com.amazonaws.kendra;

import java.util.concurrent.TimeUnit;
import software.amazon.awssdk.services.kendra.KendraClient;
import software.amazon.awssdk.services.kendra.model.CreateExperienceRequest;
import software.amazon.awssdk.services.kendra.model.CreateExperienceResponse;
import software.amazon.awssdk.services.kendra.model.DescribeExperienceRequest;
import software.amazon.awssdk.services.kendra.model.DescribeExperienceResponse;
import software.amazon.awssdk.services.kendra.model.ExperienceStatus;


public class CreateExperienceExample {

    public static void main(String[] args) throws InterruptedException {
        System.out.println("Create an experience");
        
        String experienceName = "experience-name";
        String experienceDescription = "experience description";
        String indexId = "index-id";
        String experienceRoleArn = "arn:aws:iam::account-id:role/role-name";

        KendraClient kendra = KendraClient.builder().build();
        
        CreateExperienceRequest createExperienceRequest = CreateExperienceRequest 
            .builder()
            .name(experienceName)
            .description(experienceDescription)
            .roleArn(experienceRoleArn)
            .configuration(
                ExperienceConfiguration
                    .builder()
                    .contentSourceConfiguration(
                        ContentSourceConfiguration(
                            .builder()
                            .dataSourceIds("data-source-1","data-source-2")
                            .build()
                        )
                    )
                    .userIdentityConfiguration(
                        UserIdentityConfiguration(
                            .builder()
                            .identityAttributeName("identity-attribute-name")
                            .build()
                        )
                    ).build()
            ).build();
        
        CreateExperienceResponse createExperienceResponse = kendra.createExperience(createExperienceRequest);
        System.out.println(String.format("Experience response %s", createExperienceResponse));

        String experienceEndpoints = createExperienceResponse.endpoints();

        System.out.println(String.format("Wait for Kendra to create the experience.", experienceEndpoints));
        while (true) {
            DescribeExperienceRequest describeExperienceRequest = DescribeExperienceRequest.builder().endpoints(experienceEndpoints).build();
            DescribeExperienceResponse describeEpxerienceResponse = kendra.describeExperience(describeExperienceRequest);
            ExperienceStatus status = describeExperienceResponse.status();
            TimeUnit.SECONDS.sleep(60);
            if (status != ExperienceStatus.CREATING) {
                break;
            }
        }

        System.out.println("Experience creation is complete.");
    }
}