기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Personalize Search Ranking 플러그인을 오픈 소스 OpenSearch의 쿼리에 적용
<a name="opensource-apply-plugin"></a>

Personalize 검색 순위 플러그인을 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를 지정합니다. 이 사용자는 Personalize 솔루션 버전을 생성하는 데 사용한 데이터에 포함되어 있어야 합니다. 사용자가 없는 경우 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 대시보드를 사용하여 OpenSearch 결과를 플러그인으로 순위가 다시 매겨진 결과와 비교하면 결과 순위가 어떻게 재조정되는지 이해할 수 있습니다. 자세한 내용은 [개인화된 OpenSearch 결과와 개인화되지 않은 결과 비교](opensource-comparing-results.md) 섹션을 참조하세요.

 OpenSearch 쿼리에 플러그인을 적용하면 OpenSearch 파이프라인에 대한 지표를 가져와서 플러그인을 모니터링할 수 있습니다. 자세한 내용은 [오픈 소스 OpenSearch를 사용하여 플러그인 모니터링](opensource-monitor.md) 섹션을 참조하세요.