

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.

# Paso 5: Consulta del índice de Amazon Kendra
<a name="tutorial-search-metadata-query-kendra"></a>

Su índice de Amazon Kendra ya está listo para consultas en lenguaje natural. Cuando busca en su índice, Amazon Kendra utiliza todos los datos y metadatos que ha proporcionado para devolver las respuestas más precisas a su consulta de búsqueda.

Hay tres tipos de consultas a las que Amazon Kendra puede responder:
+ Consultas sobre hechos (preguntas sobre “quién”, “qué”, “cuándo” o “dónde”)
+ Consultas descriptivas (preguntas sobre el “cómo”)
+ Búsquedas de palabras clave (preguntas cuya intención y alcance no están claros)

**Topics**
+ [Consulta del índice de Amazon Kendra](#tutorial-search-metadata-query-kendra-basic)
+ [Filtrar los resultados de búsqueda](#tutorial-search-metadata-query-kendra-filters)

## Consulta del índice de Amazon Kendra
<a name="tutorial-search-metadata-query-kendra-basic"></a>

Puede consultar su índice de Amazon Kendra mediante preguntas que correspondan a los tres tipos de consultas que admite Amazon Kendra. Para más información, vea [Consultas](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html).

Las preguntas de ejemplo de esta sección se eligieron en función del conjunto de datos de muestra.

### Para consultar su índice de Amazon Kendra (Consola)
<a name="tutorial-search-metadata-query-index-console"></a>

1. Abra la consola Amazon Kendra en. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)

1. En la lista de **índices**, haga clic en `kendra-index`.

1. En el menú de navegación de la izquierda, elija la opción para buscar en su índice.

1. Para ejecutar un ejemplo de consulta de datos de muestra, escriba **Who is Lewis Hamilton?** en el cuadro de búsqueda y pulse Entrar.

   El primer resultado devuelto es la respuesta sugerida por Amazon Kendra, junto con el archivo de datos que contiene la respuesta. El resto de los resultados forman el conjunto de documentos recomendados.

   

     
![\[Search interface showing query "Who is Lewis Hamilton?" with Formula One driver information results.\]](http://docs.aws.amazon.com/es_es/kendra/latest/dg/images/tutorial-query1.png)

1. Para realizar una consulta descriptiva, introduzca **How does Formula One work?** en el cuadro de búsqueda y pulse Entrar.

   Verá otro resultado devuelto por la consola Amazon Kendra, esta vez con la frase relevante resaltada.

   

     
![\[Search results for "How does Formula One work?" showing snippets about the racing series.\]](http://docs.aws.amazon.com/es_es/kendra/latest/dg/images/tutorial-query2.png)

1. Para realizar una búsqueda de palabras clave, escriba **Formula One** en el cuadro de búsqueda y pulse Entrar.

   Verá otro resultado devuelto por la consola de Amazon Kendra, seguido de los resultados de todas las demás menciones de la frase en el conjunto de datos.

   

     
![\[Search results for "Formula One" showing Amazon Kendra suggested answers with article snippets.\]](http://docs.aws.amazon.com/es_es/kendra/latest/dg/images/tutorial-query3.png)

### Para consultar su índice de Amazon Kendra (AWS CLI)
<a name="tutorial-search-metadata-query-index-cli"></a>

1. Para ejecutar una consulta sobre hechos de ejemplo, utilice el comando [query](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Who is Lewis Hamilton?" \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Who is Lewis Hamilton?" \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Who is Lewis Hamilton?" ^
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------

    AWS CLI muestra los resultados de la consulta.

1. Para ejecutar una consulta descriptiva de ejemplo, utilice el comando [query](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "How does Formula One work?" \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*está guardado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "How does Formula One work?" \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "How does Formula One work?" ^
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------

    AWS CLI muestra los resultados de su consulta.

1. Para ejecutar un ejemplo de búsqueda por palabra clave, utilice el comando [query](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Formula One" \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*está guardado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Formula One" \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Formula One" ^
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------

    AWS CLI Muestra las respuestas devueltas a su consulta.

## Filtrar los resultados de búsqueda
<a name="tutorial-search-metadata-query-kendra-filters"></a>

Puede filtrar y ordenar los resultados de la búsqueda mediante atributos de documento personalizados en la consola de Amazon Kendra. Para obtener más información sobre cómo Amazon Kendra procesa las consultas, consulte [Filtrar consultas](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html).

### Para filtrar los resultados de la búsqueda (Consola)
<a name="tutorial-search-metadata-filter-index-console"></a>

1. Abra la consola Amazon Kendra en. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)

1. En la lista de **índices**, haga clic en `kendra-index`.

1. En el menú de navegación de la izquierda, elija la opción para buscar en su índice.

1. En el cuadro de búsqueda, escriba **Soccer matches** como consulta y pulse Entrar.

1. En el menú de navegación de la izquierda, seleccione **Filtrar resultados de búsqueda** para ver una lista de facetas que puede utilizar para filtrar su búsqueda.

1. Seleccione la casilla “Liga de Campeones” en el subtítulo **EVENTO**, para ver los resultados de su búsqueda filtrados solo por los resultados que contengan “Liga de Campeones”.

   

     
![\[Search interface for soccer matches with filters and Amazon Kendra suggested answers.\]](http://docs.aws.amazon.com/es_es/kendra/latest/dg/images/tutorial-filter.png)

### Para filtrar los resultados de la búsqueda (AWS CLI)
<a name="tutorial-search-metadata-filter-index-cli"></a>

1. Para ver las entidades de un tipo específico (por ejemplo, `EVENT`) que están disponibles para una búsqueda, utilice el comando [query](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --facets '[{"DocumentAttributeKey":"EVENT"}]' \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --facets '[{"DocumentAttributeKey":"EVENT"}]' \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Soccer matches" ^
           --facets '[{"DocumentAttributeKey":"EVENT"}]' ^
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------

    AWS CLI Muestra los resultados de la búsqueda. Para obtener una lista de las facetas del tipo`EVENT`, vaya a la sección «FacetResults» de la AWS CLI salida para ver una lista de las facetas filtrables con sus recuentos. Por ejemplo, una de las facetas es la “Liga de Campeones”.
**nota**  
En lugar de `EVENT`, puede elegir cualquiera de los campos de índice que creó en [Creación de un índice de Amazon Kendra](tutorial-search-metadata-create-index-ingest.md#tutorial-search-metadata-create-index) para el valor `DocumentAttributeKey`.

1. Para ejecutar la misma búsqueda pero filtrar solo por los resultados que contengan “Liga de Campeones”, utilice el comando [query](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html):

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*está guardado, `kendra-index-id`
   + *aws-region*es tu AWS región.

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' \
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Soccer matches" ^
           --attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' ^
           --region aws-region
   ```

   Donde:
   + *kendra-index-id*es tu salvado`kendra-index-id`,
   + *aws-region*es tu AWS región.

------

    AWS CLI Muestra los resultados de búsqueda filtrados.