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

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Puede generar e implementar unAmazon Kendraaplicación de búsqueda sin necesidad de ningún código front-end.Amazon Kendra Experiencia Builderle ayuda a crear e implementar una aplicación de búsqueda totalmente funcional en unos pocos clics para que pueda empezar a buscar de inmediato. Puedes diseñar tu página de búsqueda y ajustar tu búsqueda para adaptar la experiencia a las necesidades de tus usuarios.Amazon Kendragenera una URL de endpoint única y totalmente alojada de la página de búsqueda para empezar a buscar documentos y preguntas frecuentes. Puede crear rápidamente una prueba de concepto de su experiencia de búsqueda y compartirla con otros.

Utiliza la plantilla de experiencia de búsqueda disponible en el generador para personalizar la búsqueda. Puedes invitar a otros a colaborar en la creación de tu experiencia de búsqueda o evaluar los resultados de búsqueda con fines de ajuste. Una vez que la experiencia de búsqueda esté lista para que los usuarios empiecen a buscar, simplemente comparte la URL segura del endpoint.

Cómo funciona la búsqueda Experience Builder

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

  1. Cree su experiencia de búsqueda proporcionándole un nombre, una descripción y eligiendo las fuentes de datos que desea utilizar para su experiencia de búsqueda.

  2. Configura tuAWS IAM Identity Center (successor to AWS Single Sign-On)lista de usuarios y grupos y, a continuación, asignarles derechos de acceso a su experiencia de búsqueda. Te incluyes como propietario de la experiencia. Para obtener más información, consulte Proporcionar acceso a la página de búsqueda.

  3. Abres elAmazon KendraExperience Builder para diseñar y ajustar su página de búsqueda. Puede compartir la URL del endpoint de su experiencia de búsqueda con otras personas a quienes asigne derechos de acceso de edición propia o derechos de acceso de búsqueda de visualización.

Llamas alCrear experienciaAPI para crear y configurar tu experiencia de búsqueda. Si utiliza la consola, selecciona el índice y, a continuación, selecciona yExperienciasen el menú de navegación para configurar tu experiencia.

Diseña y ajusta tu experiencia de búsqueda

Una vez creada y configurada la experiencia de búsqueda, abre la experiencia de búsqueda mediante una URL de endpoint para empezar a personalizar la búsqueda como propietario con derechos de acceso al 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 tu página. Cuando esté listo para publicar, seleccionePublicación. También puede alternarCambiar a la vista en directo, para ver la última versión publicada de la página de búsqueda yCambiar al modo de compilación, para editar o personalizar la página de búsqueda.

A continuación se indican formas en que puedes personalizar tu experiencia de búsqueda.

Filtro

Añada búsqueda facetada o filtro por atributos de documento. Esto incluye atributos personalizados. Puede agregar un filtro utilizando sus propios campos de metadatos configurados. Por ejemplo, para buscar facetas por cada categoría de ciudad, utilice un_categoryatributo de documento personalizado que contiene todas las categorías de ciudades.

Respuesta sugerida

Agregue respuestas generadas por machine learning a las consultas de los usuarios. Por ejemplo,«¿Qué tan difícil es este rumbo?».Amazon Kendrapuede recuperar el texto más relevante en 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 frecuentes. Por ejemplo,«¿Cuántas horas hay que completar este curso?».Amazon Kendrapuede utilizar el documento de preguntas frecuentes que contiene la respuesta a esta pregunta y dar la respuesta correcta.

Sort

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

Documentos de

Configure cómo se muestran los documentos o los resultados de búsqueda en la página de búsqueda. Puede configurar cuántos resultados se muestran en la página, incluir paginación como números de página, habilitar un botón de comentarios de usuario y organizar cómo se muestran los campos de metadatos del documento en un resultado de búsqueda.

Lenguaje

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

Configura el tamaño y el texto del marcador de posición del cuadro de búsqueda, así como habilita sugerencias de consultas.

Ajuste de relevancia

