Creación de una experiencia de búsqueda sin código

Puede crear e implementar una aplicación de búsqueda de Amazon Kendra sin necesidad de ningún código de frontend. Amazon Kendra Experience Builder le ayuda a crear e implementar una aplicación de búsqueda completamente funcional con unos pocos clics para que pueda empezar a buscar de inmediato. Puede personalizar el diseño de la página de búsqueda y ajustar la búsqueda para adaptar la experiencia a las necesidades de sus usuarios. Amazon Kendra genera una URL de punto de conexión única y totalmente alojada de su página de búsqueda para empezar a buscar en sus documentos y preguntas frecuentes. Puede crear rápidamente una prueba de concepto de su experiencia de búsqueda y compartirla con otros usuarios.

Utiliza la plantilla de experiencia de búsqueda disponible en el generador para personalizar la búsqueda. Puede invitar a otras personas a colaborar en la creación de su experiencia de búsqueda o a evaluar los resultados de la búsqueda con fines de ajuste. Una vez que la experiencia de búsqueda esté lista para que los usuarios comiencen a buscar, solo tiene que compartir la URL del punto de conexión seguro.

Cómo funciona la búsqueda de Experience Builder

El proceso general de crear una experiencia de búsqueda es el siguiente:

Llama a la API CreateExperience para crear y configurar su experiencia de búsqueda. Si usa la consola, selecciona su índice y, a continuación, selecciona Experiencias en el menú de navegación para configurar su experiencia.

Diseñe y ajuste su experiencia de búsqueda

Una vez que haya creado y configurado su experiencia de búsqueda, abra la experiencia de búsqueda mediante una URL de punto de conexión para empezar a personalizar la búsqueda como propietario con derechos de acceso de editor. Escribe la consulta en el cuadro de búsqueda y, a continuación, personaliza la búsqueda mediante las opciones de edición del panel lateral para ver cómo se aplican a su página. Cuando esté listo para publicar, seleccione Publicar. También puede cambiar entre Cambiar a la visualización en directo, para ver la última versión publicada de la página de búsqueda, y Cambiar al modo de compilación, para editar o personalizar la página de búsqueda.

Las siguientes son formas en las que puede personalizar su experiencia de búsqueda.

Filtro

Añada una búsqueda por facetas o filtre por atributos del documento. Esto incluye atributos personalizados. Puede añadir un filtro mediante sus propios campos de metadatos configurados. Por ejemplo, para buscar facetas por cada categoría de ciudad, utilice un atributo de documento personalizado _category que contenga todas las categorías de ciudades.

Respuesta sugerida

Agrega respuestas generadas por machine learning a las consultas de tus usuarios. Por ejemplo, “¿Qué tan difícil es este curso?”. Amazon Kendra puede recuperar el texto más relevante de todos los documentos que hacen referencia a la dificultad de un curso y sugerir la respuesta más relevante.

Preguntas frecuentes

Agregue un documento de preguntas frecuentes para proporcionar respuestas a las preguntas más frecuentes. Por ejemplo, “¿Cuántas horas se necesitan para completar este curso?”. Amazon Kendra puede utilizar el documento de preguntas frecuentes que contiene la respuesta a esta pregunta y dar la respuesta correcta.

Ordenar

Añada una clasificación de los resultados de la búsqueda para que los usuarios puedan organizarlos por relevancia, hora de creación, hora de la última actualización y otros criterios de clasificación.

Documentos

Configure cómo se muestran los documentos o los resultados de la búsqueda en la página de búsqueda. Puede configurar el número de resultados que se muestran en la página, incluir la paginación (por ejemplo, los números de página), activar un botón de comentarios de los usuarios y organizar la forma en que se muestran los campos de metadatos de los documentos en los resultados de la búsqueda.

Idioma

Seleccione un idioma para filtrar los resultados de la búsqueda o los documentos en el idioma seleccionado.

Cuadro de búsqueda

