Interroger un index

Pour rechercher un index à l'aide de la console

1. Connectez-vous à la Amazon Kendra console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon.com/kendra/.

2. Dans le volet de navigation, sélectionnez Indexes.

3. Choisissez votre index.

4. Dans le menu de navigation, choisissez l'option permettant de rechercher dans votre index.

5. Entrez une requête dans la zone de texte, puis appuyez sur Entrée.

6. Amazon Kendra renvoie les résultats de la recherche.

Pour rechercher un index avec Python ou Java

• L'exemple suivant effectue une recherche dans un index. Modifiez la valeur query de votre requête de recherche index_id et/ou indexId de l'identifiant d'index de l'index que vous souhaitez rechercher.

  Vous pouvez également obtenir l'ID de requête pour la recherche dans le cadre des éléments de réponse lorsque vous appelez l'API Query.

  Python

  import boto3
  import pprint
  
  kendra = boto3.client("kendra")
  
  # Provide the index ID
  index_id = "index-id"
  # Provide the query text
  query = "query text"
  
  response = kendra.query(
          QueryText = query,
          IndexId = index_id)
  
  print("\nSearch results for query: " + query + "\n")        
  
  for query_result in response["ResultItems"]:
  
      print("-------------------")
      print("Type: " + str(query_result["Type"]))
          
      if query_result["Type"]=="ANSWER" or query_result["Type"]=="QUESTION_ANSWER":
          answer_text = query_result["DocumentExcerpt"]["Text"]
          print(answer_text)
  
      if query_result["Type"]=="DOCUMENT":
          if "DocumentTitle" in query_result:
              document_title = query_result["DocumentTitle"]["Text"]
              print("Title: " + document_title)
          document_text = query_result["DocumentExcerpt"]["Text"]
          print(document_text)
  
      print("------------------\n\n")  
      

  Java

  package com.amazonaws.kendra;
  
  import software.amazon.awssdk.services.kendra.KendraClient;
  import software.amazon.awssdk.services.kendra.model.QueryRequest;
  import software.amazon.awssdk.services.kendra.model.QueryResponse;
  import software.amazon.awssdk.services.kendra.model.QueryResultItem;
  
  public class SearchIndexExample {
      public static void main(String[] args) {
          KendraClient kendra = KendraClient.builder().build();
  
          String query = "query text";
          String indexId = "index-id";
  
          QueryRequest queryRequest = QueryRequest
              .builder()
              .queryText(query)
              .indexId(indexId)
              .build();
  
          QueryResponse queryResponse = kendra.query(queryRequest);
  
          System.out.println(String.format("\nSearch results for query: %s", query));
          for(QueryResultItem item: queryResponse.resultItems()) {
              System.out.println("----------------------");
              System.out.println(String.format("Type: %s", item.type()));
  
              switch(item.type()) {
                  case QUESTION_ANSWER:
                  case ANSWER:
                      String answerText = item.documentExcerpt().text();
                      System.out.println(answerText);
                      break;
                  case DOCUMENT:
                      String documentTitle = item.documentTitle().text();
                      System.out.println(String.format("Title: %s", documentTitle));
                      String documentExcerpt = item.documentExcerpt().text();
                      System.out.println(String.format("Excerpt: %s", documentExcerpt));
                      break;
                  default:
                      System.out.println(String.format("Unknown query result type: %s", item.type()));
  
              }
  
              System.out.println("-----------------------\n");
          }
      }
  }

Pour effectuer une recherche dans un index à l'aide de Postman

1. Créez une nouvelle collection dans Postman et définissez le type de demande sur POST.

2. Entrez l'URL du point de terminaison. Par exemple, https://kendra. .amazonaws.com. <region>

3. Sélectionnez l'onglet Autorisation et entrez les informations suivantes.

   • Type —Sélectionnez une AWS signature.

   • AccessKey—Entrez la clé d'accès générée lors de la création d'un IAM utilisateur.

   • SecretKey—Entrez la clé secrète générée lors de la création d'un IAM utilisateur.

   • AWS Région —Entrez la région de votre index. Par exemple, us-west-2.

   • Nom du service —Entrez kendra. Ceci distingue les majuscules et minuscules, donc ce doit être fait en minuscules.

     Avertissement

     Si vous entrez un nom de service incorrect ou si vous n'utilisez pas de minuscules, une erreur est générée lorsque vous sélectionnez Envoyer pour envoyer la demande : « Les informations d'identification doivent être limitées au bon service « kendra ». »

     Vous devez également vérifier que vous avez saisi la bonne clé d'accès et la bonne clé secrète.

4. Sélectionnez l'onglet En-têtes et entrez les informations de clé et de valeur suivantes.

   • Clé : X-Amz-Target

     Valeur : com.amazonaws.kendra. AWSKendraFrontendService.Requête

   • Clé : Encodage du contenu

     Valeur : amz-1.0

