As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Como personalizar os resultados da pesquisa do OpenSearch Você pode usar o Amazon Personalize para personalizar os resultados do OpenSearch de código aberto ou do Amazon OpenSearch Service para os usuários. O [OpenSearch](https://opensearch.org/docs/latest) é um serviço autogerenciado de pesquisa de código aberto elaborado com base na Licença Apache 2.0. Use o serviço gerenciado [Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/what-is.html) para implantar, operar e expandir em grande escala os clusters do OpenSearch na Nuvem AWS. Quando você usa o Amazon OpenSearch Service, o OpenSearch traz e classifica os resultados. Ao classificar os resultados da consulta, o OpenSearch usa uma estrutura de classificação probabilística chamada [BM-25](https://en.wikipedia.org/wiki/Okapi_BM25) para calcular as pontuações de relevância. Se determinada palavra-chave aparece com mais frequência em um documento, o BM-25 atribui ao documento uma pontuação por relevância maior. O ranking do OpenSearch não leva em conta traços do comportamento do usuário, como dados de cliques, por exemplo. Quando você usa o Amazon Personalize com o OpenSearch, o Amazon Personalize reclassifica os resultados do OpenSearch com base no histórico do comportamento do usuário e em qualquer metadado sobre os itens ou sobre o usuário. O OpenSearch incorpora a nova classificação antes de trazer a resposta da pesquisa ao seu aplicativo. Você controla a importância que o OpenSearch atribui à classificação do Amazon Personalize na hora de usar com os resultados do OpenSearch. Com essa reclassificação, o usuário recebe resultados mais interessantes e relevantes. Isso aumenta as taxa de cliques e de conversões do seu app. Acesse [Exemplos de casos de uso](#opensearch-use-case-example) para ver um exemplo de caso de uso mostrando como a pesquisa personalizada melhora os resultados de um aplicativo de comércio eletrônico. Antes de começar a personalizar os resultados do OpenSearch, acesse e confira a lista dos requisitos [Requisitos do plug-in Classificação de pesquisas do Amazon Personalize](plugin-requirements.md). **Topics** + [Exemplos de casos de uso](#opensearch-use-case-example) + [Como funciona o plug-in Classificação de pesquisas do Amazon Personalize](#opensearch-plugin-how-it-works) + [Mais informações](#open-search-plugin-additional-info) + [Requisitos do plug-in Classificação de pesquisas do Amazon Personalize](plugin-requirements.md) + [Personalização de resultados do Amazon OpenSearch Service com o Amazon Personalize](opensearch-service.md) + [Personalizar os resultados do OpenSearch de código aberto com o Amazon Personalize](opensearch-open-source.md) + [Campos para o processador de resposta de `personalized_search_ranking`](opensearch-plugin-pipeline-fields.md) + [Exemplo de métricas do pipeline](monitor-response.md) ## Exemplos de casos de uso Quando você usa o Amazon Personalize para reclassificar os resultados do OpenSearch, a pesquisa trará resultados mais relevantes para seus usuários. Exemplo: você tem aplicativo de comércio eletrônico para vender carros. Se o usuário fizer uma busca por carros da Toyota e você não personalizar os resultados, o OpenSearch retornará uma lista de carros feita pela Toyota com base nas palavras-chave nos seus dados. A classificação dessa lista seria a mesma para todos os usuários. Mas, se você usar o Amazon Personalize para personalizar os resultados, o OpenSearch reclassifica os carros em ordem de relevância e de maneira específica para as pessoas com base no comportamento pessoal, como cliques. O carro em que o usuário tem mais probabilidade de clicar aparece em primeiro lugar. Se optar por personalizar os resultados do OpenSearch, você poderá controlar a ênfase que o OpenSearch atribui à classificação do Amazon Personalize. Continuando com este exemplo, se um usuário pesquisar um tipo específico de carro de determinado ano (como um Toyota Prius 2008), talvez você opte por usar mais à classificação original do OpenSearch. No entanto, para buscas mais genéricas que trazem vários resultados variados, como uma pesquisa por todos os veículos Toyota, contar com a personalização é uma ótima opção. Nesse caso, os carros que aparecem no topo da lista são os mais relevantes para o usuário em particular. ## Como funciona o plug-in Classificação de pesquisas do Amazon Personalize Confia no diagrama abaixo como funciona o plug-in Classificação de pesquisas do Amazon Personalize. ![Descreve como o plug-in funciona quando você o usa para personalizar os resultados do OpenSearch.](http://docs.aws.amazon.com/pt_br/personalize/latest/dg/images/opensearch-plugin-how-it-works.png) 1. Você envia a consulta do cliente ao domínio do OpenSearch Service ou ao cluster do OpenSearch de código aberto. 1. O OpenSearch envia a resposta da consulta (lista de itens que são relevantes para a consulta) e o ID do usuário ao plug-in Classificação de pesquisas do Amazon Personalize. 1. O plug-in envia os itens e o usuário em resposta à sua campanha do Amazon Personalize para classificação. Ele usa os valores de fórmula e campanha do nome do recurso da Amazon (ARN) no seu pipeline de pesquisa para fazer uma classificação personalizada para o usuário. Ele usa a operação da API GetPersonalizedRanking para recomendações. Na solicitação, ele passa o userId do usuário que está fazendo a consulta e os itens retornados da consulta do OpenSearch na `inputList`. 1. O Amazon Personalize traz os resultados reclassificados para o plug-in. 1. O plug-in reorganiza e traz os resultados da pesquisa para seu domínio do OpenSearch Service ou do cluster do OpenSearch de código aberto. Ele reclassifica os resultados com base na resposta da sua campanha do Amazon Personalize e na ênfase na personalização que você configurar. 1. Seu cluster do OpenSearch de código aberto ou o domínio do OpenSearch Service traz os resultados finais para seu aplicativo. ## Mais informações Os recursos a seguir contêm mais informações sobre o uso do OpenSearch. + Para mais informações sobre os conceitos básicos do OpenSearch de código aberto, consulte [Início rápido](https://opensearch.org/docs/quickstart). + Para instruções, consulte [Conceitos básicos sobre o Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/gsg.html) no *Guia do desenvolvedor do Amazon OpenSearch Service*. + Para informações sobre a fórmula de classificação personalizada no Amazon Personalize, consulte [Fórmula Personalized-Ranking-v2](native-recipe-personalized-ranking-v2.md) ou [Fórmulas de classificações personalizadas](native-recipe-search.md).