Configurando o código aberto OpenSearch

Depois de concluir o fluxo de trabalho do Amazon Personalize e atender aos requisitos listados em Diretrizes e requisitos, você poderá configurar em código aberto e instalar o plug-in Classificação de pesquisas do Amazon Personalize.

Se você já tiver um OpenSearch cluster em execução, poderá instalar o plug-in manualmente. Se você não tiver um cluster em execução, poderá instalar o OpenSearch plug-in do zero com um script bash.

Instalando manualmente o plug-in em um OpenSearch cluster existente

Se você já tiver um OpenSearch cluster, poderá instalar manualmente o plug-in em seu cluster diretamente do OpenSearch GitHub repositório.

Instalar o plug-in manualmente

1. Use o comando a seguir para iniciar seu OpenSearch cluster:

   bin/opensearch

2. Se você ainda não fez isso, faça o upload dos dados do catálogo para o OpenSearch cluster. Ao carregar seus dados, você cria um OpenSearch índice e define seus mapeamentos de campo. Depois, você faz o upload dos dados para esse índice. Para ver um exemplo, consulte Criar um índice e mapeamentos de campo usando dados de amostra.

3. Use o comando a seguir para instalar o plug-in:

   bin/opensearch-plugin install https://github.com/opensearch-project/search-processor/releases/download/2.9.0/opensearch-search-processor-2.9.0.0.zip

   Para saber mais sobre como instalar plug-ins, consulte Instalar plug-ins.

Depois de instalar o plug-in Classificação de pesquisas do Amazon Personalize, será hora de configurá-lo. Para isso, é preciso criar um pipeline de pesquisa e especificar um processador de resposta de personalized_search_ranking. Para ter mais informações, consulte Como configurar o plug-in.

Como configurar seu cluster e instalar o plug-in com um script de início rápido

Se você não criou um OpenSearch cluster, pode usar um script bash de início rápido para criar um. Esse script configura um OpenSearch cluster em um contêiner Docker, configura credenciais usando seu AWS perfil padrão e instala o plug-in Amazon Personalize Search Ranking.

Para obter informações sobre como criar manualmente um OpenSearch cluster, consulte as instruções de início rápido na OpenSearch documentação.

Instalar o plug-in com um script em bash de início rápido

1. Antes de executar o script, baixe e instale o Docker Desktop na versão para seu sistema operacional.

2. Baixe o script bash de início rápido em. GitHub

3. No diretório de trabalho, execute o script com o comando abaixo.

   sh personalized_search_ranking_quickstart.sh

   Com esse comando, o script usa as credenciais em seu AWS perfil padrão. Para fornecer um perfil alternativo, use o argumento --profile.

   sh personalized_search_ranking_quickstart.sh --profile profile-name

   Depois de rodar o script, você consegue encontrar mais informações sobre o script no arquivo README, que está no diretório exclusivo criado pelo script. Esse diretório armazena os arquivos Dockerfile e .yml compostos por docker que o script usa. Por exemplo: ../opensearch-personalize-intelligent-ranking-docker.1234/README.

4. Faça upload dos dados do seu catálogo para o seu OpenSearch cluster. Ao carregar seus dados, você cria um OpenSearch índice e define seus mapeamentos de campo. Depois, você faz o upload dos dados para esse índice. Para ver um exemplo, consulte Criar um índice e mapeamentos de campo usando dados de amostra.

Depois de configurar OpenSearch e instalar o plug-in Amazon Personalize Search Ranking, você estará pronto para configurá-lo. Para isso, é preciso criar um pipeline de pesquisa e especificar um processador de resposta de personalized_search_ranking. Para ter mais informações, consulte Como configurar o plug-in.