5. Sélectionnez l'onglet Body et procédez comme suit.

   • Choisissez le type JSON brut pour le corps de la demande.

   • Entrez un JSON qui inclut votre identifiant d'index et le texte de votre requête.

     {
         "IndexId": "index-id",
         "QueryText": "enter a query here"
     }

     Avertissement

     Si votre JSON n'utilise pas l'indendation correcte, une erreur est renvoyée : « »SerializationException. Vérifiez l'indendation dans votre JSON.

6. Sélectionnez Envoyer (en haut à droite).

Pour rechercher un index en espagnol dans la console

1. Connectez-vous à la Amazon Kendra console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon.com/kendra/.

2. Dans le menu de navigation, choisissez Index et choisissez votre index.

3. Dans le menu de navigation, choisissez l'option permettant de rechercher dans votre index.

4. Dans les paramètres de recherche, sélectionnez le menu déroulant Langues et choisissez Espagnol.

5. Entrez une requête dans la zone de texte, puis appuyez sur Entrée.

6. Amazon Kendra renvoie les résultats de la recherche en espagnol.

Pour rechercher un index en espagnol à l'aide de la CLI, de Python ou de Java

• L'exemple suivant recherche un index en espagnol. Modifiez la valeur searchString de votre requête de recherche et la valeur indexID de l'identifiant de l'index que vous souhaitez rechercher. Le code de langue pour l'espagnol estes. Vous pouvez le remplacer par votre propre code de langue.

  CLI

  {
    "EqualsTo":{      
      "Key": "_language_code",
      "Value": {
      "StringValue": "es"
      }
    }
  }

  Python

  import boto3
  import pprint
  
  kendra = boto3.client("kendra")
  
  # Provide the index ID
  index_id = "index-id"
  # Provide the query text
  query = "search-string"
  
  # Includes the index ID, query text, and language attribute filter
  response = kendra.query(
          QueryText = query,
          IndexId = index_id,
          AttributeFilter = {
              "EqualsTo": {      
                  "Key": "_language_code",
                  "Value": {
                      "StringValue": "es"
                      }
                  }
              })
  
  print ("\nSearch results|Resultados de la búsqueda: " + query + "\n")        
  
  for query_result in response["ResultItems"]:
  
      print("-------------------")
      print("Type: " + str(query_result["Type"]))
          
      if query_result["Type"]=="ANSWER" or query_result["Type"]=="QUESTION_ANSWER":
          answer_text = query_result["DocumentExcerpt"]["Text"]
          print(answer_text)
  
      if query_result["Type"]=="DOCUMENT":
          if "DocumentTitle" in query_result:
              document_title = query_result["DocumentTitle"]["Text"]
              print("Title: " + document_title)
          document_text = query_result["DocumentExcerpt"]["Text"]
          print(document_text)
  
      print("------------------\n\n")
      
                                  

  Java

  package com.amazonaws.kendra;
  
  import software.amazon.awssdk.services.kendra.KendraClient;
  import software.amazon.awssdk.services.kendra.model.QueryRequest;
  import software.amazon.awssdk.services.kendra.model.QueryResponse;
  import software.amazon.awssdk.services.kendra.model.QueryResultItem;
  
  public class SearchIndexExample {
      public static void main(String[] args) {
          KendraClient kendra = KendraClient.builder().build();
  
          String query = "searchString";
          String indexId = "indexID";
  
          QueryRequest queryRequest = QueryRequest.builder()
              .queryText(query)
              .indexId(indexId)
              .attributeFilter(
                   AttributeFilter.builder()
                       .withEqualsTo(
                           DocumentAttribute.builder()
                               .withKey("_language_code")
                               .withValue("es")
                               .build())
                       .build())
              .build();
  
          QueryResponse queryResponse = kendra.query(queryRequest);
  
          System.out.println(String.format("\nSearch results|
                                            Resultados de la búsqueda: %s", query));
          for(QueryResultItem item: queryResponse.resultItems()) {
              System.out.println("----------------------");
              System.out.println(String.format("Type: %s", item.type()));
  
              switch(item.type()) {
                  case QUESTION_ANSWER:
                  case ANSWER:
                      String answerText = item.documentExcerpt().text();
                      System.out.println(answerText);
                      break;
                  case DOCUMENT:
                      String documentTitle = item.documentTitle().text();
                      System.out.println(String.format("Title: %s", documentTitle));
                      String documentExcerpt = item.documentExcerpt().text();
                      System.out.println(String.format("Excerpt: %s", documentExcerpt));
                      break;
                  default:
                      System.out.println(String.format("Unknown query result type: %s", item.type()));
  
              }
  
              System.out.println("-----------------------\n");
          }
      }
  }