Agregue potenciación a los campos de metadatos de documentos para poner más peso en estos campos cuando los usuarios buscan documentos. Puedes añadir un peso que comienza en 1 y aumenta gradualmente a 10. Puede aumentar los tipos de campos de texto, fecha y numéricos. Por ejemplo, para dar_last_updated_aty_created_atmayor peso o importancia que otros campos, otorgue a estos campos un peso de 1 a 10, dependiendo de su importancia. Puede aplicar distintas 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 tu experiencia de búsqueda se realiza a travésAWS IAM Identity Center (successor to AWS Single Sign-On). Cuando configuras tu experiencia de búsqueda, otorgas a otras personas que figuran en tuIAM Identity Centeracceso a directorios a suAmazon Kendrapágina de búsqueda. Reciben un correo electrónico que les indica que inicien sesión utilizando sus credenciales enIAM Identity Centerpara acceder a la página de búsqueda. Debe configurarIAM Identity Centera nivel de organización o titular de cuenta. Para obtener más información acerca de cómo configurarIAM Identity Center, consulteIntroducción alIAM Identity Center.

Usted configuraIAM Identity Centeridentidades de usuario con tu experiencia de búsqueda y asignaciónEspectadoroPropietariopermisos de acceso mediante la API o la consola.

  • Espectador: Autorizado a emitir consultas, recibir respuestas sugeridas relevantes para su búsqueda y aportar sus comentarios aAmazon Kendrapara que siga mejorando la búsqueda.

  • Propietario: Permite personalizar el diseño de la página de búsqueda, ajustar la búsqueda y utilizar la aplicación de búsqueda comoEspectador. En este momento no se admite la desactivación del acceso a los espectadores en la consola.

Para asignar acceso a otras personas a su experiencia de búsqueda, primero configureIAM Identity Centeridentidades de usuario con suAmazon Kendraexperiencia mediante el uso de laConfiguración de la experienciaObjeto. Especifique el nombre de campo que contiene los identificadores de los usuarios, como el nombre de usuario o la dirección de correo electrónico. A continuación, otorga a la lista de usuarios acceso a su experiencia de búsqueda mediante elAsociar entidades a la experienciaAPI y defina sus permisos comoEspectadoroPropietarioutilizando laAsociar personas a entidadesAPI. Se especifica cada usuario o grupo mediante laConfiguración de entidadobjeto y si ese usuario o grupo es unEspectadoroPropietarioutilizando laConfiguración de persona de entidadObjeto.

Para asignar acceso a otras personas a tu experiencia de búsqueda mediante la consola, primero tienes que crear una experiencia y confirmar tu identidad y que eres propietario. A continuación, puede asignar a otros usuarios o grupos como espectadores o propietarios. En la consola de, seleccione el índice y, a continuación, seleccioneExperienciasen el menú de navegación. Después de crear la experiencia, puede seleccionarla de la lista. Vaya aAdministración de accesospara asignar usuarios o grupos como visores o propietarios.

Configuración de 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 unAmazon KendraExperiencia de búsqueda

  1. En el panel de navegación izquierdo, enÍndices, seleccioneExperienciasy, a continuación, seleccioneCrear experiencia.

  2. En la páginaConfiguración de experiencia, escriba un nombre y una descripción para la experiencia, elija las fuentes de contenido y elija el rol de IAM para la experiencia. Para obtener más información acerca de los roles de IAM, consulteRoles de IAM paraAmazon KendraExperiencias.

  3. En la páginaConfirma tu identidad desde unIAM Identity Centerdirectorio, selecciona tu ID de usuario, como tu correo electrónico. Si no dispone de unIAM Identity Center, simplemente introduzca su nombre completo y correo electrónico para crear unIAM Identity Centerdirectorio. Esto lo incluye como usuario de la experiencia y le asigna automáticamente los derechos de acceso de su propietario.

  4. En la páginaRevisar para abrir Experience Builder, revise los detalles de configuración y seleccioneCree experiencia y abra Experience Builderpara empezar a editar la página de búsqueda.

CLI

Para crear unAmazon Kendraexperiencia

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 unAmazon Kendraexperiencia

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