インデックスのクエリ

コンソールでインデックスを検索するには

1. AWS マネジメントコンソール にサインインして Amazon Kendra コンソール (http://console.aws.amazon.com/kendra/) を開きます。

2. ナビゲーションペインで、[Indexes] (インデックス) をクリックします。

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.Query

   • キー: Content-Encoding

     値: amz-1.0

5. [本文] タブを選択し、次の操作を行います。

   • リクエストの本文の 未加工の JSON タイプを選択します。

   • インデックス ID とクエリテキストを含む JSON を入力します。

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

     警告

     JSON で正しいインデントが使用されていない場合、「SerializationException」というエラーがスローされます。JSON のインデントを確認してください。

6. [送信] (右上付近にあります) を選択します。

コンソールでスペイン語のインデックスを検索するには

1. AWS マネジメントコンソール にサインインして Amazon Kendra コンソール (http://console.aws.amazon.com/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");
          }
      }
  }