Einen Index abfragen

Um einen Index mit der Konsole zu durchsuchen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon Kendra Konsole unter http://console.aws.amazon.com/kendra/.

2. Wählen Sie im Navigationsbereich Indizes aus.

3. Wählen Sie Ihren Index aus.

4. Wählen Sie im Navigationsmenü die Option, um Ihren Index zu durchsuchen.

5. Geben Sie eine Abfrage in das Textfeld ein und drücken Sie dann die Eingabetaste.

6. Amazon Kendra gibt die Ergebnisse der Suche zurück.

Um einen Index mit Python oder Java zu durchsuchen

• Im folgenden Beispiel wird ein Index durchsucht. Ändern Sie den Wert von query in Ihre Suchabfrage index_id und/oder in indexId den Indexbezeichner des Indexes, den Sie durchsuchen möchten.

  Sie können die Abfrage-ID für die Suche auch als Teil der Antwortelemente abrufen, wenn Sie die Abfrage-API aufrufen.

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

Um einen Index mit Postman zu durchsuchen

1. Erstellen Sie eine neue Sammlung in Postman und legen Sie den Anforderungstyp auf POST fest.

2. Geben Sie die Endpunkt-URL ein. Zum Beispiel https://kendra. .amazonaws.com<region>.

3. Wählen Sie die Registerkarte Autorisierung und geben Sie die folgenden Informationen ein.

   • Typ — Wählen Sie die AWS Signatur aus.

   • AccessKey— Geben Sie den Zugriffsschlüssel ein, der beim Erstellen eines IAM Benutzers generiert wurde.

   • SecretKey— Geben Sie den geheimen Schlüssel ein, der beim Erstellen eines IAM Benutzers generiert wurde.

   • AWS Region — Geben Sie die Region Ihres Indexes ein. Zum Beispiel us-west-2.

   • Dienstname — Geben Sie Kendra ein. Dabei wird zwischen Groß- und Kleinschreibung unterschieden, also muss es sich um Kleinbuchstaben handeln.

     Warnung

     Wenn Sie den falschen Dienstnamen eingeben oder keine Kleinbuchstaben verwenden, wird ein Fehler ausgegeben, sobald Sie Senden auswählen, um die Anfrage zu senden: „Die Anmeldeinformationen sollten auf den richtigen Dienst 'Kendra' beschränkt sein.“

     Sie müssen außerdem überprüfen, ob Sie den richtigen Zugriffs- und Geheimschlüssel eingegeben haben.

4. Wählen Sie die Registerkarte Header und geben Sie die folgenden Schlüssel- und Wertinformationen ein.

   • Schlüssel: X-Amz-Target

     Wert: com.amazonaws.kendra. AWSKendraFrontendService. Abfrage

   • Schlüssel: Content-Encoding

     Wert: amz-1.0

5. Wählen Sie die Registerkarte Körper und gehen Sie wie folgt vor.

   • Wählen Sie den rohen JSON-Typ für den Hauptteil der Anfrage.

   • Geben Sie eine JSON-Datei ein, die Ihre Index-ID und Ihren Abfragetext enthält.

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

     Warnung

     Wenn Ihr JSON nicht den richtigen Einzug verwendet, wird ein Fehler ausgegeben: "“SerializationException. Überprüfe die Einrückung in deinem JSON.

6. Wählen Sie Senden (in der Nähe oben rechts) aus.

Um in der Konsole nach einem Index auf Spanisch zu suchen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon Kendra Konsole unter http://console.aws.amazon.com/kendra/.

2. Wählen Sie im Navigationsmenü Indizes und wählen Sie Ihren Index aus.

3. Wählen Sie im Navigationsmenü die Option, um Ihren Index zu durchsuchen.

4. Wählen Sie in den Sucheinstellungen das Drop-down-Menü Sprachen aus und wählen Sie Spanisch aus.

5. Geben Sie eine Abfrage in das Textfeld ein und drücken Sie dann die Eingabetaste.

6. Amazon Kendra gibt die Ergebnisse der Suche auf Spanisch zurück.

Um einen Index auf Spanisch mit der CLI, Python oder Java zu durchsuchen

• Im folgenden Beispiel wird ein Index auf Spanisch durchsucht. Ändern Sie searchString den Wert in Ihrer Suchabfrage und den Wert in indexID den Bezeichner des Indexes, den Sie durchsuchen möchten. Der Sprachcode für Spanisch lautetes. Sie können dies durch Ihren eigenen Sprachcode ersetzen.

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