Campos para o processador de resposta de personalized_search_ranking
Na hora de criar um pipeline para o plug-in Classificação de pesquisas do Amazon Personalize, você especifica um processador de respostas de personalized_search_ranking com os seguintes campos.
-
campaign_arn (obrigatório) — Especifique o nome do recurso da Amazon (ARN) da campanha Amazon Personalize a ser usado para personalizar os resultados.
-
item_id_field (opcional) — Se o campo
_idde um documento indexado no OpenSearch não corresponder aos seus itemIds do Amazon Personalize, especifique o nome do campo correspondente. Por padrão, o plug-in assume que os dados de_idcorrespondem ao itemId nos seus dados do Amazon Personalize. -
recipe (obrigatório) — Especifique o nome da fórmula do Amazon Personalize a ser usada. Para usar o plug-in, você pode especificar
aws-personalized-ranking-v2ouaws-personalized-ranking. -
weight (obrigatório) — Especifique a ênfase que o processador de resposta coloca na personalização ao reclassificar os resultados. Especifique um valor no intervalo entre 0,0 – 1,0. Quanto mais próximo estiver de
1.0, maior a probabilidade de que os resultados do Amazon Personalize tenham uma classificação mais alta. Se você especificar0.0, nenhuma personalização ocorrerá, e o OpenSearch terá precedência. -
tag (opcional) — Especifique um identificador para o processador.
-
iam_role_arn (obrigatório para o OpenSearch Service, opcional para o OpenSearch de código aberto): para o OpenSearch Service, informe o nome do recurso da Amazon (ARN) do perfil que você criou ao configurar as permissões para o OpenSearch Service acessar seus recursos do Amazon Personalize. Se seus recursos do OpenSearch Service e do Amazon Personalize fizerem parte de contas diferentes, especifique o perfil que concede permissões
AssumeRolepara o OpenSearch Service. Para obter mais informações, consulte Configurar permissões quando os recursos estão em contas diferentes.Para o OpenSearch de código aberto, se você usar vários perfis para restringir permissões de diferentes grupos de usuários na sua empresa, especifique o ARN do perfil que tem permissão para acessar o Amazon Personalize. Se usar somente as credenciais da AWS no seu repositório de chaves do OpenSearch, você pode omitir esse campo.
-
aws_region (obrigatório) — A região da AWS em que você criou sua campanha do Amazon Personalize.
-
ignore_failure (opcional) — Especifique se o plug-in ignora alguma falha do processador. Para valores, especifique
trueoufalse. Para seus ambientes de produção, recomendamos que você especifiquetruepara evitar interrupções nas respostas das consultas. Para ambientes de teste, especifiquefalsepara visualizar os erros gerados pelo plug-in. -
external_account_iam_role_arn: se você usa o OpenSearch Service e seus recursos do Amazon Personalize e do OpenSearch Service fazem parte de contas diferentes, especifique o ARN do perfil que tem permissão para acessar seus recursos do Amazon Personalize. Esse perfil deve fazer parte da mesma conta dos seus recursos do Amazon Personalize. Para obter mais informações, consulte Configurar permissões quando os recursos estão em contas diferentes.
Para conferir um exemplo do código do OpenSearch Service, consulte Criar um pipeline com o Amazon OpenSearch Service. Para conferir um exemplo do OpenSearch de código aberto, consulte Criar um pipeline no OpenSearch de código aberto.