Interrogare un indice

Per cercare un indice con la console

1. Accedi AWS Management Console e apri la Amazon Kendra console all'indirizzo http://console.aws.amazon.com/kendra/.

2. Nel pannello di navigazione, scegli Indici.

3. Scegli il tuo indice.

4. Nel menu di navigazione, scegli l'opzione per cercare nell'indice.

5. Inserisci una query nella casella di testo, quindi premi invio.

6. Amazon Kendra restituisce i risultati della ricerca.

Per cercare un indice con Python o Java

• L'esempio seguente esegue una ricerca in un indice. Modificate query il valore della query di ricerca index_id e/o indexId dell'identificatore dell'indice in cui desiderate cercare.

  Puoi anche ottenere l'ID della query per la ricerca come parte degli elementi di risposta quando chiami 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");
          }
      }
  }

Per cercare un indice usando Postman

1. Crea una nuova raccolta in Postman e imposta il tipo di richiesta su POST.

2. Inserisci l'URL dell'endpoint. Ad esempio, https://kendra. .amazonaws.com. <region>

3. Seleziona la scheda Autorizzazione e inserisci le seguenti informazioni.

   • Tipo: seleziona la AWS firma.

   • AccessKey—Inserisci la chiave di accesso generata quando crei un IAM utente.

   • SecretKey—Immettere la chiave segreta generata quando si crea un IAM utente.

   • AWS Regione: inserire la regione dell'indice. Ad esempio, us-west-2.

   • Nome servizio: inserisci kendra. Fa distinzione tra maiuscole e minuscole, quindi deve essere minuscola.

     avvertimento

     Se inserisci il nome di servizio errato o non usi le lettere minuscole, viene generato un errore dopo aver selezionato Invia per inviare la richiesta: «La credenziale deve essere limitata al servizio corretto 'kendra'».

     È inoltre necessario verificare di aver inserito la chiave di accesso e la chiave segreta corrette.

4. Seleziona la scheda Intestazioni e inserisci le seguenti informazioni sulla chiave e sul valore.

   • Chiave: X-Amz-Target

     Valore: com.amazonaws.kendra. AWSKendraFrontendService.Interrogazione

   • Chiave: codifica del contenuto

     Valore: amz-1.0

5. Selezionate la scheda Corpo ed effettuate le seguenti operazioni.

   • Scegliete il tipo JSON non elaborato per il corpo della richiesta.

   • Inserisci un codice JSON che includa l'ID dell'indice e il testo della query.

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

     avvertimento

     Se il tuo JSON non utilizza l'indendazione corretta, viene generato un errore: "». SerializationException Controlla l'indendazione nel tuo codice JSON.

6. Seleziona Invia (in alto a destra).

Per cercare un indice in spagnolo nella console

1. Accedi AWS Management Console e apri la Amazon Kendra console all'indirizzo http://console.aws.amazon.com/kendra/.

2. Nel menu di navigazione, scegli Indici e scegli il tuo indice.

3. Nel menu di navigazione, scegli l'opzione per cercare nell'indice.

4. Nelle impostazioni di ricerca, seleziona il menu a discesa Lingue e scegli lo spagnolo.

5. Inserisci una query nella casella di testo, quindi premi invio.

6. Amazon Kendra restituisce i risultati della ricerca in spagnolo.

Per cercare un indice in spagnolo utilizzando CLI, Python o Java

• L'esempio seguente cerca un indice in spagnolo. Modificate searchString il valore della query di ricerca e indexID il valore con l'identificatore dell'indice che desiderate cercare. Il codice della lingua per lo spagnolo èes. Puoi sostituirlo con il tuo codice di lingua.

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