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.
# Índices en Amazon Kendra
Un índice contiene el contenido de los documentos y está estructurado de forma que permite realizar búsquedas en ellos. En esta sección se proporciona información general sobre los tipos de índices y características de índices compatibles.
**Topics**
+ [Tipos de índices en Amazon Kendra](hiw-index-types.md)
+ [Adición de documentos a un índice en Amazon Kendra](hiw-index-adding-docs.md)
+ [Uso de Amazon Kendra campos de documentos comunes o reservados](index-reserved-fields-hiw.md)
+ [Recuperación de respuestas de índices en Amazon Kendra](index-searching.md)
# Tipos de índices en Amazon Kendra
Amazon Kendra tiene tres tipos de índices: índice GenAI Enterprise Edition, índice Enterprise Edition e índice Developer Edition. En las siguientes secciones se describen las características de cada índice.
**Topics**
+ [Índice GenAI Enterprise Edition de Amazon Kendra](#kendra-gen-ai-index)
+ [Índice Enterprise Edition de Amazon Kendra](#kendra-enterprise-index)
+ [Índice Developer Edition de Amazon Kendra](#kendra-developer-index)
## Índice GenAI Enterprise Edition de Amazon Kendra
Un índice GenAI Enterprise Edition de Amazon Kendra ofrece la máxima precisión para la operación de la API Retrieve y para casos de uso de generación aumentada por recuperación (RAG). Se basa en las últimas tecnologías de recuperación de información, como la búsqueda híbrida (palabra clave y vector), la incrustación semántica y los modelos de reordenamiento de la clasificación, y se ha probado en una variedad de conjuntos de datos. La operación de la API Query ofrece una precisión similar para un índice GenAI Enterprise Edition de Amazon Kendra en comparación con los índices Developer Edition y Enterprise Edition de Amazon Kendra.
Un índice GenAI Enterprise Edition de Amazon Kendra permite la movilidad de los datos indexados entre AWS los servicios de IA generativos. Con esta funcionalidad, puede reutilizar sus inversiones sin problemas sin tener que volver a crear los índices. Puede usarla en una [base de conocimientos de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base.html) como un recuperador administrado e integrarlo con las herramientas de Amazon Bedrock, como los agentes y los flujos de peticiones, para crear asistentes de IA avanzados. También puede usarla con [Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/what-is.html) para un asistente digital totalmente administrado.
Un índice GenAI Enterprise Edition de Amazon Kendra ofrece unidades de capacidad más pequeñas y granulares y un precio inicial más bajo en comparación con los otros dos tipos de índices. Esto le ayuda a utilizar su capacidad de forma más eficiente.
**nota**
Para disfrutar de la mejor experiencia y precisión, recomendamos elegir un índice GenAI Enterprise Edition de Amazon Kendra.
**Topics**
+ [Características admitidas](#kendra-gen-ai-index-features)
+ [Limitaciones](#genai-index-limitations)
### Características admitidas
Las siguientes características son compatibles con un índice GenAI Enterprise Edition de Amazon Kendra si usa la operación de la API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) para casos de uso de RAG:
+ **Compatibilidad total**: [buckets de puntuación de confianza](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [filtrado](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [facetas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [ajuste de relevancia](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [enriquecimiento de documentos personalizados](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html), [metadatos personalizados](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html) y [ajuste de capacidad de consultas y capacidad de documentos](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html).
+ **Compatibilidad parcial**: [conectores de orígenes de datos](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) y [filtrado del contexto del usuario](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Para obtener más información sobre las características con compatibilidad parcial, consulte [Limitaciones](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#genai-index-limitations).
Las siguientes características son compatibles con un índice GenAI Enterprise Edition de Amazon Kendra si usa la operación de la API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) para casos de uso de búsqueda:
+ **Compatibilidad total**: [clasificación de documentos](https://docs.aws.amazon.com/kendra/latest/dg/search-service-rerank.html), [respuesta de preguntas extractivas](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html), [buckets de puntuación de confianza](https://docs.aws.amazon.com/kendra/latest/APIReference/API_QueryResultItem.html#Kendra-Type-QueryResultItem-ScoreAttributes), [filtrado](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html), [facetas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [orden](https://docs.aws.amazon.com/kendra/latest/dg/tuning-sorting-responses.html#sorting-responses), [contracción o expansión de resultados de consultas](https://docs.aws.amazon.com/kendra/latest/dg/expand-collapse-query-results.html), [navegación por índices](https://docs.aws.amazon.com/kendra/latest/dg/browsing.html), [consultas booleanas](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [coincidencia exacta](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [consultas comodín](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [sugerencias de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html), [corrector ortográfico de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html), [ajuste de relevancia](https://docs.aws.amazon.com/kendra/latest/dg/tuning.html), [aprendizaje incremental](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html), [enriquecimiento de documentos personalizado](https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html), [metadatos personalizados](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html), [ajuste de capacidad de consultas y capacidad de documentos](https://docs.aws.amazon.com/kendra/latest/dg/adjusting-capacity.html) y [experiencia de búsqueda](https://docs.aws.amazon.com/kendra/latest/dg/deploying.html).
+ **Compatibilidad parcial**: [conectores de orígenes de datos](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) y [filtrado del contexto del usuario](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html). Para obtener más información sobre las características con compatibilidad parcial, consulte [Limitaciones](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html#kendra-gen-ai-index).
### Limitaciones
A continuación se describen las limitaciones conocidas de un índice GenAI Enterprise Edition de Amazon Kendra:
+ Los índices GenAI Enterprise Edition de Amazon Kendra solo están disponibles en las regiones Este de EE. UU. (Norte de Virginia) y Oeste de EE. UU. (Oregón).
+ Los índices GenAI Enterprise Edition de Amazon Kendra solo son compatibles con contenido en inglés.
+ Los índices GenAI Enterprise Edition de Amazon Kendra solo son compatibles con los conectores de orígenes de datos de Amazon Kendra v2.0.
+ En un índice GenAI Enterprise Edition de Amazon Kendra, solo puede usar [atributos de usuario](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-attribute) para filtrar los resultados de búsqueda por contexto de usuario.
+ Los índices GenAI Enterprise Edition de Amazon Kendra no son compatibles con el [control de acceso de los usuarios basado en tokens](https://docs.aws.amazon.com/kendra/latest/dg/create-index-access-control.html) ni con el [control de acceso de los usuarios basados en grupos e ID de usuarios](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) a los documentos.
+ La operación [CreateAccessControlConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateAccessControlConfiguration.html)de la API está deshabilitada para los índices de Amazon Kendra GenAI Enterprise Edition.
+ Si usa un índice GenAI Enterprise Edition de Amazon Kendra con Amazon Q Business, tenga en cuenta lo siguiente sobre el control del acceso de los usuarios finales a los documentos:
Amazon Q Business utiliza el ID de correo electrónico del usuario para determinar el acceso del usuario final a los documentos de un índice. Al conectar un índice de Amazon Kendra a Amazon Q Business, Amazon Q Business transmite el ID de correo electrónico de identificación del usuario a Amazon Kendra para permitir el filtrado de documentos para los usuarios finales. Si las fuentes de datos conectadas a su índice de Amazon Kendra no utilizan el filtrado de documentos basado en el ID de correo electrónico o el ID de correo electrónico no está presente, solo Amazon Q Business generará respuestas a partir de documentos públicos.
## Índice Enterprise Edition de Amazon Kendra
Un índice Enterprise Edition de Amazon Kendra proporciona capacidades de búsqueda semántica y ofrece un servicio de alta disponibilidad adecuado para las cargas de trabajo de producción.
**Topics**
+ [Características admitidas](#kendra-ent-index-features)
+ [Limitaciones](#ent-index-limitations)
### Características admitidas
Las siguientes características son compatibles para un índice Enterprise Edition de Amazon Kendra si usa la operación de la API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) para casos de uso de RAG: consultas con una [sintaxis de consulta avanzada](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [sugerencias de correcciones ortográficas](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html) para las consultas, [facetas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [sugerencias de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) para completar automáticamente las consultas de búsqueda y [aprendizaje incremental](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html).
Todas las características son compatibles para un índice Enterprise Edition de Amazon Kendra si usa la operación de la API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) para casos de uso de búsqueda.
### Limitaciones
A continuación se describen las limitaciones conocidas de un índice Enterprise Edition de Amazon Kendra:
+ Si utiliza un índice de Amazon Kendra Enterprise Edition con Amazon Q Business, tenga en cuenta lo siguiente sobre el control del acceso de los usuarios finales a los documentos:
Amazon Q Business utiliza el ID de correo electrónico del usuario para determinar el acceso de los usuarios finales a los documentos de un índice. Al conectar un índice de Amazon Kendra a Amazon Q Business, Amazon Q Business transmite el ID de correo electrónico de identificación del usuario a Amazon Kendra para permitir el filtrado de documentos para los usuarios finales. Si las fuentes de datos conectadas a su índice de Amazon Kendra no utilizan el filtrado de documentos basado en el ID de correo electrónico o el ID de correo electrónico no está presente, solo Amazon Q Business generará respuestas a partir de documentos públicos.
## Índice Developer Edition de Amazon Kendra
Un índice Developer Edition de Amazon Kendra también proporciona funciones de búsqueda semántica para que pueda probar sus casos de uso. Sin embargo, no lo recomendamos para casos de uso de producción.
**Topics**
+ [Características admitidas](#kendra-dev-index-features)
+ [Limitaciones](#dev-index-limitations)
### Características admitidas
Las siguientes características son compatibles para un índice Developer Edition de Amazon Kendra si usa la operación de API [Retrieve](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) para casos de uso de RAG: consultas con una [sintaxis de consulta avanzada](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax), [sugerencias de correcciones ortográficas](https://docs.aws.amazon.com/kendra/latest/dg/query-spell-check.html) para las consultas, [facetas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html#search-facets), [sugerencias de consultas](https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html) para completar automáticamente las consultas de búsqueda y [aprendizaje incremental](https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html).
Todas las características son compatibles para un índice Developer Edition de Amazon Kendra si usa la operación de la API [Query](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) para casos de uso de búsqueda.
### Limitaciones
A continuación se describen las limitaciones conocidas de un índice Developer Edition de Amazon Kendra:
+ Si utiliza un índice de Amazon Kendra Developer Edition con Amazon Q Business, tenga en cuenta lo siguiente sobre el control del acceso de los usuarios finales a los documentos:
Amazon Q Business utiliza el ID de correo electrónico del usuario para determinar el acceso de los usuarios finales a los documentos de un índice. Al conectar un índice de Amazon Kendra a Amazon Q Business, Amazon Q Business transmite el ID de correo electrónico de identificación del usuario a Amazon Kendra para permitir el filtrado de documentos para los usuarios finales. Si las fuentes de datos conectadas a su índice de Amazon Kendra no utilizan el filtrado de documentos basado en el ID de correo electrónico o el ID de correo electrónico no está presente, solo Amazon Q Business generará respuestas a partir de documentos públicos.
# Adición de documentos a un índice en Amazon Kendra
La forma en que agrega los documentos a un índice depende de cómo los almacena.
+ Si almacena los documentos en algún tipo de repositorio, como un Amazon S3 depósito o un SharePoint sitio de Microsoft, utiliza un [conector de fuente de datos](https://docs.aws.amazon.com/kendra/latest/dg/data-source.html) para indexar los documentos del repositorio.
+ Si no guardas los documentos en un repositorio, utilizas la operación de la [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API para indexarlos directamente.
+ Para las preguntas y respuestas de las preguntas frecuentes, que deben almacenarse en un depósito Amazon Kendra (Amazon S3), debes cargarlas desde ese depósito.
Puedes crear índices con la Amazon Kendra consola AWS CLI, el o un AWS SDK. Para obtener información sobre los tipos de documentos que se pueden indexar, consulte [Tipos de documentos](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html).
# Uso de Amazon Kendra campos de documentos comunes o reservados
Con la operación de la [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)API, puede crear campos reservados o comunes. Para ello`DocumentMetadataConfigurationUpdates`, utilice y especifique el nombre del campo de índice Amazon Kendra reservado para asignarlo al attribute/field nombre del documento equivalente. También puede crear campos personalizados.
Si utiliza un conector de fuente de datos, la mayoría incluye asignaciones de campos que asignan los campos del documento de fuente de datos a campos de Amazon Kendra indexación. Si utiliza la consola, los campos se actualizan seleccionando el origen de datos, seleccionando la acción de edición y, a continuación, pasando a la sección de asignación de campos para configurar el origen de datos.
Puede configurar el objeto `Search` para establecer un campo como visualizable, facetable, buscable y ordenable. Puede configurar el objeto `Relevance` para establecer el orden de clasificación, duración de potenciación o período de tiempo de un campo para aplicarlos a los valores de potenciación, actualización, valor de importancia y valores de importancia asignados a valores de campo específicos.
Si usa la consola, puede configurar los ajustes de búsqueda de un campo seleccionando la opción de faceta en el menú de navegación. Para configurar el ajuste de relevancia, seleccione la opción de buscar en su índice en el menú de navegación, introduzca una consulta y utilice las opciones del panel lateral para ajustar la relevancia de la búsqueda. No puede cambiar el tipo de campo una vez que ha creado el campo.
Amazon Kendra tiene los siguientes campos de documento reservados o comunes que puede utilizar:
+ `_authors`: una lista de uno o más autores responsables del contenido del documento.
+ `_category`: una categoría que coloca un documento en un grupo específico.
+ `_created_at`: la fecha y hora en formato ISO 8601 de creación del documento. Por ejemplo, 2012-03-25T12:30:10\$101:00 es el formato de fecha y hora ISO 8601 para el 25 de marzo de 2012, a las 12:30 h (más 10 segundos) en el horario de Europa Central.
+ `_data_source_id`: el identificador del origen de datos que contiene el documento.
+ `_document_body`: el contenido del documento.
+ `_document_id`: un identificador único del documento.
+ `_document_title`: el título del documento.
+ `_excerpt_page_number`: el número de página en un archivo PDF en el que aparece el fragmento del documento. Si el índice se creó antes del 8 de septiembre de 2020, debe volver a indexar los documentos antes de poder utilizar este atributo.
+ `_faq_id`: si se trata de un documento de tipo pregunta-respuesta (preguntas frecuentes), un identificador único para las preguntas frecuentes.
+ `_file_type`: el tipo de archivo del documento, como pdf o doc.
+ `_last_updated_at`: la fecha y hora en formato ISO 8601 de la última actualización del documento. Por ejemplo, 2012-03-25T12:30:10\$101:00 es el formato de fecha y hora ISO 8601 para el 25 de marzo de 2012, a las 12:30 h (más 10 segundos) en el horario de Europa Central.
+ `_source_uri`: el URI en el que está disponible el documento; por ejemplo, el URI del documento en el sitio web de una empresa.
+ `_version`: un identificador de la versión específica de un documento.
+ `_view_count`: el número de veces que se ha visto el documento.
+ `_language_code` (cadena): el código de un idioma que se aplica al documento. Este valor se define por defecto en inglés si no especifica un idioma. Para obtener más información acerca de los idiomas admitidos, incluidos sus códigos, consulte [Adición de documentos en idiomas distintos del inglés](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).
Los campos personalizados que utilizan `DocumentMetadataConfigurationUpdates` se crean con la operación de la API `UpdateIndex`, del mismo modo que cuando se crea un campo reservado o común. Debe establecer el tipo de datos adecuado para el campo personalizado.
Si utiliza la consola, los campos se actualizan seleccionando el origen de datos, seleccionando la acción de edición y, a continuación, pasando a la sección de asignación de campos para configurar el origen de datos. Algunos orígenes de datos no admiten la adición de campos nuevos o campos personalizados. No puede cambiar el tipo de campo una vez que ha creado el campo.
A continuación se muestran los tipos que puede configurar para los campos personalizados:
+ Date
+ Número
+ Cadena
+ Lista de cadenas
Si ha agregado documentos a un índice mediante la operación de [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` enumera fields/attributes los documentos y crea campos con el `DocumentAttribute` objeto.
En el caso de los documentos indexados a partir de una fuente de Amazon S3 datos, los campos se crean mediante un [archivo de metadatos JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) que incluye la información de los campos.
Si utiliza una base de datos compatible como origen de datos, puede configurar los campos mediante la opción de [asignación de campos](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database).
# Recuperación de respuestas de índices en Amazon Kendra
Después de crear un índice, puede empezar a buscar en los documentos.
Para buscar un Amazon Kendra índice, utilice la operación API de [recuperación](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Retrieve.html) o la operación API de [consulta](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html).
La operación de la API Retrieve es ideal para casos de uso de generación aumentada por recuperación (RAG). Para una consulta determinada, devuelve una lista ordenada de pasajes semánticamente relevantes de hasta 200 palabras de token. Puede enviarlos a un modelo de lenguaje de gran tamaño (LLM) para generar una respuesta utilizando RAG. Para obtener más información, consulte [Búsqueda en un índice](https://docs.aws.amazon.com/kendra/latest/dg/searching.html).
La operación de la API Query es la más adecuada para los casos de uso de búsqueda de documentos. Para una consulta determinada, devuelve una lista de documentos clasificados con fragmentos de 100 palabras que son relevantes para la consulta. Esto resulta útil para los casos de uso tradicionales de búsqueda de documentos, en los que los usuarios navegan por una lista de documentos clasificados.
Para ver qué características son compatibles con las operaciones de API Retrieve y Query para cada tipo de índice, consulte [Tipos de índice](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html).