翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# オープンソースの OpenSearch のクエリに Amazon Personalize Search Ranking プラグインを適用する
<a name="opensource-apply-plugin"></a>

Amazon Personalize Search Ranking プラグインは、OpenSearch インデックスのすべてのクエリとレスポンスに適用できます。このプラグインは個々の OpenSearch クエリとレスポンスに適用することもできます。
+  次の curl コマンドは、ローカルで実行されているオープンソース OpenSearch クラスター内の OpenSearch インデックスに検索パイプラインを適用します。この方法では、このインデックスでのすべての検索がプラグインを使用して検索結果にパーソナライゼーションを適用します。

  ```
  curl -XGET "https://localhost:9200/index/_settings" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
  {
    "index.search.default_pipeline": "pipeline-name"
  }
  '
  ```
+ 次の curl コマンドは、ローカルで実行されているオープンソース OpenSearch クラスター内のインデックスで Toyota ブランド車を対象とする個別のクエリに検索パイプラインを適用します。

   `user_id` には、検索結果を取得するユーザーの ID を指定します。Amazon Personalize ソリューションバージョンの作成に使用したデータに、このユーザーが存在する必要があります。ユーザーが不在の場合、Amazon Personalize は人気に基づいてアイテムをランク付けします。`context` には、コンテキストメタデータを使用する場合は、デバイスタイプなどのユーザーのコンテキストメタデータを提供してください。`context` フィールドはオプションです。詳細については、「[コンテキストメタデータを使用したレコメンデーションの関連性の向上](contextual-metadata.md)」を参照してください。

  ```
  curl -XGET "http://localhost:9200/index/_search?search_pipeline=pipeline-name" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
  {
    "query": {
      "multi_match": {
        "query": "Toyota",
        "fields": ["BRAND"]
      }
    },
    "ext": {
      "personalize_request_parameters": {
        "user_id": "USER ID",
        "context": { "DEVICE": "mobile phone" }
      }
    }
  }
  '
  ```

 結果がどのように再ランク付けされるかを理解するには、OpenSearch Dashboards を使用して OpenSearch の結果をプラグインで再ランク付けした結果と比較できます。詳細については、「[パーソナライズされた OpenSearch の結果を、パーソナライズされていない結果と比較する](opensource-comparing-results.md)」を参照してください。

 OpenSearch クエリにプラグインを適用すると、OpenSearch パイプラインのメトリクスを取得してプラグインを監視できます。詳細については、「[オープンソースの OpenSearch によるプラグインの監視](opensource-monitor.md)」を参照してください。