Consultar um índice

Para pesquisar um índice com o console

1. Faça login no AWS Management Console e abra o Amazon Kendra console em http://console.aws.amazon.com/kendra/.

2. No painel de navegação, escolha Índices.

3. Escolha seu índice.

4. No menu de navegação, escolha a opção de pesquisar no índice.

5. Na caixa de texto Filtro, insira uma consulta e, depois, pressione Enter.

6. Amazon Kendra retorna os resultados da pesquisa.

Para pesquisar um índice com Python ou Java

• O exemplo a seguir pesquisa um índice. Altere o valor de query para sua consulta de pesquisa index_id e/ou indexId para o identificador do índice que você deseja pesquisar.

  Você também poderá obter o ID da consulta para a pesquisa como parte dos elementos de resposta ao chamar a API de consulta.

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

Para pesquisar um índice usando o Postman

1. Crie uma nova coleção no Postman e defina o tipo de solicitação como POST.

2. Insira o URL do endpoint. Por exemplo, https://kendra.<region>.amazonaws.com.

3. Selecione a guia Autorização e insira as seguintes informações:

   • Tipo – Selecione a Assinatura da AWS .

   • AccessKey—Insira a chave de acesso gerada ao criar um IAM usuário.

   • SecretKey—Insira a chave secreta gerada ao criar um IAM usuário.

   • AWS Região — Insira a região do seu índice. Por exemplo, Oeste-EUA-2.

   • Nome do serviço – Insira kendra. Isso diferencia maiúsculas de minúsculas, então deve ser minúsculo.

     Atenção

     Se digitar o nome do serviço incorreto ou não usar letras minúsculas, um erro será gerado ao selecionar Enviar para enviar a solicitação: “A credencial deve ter como escopo o serviço correto 'kendra'.”

     Você também deverá verificar se inseriu a chave de acesso e a chave secreta corretas.

4. Selecione a guia Cabeçalhos e insira as seguintes informações de chave e valor:

   • Chave: X-Amz-Target

     Valor: com.amazonaws.kendra. AWSKendraFrontendService.Consulta

   • Chave: Codificação de conteúdo

     Valor: amz-1.0

5. Selecione a guia Corpo e faça o seguinte:

   • Escolha o tipo JSON bruto para o corpo da solicitação.

   • Insira um JSON que inclua seu ID de índice e o texto da consulta.

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

     Atenção

     Se seu JSON não usar a indentação correta, um erro será gerado: "”. SerializationException Verifique o recuo em seu JSON.

6. Selecione Enviar (próximo ao canto superior direito).

Para pesquisar um índice em espanhol no console

1. Faça login no AWS Management Console e abra o Amazon Kendra console em http://console.aws.amazon.com/kendra/.

2. No menu de navegação, escolha Índices e escolha seu índice.

3. No menu de navegação, escolha a opção de pesquisar no índice.

4. Nas configurações de pesquisa, selecione o menu suspenso Idiomas e escolha Espanhol.

5. Insira uma consulta na caixa de texto e pressione enter.

6. Amazon Kendra retorna os resultados da pesquisa em espanhol.

Para pesquisar um índice em espanhol usando a CLI, Python ou Java

• O exemplo a seguir pesquisa um índice em espanhol. Altere o valor searchString da sua consulta de pesquisa e o valor indexID do identificador do índice a ser pesquisado. O código do idioma para o espanhol é es. É possível substituí-lo pelo seu próprio código de idioma.

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