인덱스 쿼리.

콘솔로 인덱스를 검색하려면

1. 에 로그인 AWS Management Console 하고 http://console.aws.amazon.com/kendra/ 콘솔을 Amazon Kendra 엽니다.

2. 탐색 창에서 인덱스를 선택합니다.

3. 인덱스를 선택합니다.

4. 탐색 메뉴에서 인덱스 검색 옵션을 선택합니다.

5. 텍스트 상자에 쿼리를 입력한 후 Enter 키를 누릅니다.

6. Amazon Kendra 는 검색 결과를 반환합니다.

Python 또는 Java로 인덱스를 검색하려면

• 다음 예제에서는 인덱스를 검색합니다. query의 값을 검색 쿼리로, index_id 또는 indexId를 검색하려는 인덱스의 인덱스 식별자로 변경합니다.

  쿼리 API를 호출할 때 응답 요소의 일부로 검색에 대한 쿼리 ID를 가져올 수도 있습니다.

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

Postman을 사용하여 인덱스를 검색하려면

1. Postman에서 새 컬렉션을 생성하고 요청 유형을 POST로 설정합니다.

2. 엔드포인트 URL를 입력합니다. 예: https://kendra.<region>.amazonaws.com.

3. 승인 탭을 선택하고 다음 정보를 입력합니다.

   • 유형 - AWS 서명을 선택합니다.

   • AccessKey - IAM 사용자를 생성할 때 생성된 액세스 키를 입력합니다.

   • SecretKey - IAM 사용자를 생성할 때 생성된 보안 키를 입력합니다.

   • AWS 리전 - 인덱스의 리전을 입력합니다. 예: us-west-2.

   • 서비스 이름 - kendra를 입력합니다. 대소문자를 구분하므로 소문자여야 합니다.

     주의

     서비스 이름을 잘못 입력하거나 소문자를 사용하지 않는 경우 전송을 선택하여 요청을 보내면 “자격 증명 범위가 올바른 서비스 'kendra'로 지정되어야 합니다.”라는 오류가 발생합니다.

     또한 올바른 액세스 키 및 보안 암호 키를 입력했는지도 확인해야 합니다.

4. 헤더 탭을 선택하고 다음 키 및 값 정보를 입력합니다.

   • 키: X-Amz-Target

     값: com.amazonaws.kendra.AWSKendraFrontendService.쿼리

   • 키: Content-Encoding

     값: amz-1.0

5. 본문 탭을 선택하고 다음을 수행합니다.

   • 요청 본문의 원시 JSON 유형을 선택합니다.

   • 인덱스 ID와 쿼리 텍스트가 포함된 JSON를 입력합니다.

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

     주의

     JSON가 올바른 인덴테이션을 사용하지 않으면 "SerializationException" 오류가 발생합니다. JSON에서 인덴테이션을 확인합니다.

6. 전송(오른쪽 상단 근처)을 선택합니다.

콘솔에서 스페인어로 인덱스를 검색하려면

1. 에 로그인 AWS Management Console 하고 http://console.aws.amazon.com/kendra/ 콘솔을 Amazon Kendra 엽니다.

2. 탐색 메뉴에서 인덱스를 선택하고 해당 인덱스를 선택합니다.

3. 탐색 메뉴에서 인덱스 검색 옵션을 선택합니다.

4. 검색 설정에서 언어 드롭다운을 선택하고 스페인어를 선택합니다.

5. 텍스트 상자에 쿼리를 입력한 후 Enter 키를 누릅니다.

6. Amazon Kendra 는 스페인어로 검색 결과를 반환합니다.

CLI, Python 또는 Java를 사용하여 스페인어로 인덱스를 검색하려면

• 다음 예제에서는 스페인어로 인덱스를 검색합니다. searchString 값을 검색 쿼리로 변경하고 indexID 값을 검색하려는 인덱스의 식별자로 변경합니다. 스페인어의 언어 코드는 es입니다. 이 코드를 사용자의 언어 코드로 바꿀 수 있습니다.

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