Configura el tamaño y el texto del marcador de posición del cuadro de búsqueda, además de permitir sugerencias de consultas.

Ajuste de relevancia

Añada potenciación a los campos de metadatos de los documentos para darles más peso cuando los usuarios busquen documentos. Puede añadir un peso que comience en 1 y aumente gradualmente hasta 10. Puede potenciar los tipos de campos de texto, fecha y numéricos. Por ejemplo, para dar a _last_updated_at y _created_at más peso o importancia que a otros campos, asigne a estos campos un peso de 1 a 10, según su importancia. Puede aplicar diferentes configuraciones de ajuste de relevancia para cada aplicación o experiencia de búsqueda.

Proporcionar acceso a la página de búsqueda

El acceso a su experiencia de búsqueda se realiza a través de IAM Identity Center. Al configurar su experiencia de búsqueda, permite que otras personas incluidas en el directorio de su Identity Center accedan a su página de búsqueda de Amazon Kendra. Estas reciben un correo electrónico en el que se les indica que inicien sesión con sus credenciales en IAM Identity Center para acceder a la página de búsqueda. Debe configurar IAM Identity Center en la organización o en el titular de la cuenta en AWS Organizations. Para obtener más información sobre configurar IAM Identity Center, consulte Primeros pasos con IAM Identity Center.

Puede activar las identidades de los usuarios en IAM Identity Center con su experiencia de búsqueda y asignar permisos de acceso de Lector o Propietario mediante la API o la consola.

Para asignar a otras personas acceso a su experiencia de búsqueda, primero debe activar las identidades de usuario en IAM Identity Center con su experiencia de Amazon Kendra mediante el objeto ExperienceConfiguration. Debe especificar el nombre del campo que contiene los identificadores de sus usuarios, como el nombre de usuario o la dirección de correo electrónico. A continuación, concede a su lista de usuarios acceso a su experiencia de búsqueda mediante la API AssociateEntitiesToExperience y define sus permisos como Lector o Propietario mediante la API AssociatePersonasToEntities. Especifica cada usuario o grupo mediante el objeto EntityConfiguration y si ese usuario o grupo es un Lector o un Propietario mediante el objeto EntityPersonaConfiguration.

Para asignar a otras personas acceso a su experiencia de búsqueda mediante la consola, primero debe crear una experiencia y confirmar su identidad y que usted es el propietario. A continuación, puede asignar a otros usuarios o grupos como lectores o propietarios. En la consola, seleccione su índice y, a continuación, seleccione Experiencias en el menú de navegación. Tras crear la experiencia, puede seleccionarla de la lista. Vaya a Administración de acceso para asignar usuarios o grupos como lectores o propietarios.

Configurar una experiencia de búsqueda

A continuación se muestra un ejemplo de configuración o creación de una experiencia de búsqueda.

Console

Para crear una experiencia de búsqueda de Amazon Kendra

1. En el panel de navegación izquierdo, en Índices, seleccione Experiencias y, a continuación, seleccione Crear experiencia.

2. En la página Configurar experiencia, introduzca un nombre y una descripción para su experiencia, elija sus fuentes de contenido y elija el rol de IAM para su experiencia. Para obtener más información acerca de roles de IAM, consulte Roles de IAM para experiencias de Amazon Kendra.

3. En la página Confirmar su identidad desde un directorio de Identity Center, seleccione su ID de usuario, como su correo electrónico. Si no tiene un directorio de Identity Center, simplemente introduzca su nombre completo y su correo electrónico para crear un directorio de Identity Center. Esto lo incluye como usuario de la experiencia y le asigna automáticamente derechos de acceso de propietario.

4. En la página Revisar para abrir Experience Builder, revise los detalles de configuración y seleccione Crear experiencia y abrir Experience Builder para empezar a editar la página de búsqueda.

CLI

Para crear una experiencia de Amazon Kendra

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

Para crear una experiencia de Amazon Kendra

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

Para crear 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.");
    }
}