Realce e ignore recomendações de conteúdo multimédia

Esta página explica como alterar a posição de classificação das recomendações de multimédia devolvidas pelo modelo através dos controlos de publicação de aumentos (também denominados controlos).

Um controlo de aumento altera a ordem das recomendações depois de o modelo as ter devolvido. Aplica uma expressão de filtro aos resultados para identificar as recomendações que quer aumentar ou ocultar e, em seguida, aplica um valor de aumento entre -1 e +1. Um valor de aumento de +1 dá o maior aumento a uma recomendação, colocando-a na parte superior das recomendações devolvidas. Um valor de -1 oculta a recomendação na parte inferior da lista de recomendações devolvidas.

O aumento é um controlo de tempo de publicação. Primeiro, o modelo de recomendações devolve uma lista de recomendações. Usando uma configuração de publicação, o controlo de aumento é aplicado a essa lista para ajustar a classificação das recomendações. O controlo de aumento não adiciona nem elimina recomendações, mas controla a ordem pela qual as recomendações são apresentadas ao utilizador.

Recomendações de aumento versus filtragem

O efeito Aumentar é um filtro suave. Por outro lado, o filtro normal para recomendações, descrito em Filtrar recomendações, é um filtro rígido.

Se aplicar um filtro rígido às recomendações, nunca verá os documentos que foram filtrados. No entanto, com um filtro flexível, não remove documentos da lista de recomendações. Em alternativa, o filtro é usado para determinar que documentos devem estar mais acima ou mais abaixo na lista de recomendações devolvidas.

Evite sobrecarregar o modelo de recomendações

Ao aplicar um filtro de aumento ou ocultação, recomendamos valores pequenos próximos de zero. Os valores próximos de +1 ou -1 têm probabilidade de sobrecarregar o modelo de recomendações, pelo que a classificação das recomendações aplicada pelo modelo não se reflete na ordem em que o utilizador vê as recomendações.

Por exemplo, se aumentar a visibilidade de filmes de animação com +1, os utilizadores só veriam filmes de animação na parte superior da lista de recomendações. Isto faria com que os filmes que não são de animação, mas que foram altamente recomendados pelo modelo, fossem apresentados na parte inferior da lista, onde o utilizador pode não os ver.

Despromoção versus ocultação

A diminuição da classificação e a ocultação movem as recomendações para posições inferiores na lista de recomendações devolvidas, em comparação com a posição que teriam de outra forma.

No entanto, a rebaixamento baseia-se na idade do conteúdo ou no facto de o utilizador já ter visto parte do conteúdo. Para mais informações sobre a despromoção, consulte o artigo Despromova recomendações de conteúdo multimédia.

A ação de ocultar aplica-se a conteúdo identificado por um filtro. O filtro pode ser qualquer campo de dados marcado como filtrável no esquema. Para informações gerais sobre os filtros de recomendações, incluindo como marcar um campo como filtrável, consulte o artigo Filtre recomendações.

Acerca dos controlos de aumento e das configurações de publicação

Cada controlo de publicação de aumento é composto por um filtro e um valor de aumento. Por exemplo, um controlo de aumento aumenta os filmes com "Natal" no título com um valor de 0.1 e outro oculta os filmes de terror com um valor de -0.2.

Depois de criar um ou mais controlos de aumento, associa os controlos a uma configuração de publicação. Quando é criada uma app do Vertex AI Search, também é criada automaticamente uma configuração de publicação predefinida. A configuração de publicação é referenciada no momento da publicação para determinar os resultados que a app gera. Além dos controlos de aumento, a configuração de publicação pode conter outros tipos de controlos, como os controlos diversify e demote.

A configuração de publicação pode ser aplicada quando chama o método recommend. Em seguida, todos os controlos na configuração de publicação são aplicados às recomendações devolvidas pela chamada do método.

Além disso, pode ter várias configurações de publicação associadas à sua app. Isto permite-lhe aplicar diferentes conjuntos de controlos em diferentes circunstâncias. Por exemplo, se o pedido de recomendação for proveniente da conta de uma criança, realce os filmes em categorias adequadas para crianças e oculte os filmes inadequados. Da mesma forma, se o pedido for feito a partir de uma conta marcada como adulta, realce títulos ou categorias populares entre adultos. Em alternativa, pode optar por ter configurações de publicação diferentes para diferentes localizações geográficas e aumentar o conteúdo de acordo com o que é popular a nível regional. Para mais informações sobre as configurações de publicação, consulte o artigo Crie e faça a gestão de configurações de publicação de conteúdo multimédia.

Os valores de aumento são cumulativos

Se tiver anexado vários controlos de publicação a uma configuração de publicação, os aumentos e as ocultações tornam-se aditivos.

Por exemplo, se aumentar os filmes de animação para crianças em 0,3 e os filmes de aventura de animação em 0,4, um filme categorizado como um filme de aventura de animação para crianças é aumentado em 0,7.

Da mesma forma, se um filme de terror fosse aumentado em 0,2 por um controlo e diminuído em -0,3 por outro controlo na mesma configuração de publicação, o resultado líquido seria diminuir o filme em -0,1.

A soma dos aumentos pode exceder +1. Por exemplo, se os controlos aumentassem os filmes de animação para crianças em 0,6 e os filmes de aventura de animação em 0,5, um filme de aventura de animação para crianças seria aumentado em +1,1.

Exemplos de filtros

Seguem-se alguns exemplos de filtros para recomendações de conteúdo multimédia.

Filtros em propriedades de chaves comuns

Exemplos de filtros em propriedades de strings de chaves comuns (category, image_name, image_uri, language, title e uri).

• Animações para crianças:
  "filter": "categories: ANY(\"animation\") AND categories: ANY(\"children\")"

• Conteúdo multimédia assustador:
  "filter": "categories: ANY(\"horror\", \"thriller\", \"crime\")

• Conteúdo multimédia cujo título é "Natal":
  "filter": "title: ANY(\"Christmas\")"

• Conteúdo multimédia em que o primeiro item na matriz images tem o valor name "beach ball":
  "filter": "images[0].name: ANY(\"beach ball\")"

Filtros nas propriedades das teclas multimédia

Exemplos de filtros em propriedades de chaves multimédia. As propriedades das chaves multimédia começam com media_ e, na sintaxe do filtro, o nome do campo é precedido por media_key_properties.. Para ver uma lista de propriedades de teclas multimédia, consulte o artigo Esquema predefinido da Google versus esquema personalizado.

• Conteúdo multimédia em que o tipo é audio:
  "filter": "media_key_properties.media_type: ANY(\"audio\")"

• Conteúdo multimédia em que a matriz hash_tags contém uma string #winter:
  "filter": "media_key_properties.hash_tags: ANY(\"#winter\")"

• Ficheiros multimédia em que o primeiro elemento da matriz hash_tags é a string #winter:
  "filter": "media_key_properties.hash_tags[0]: ANY(\"#winter\")"

Campos personalizados

Exemplos de filtros em campos personalizados. Para atributos personalizados, preceda o nome do campo com attributes..

• Tem um campo de string personalizado, festival, no seu esquema para representar em que festival de cinema um filme foi apresentado pela primeira vez. Para filtrar apenas os filmes que estrearam em Cannes:
  "filter": "attributes.festival: ANY(\"Cannes\")

• Tem um campo booleano personalizado, audio_desc, que é verdadeiro quando o conteúdo multimédia inclui uma descrição áudio para visitantes com deficiência visual. Para filtrar conteúdo multimédia com uma descrição de áudio:
  "filter": "attributes.audio_desc: ANY(true)"

Limitações nos campos filtráveis

As seguintes limitações aplicam-se aos controlos de publicação de aumentos:

• Só é possível usar campos de propriedades dos tipos string e booleano em expressões de filtro para o aumento.

• Não é possível filtrar campos aninhados com mais de um nível. Por exemplo, pode filtrar por persons.name, mas não pode filtrar por um campo persons.name.stage (mesmo que esse campo existisse).

• Os filtros têm de ser correspondências exatas. Isto significa que, nos exemplos, não seria feito um aumento de um filme chamado "Christmas Story" ou "CHRISTMAS".

Antes de começar

• Certifique-se de que criou uma app de recomendações de multimédia e um arquivo de dados. Para mais informações, consulte o artigo Crie uma app de recomendações de multimédia e uma loja de dados.

• Opcional: se não quiser usar a configuração de publicação predefinida, crie uma nova configuração de publicação seguindo os passos 1 a 5 e 7 em Crie uma configuração de publicação. Se a sua app estiver em produção, a Google recomenda que crie uma configuração de publicação separada para testar os controlos de aumento antes de aplicar os controlos à configuração de publicação de produção.

• Certifique-se de que todos os campos que quer usar no controlo do aumento estão marcados como Filtráveis no esquema. Para mais informações, consulte o artigo Configure as definições dos campos. Consulte também os limites de filtragem.

Realce ou ignore recomendações

Este procedimento descreve como criar controlos de aumento e anexar os controlos a uma configuração de publicação.

Depois de os controlos serem anexados à configuração de publicação, pode especificar a configuração de publicação quando chamar o método servingConfigs.recommend, e o controlo de aumento será usado para influenciar a ordem das recomendações devolvidas.

Atualize o controlo de aumento

Este procedimento descreve como atualizar um controlo de aumento existente para alterar o valor do aumento ou o filtro.

Depois de testar o controlo de aumento, pode descobrir que quer tornar o aumento mais forte ou mais fraco. Em alternativa, pode alterar a string do filtro.

Quando atualiza um valor de aumento ou um filtro, chama o método engines.controls.patch.

O método patch substitui os valores de boost e filter pelos novos valores que fornecer. Este procedimento mostra como editar o valor boost (passo 3) e o valor filter (passo 4) separadamente. No entanto, se quiser editar ambos, pode fazê-lo num único comando curl.

Elimine um controlo de aumento

Este procedimento descreve como eliminar um controlo de aumento. Se não estiver a usar um controlo de aumento, a prática recomendada é eliminá-lo para não atingir nem exceder a quota do número de controlos permitidos.

Quando elimina um controlo de aumento, chama o método engines.controls.delete.

Não é possível eliminar os controlos de aumento associados a uma configuração de publicação. Se tentar eliminar um controlo de aumento, recebe uma mensagem de erro com o nome da configuração de publicação. Em seguida, tem de eliminar essa configuração de publicação ou desassociar esse controlo da configuração de publicação.

Atualize uma configuração de publicação para remover um controlo de aumento

Antes de poder eliminar um controlo de aumento, tem de o desassociar de todos os controlos de publicação. Para tal, corrija os controlos de publicação para remover o ID do controlo de aumento.

Para desanexar os controlos de aumento de uma configuração de publicação, siga estes passos:

1. Descubra que controlos de aumento estão anexados à configuração de publicação fazendo um pedido engines.servingConfigs.get e consultando o campo boostControlIds na resposta.

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID"
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .

   • APP_ID: o ID da app Vertex AI Search.

   • CONFIG_ID: o ID da configuração de publicação sobre a qual quer saber mais.

   Exemplo de comando e resultado

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id"
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "createTime": "2024-11-22T23:54:45.613178Z",
     "updateTime": "2024-11-26T20:28:11.967439Z",
     "boostControlIds": [
       "boost-kids",
       "bury-horror"
     ]
   }
   

   Este comando apresenta informações sobre a configuração de publicação my_app-1234567_id, em particular, mostra que a configuração de publicação tem dois controlos de aumento associados: boost-kids e bury-horror.

2. Para atualizar a configuração de publicação de anúncios de modo a remover um controlo de aumento, use o método engines.servingConfigs.patch.

   curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["CONTROL_ID"]
   }'
   

   Substitua o seguinte:

   • CONFIG_ID: o ID da configuração de publicação à qual quer anexar os controlos de aumento, por exemplo, my_app-1234567_id. Consulte o passo anterior.

   • CONTROL_ID: contém os IDs de um ou mais dos controlos de aumento que quer que a configuração de publicação tenha. Certifique-se de que omite todos os controlos de aumento que quer eliminar. Esta é uma matriz de strings. Se tiver mais do que um ID, não se esqueça de usar aspas e vírgulas para os separar. Por exemplo, boost-1", "boost-2.

   Exemplo de comando e resultado: deixa um controlo

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
     "boostControlIds": ["bury-horror"]
   }'
   

   {
     "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
     "displayName": "jane-day-test-serving-config-for-boost-bury",
     "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
     "modelId": "my-app",
     "diversityLevel": "no-diversity",
     "diversityType": "RULE_BASED_DIVERSITY",
     "mediaConfig": {},
     "boostControlIds": [
       "bury-horror"
     ]
   }
   

   Este comando mantém o controlo de aumento do bury-horror anexado à configuração de publicação e remove o controlo do boost-kids. Partindo do princípio de que boost-kids não está associado a nenhuma outra configuração de publicação, já pode ser eliminado. Consulte Elimine um controlo de aumento.

   Exemplo de comando e resultado: remove todos os controlos

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
   "boostControlIds": []
   }'
   

   {
   "name": "projects/123456/locations/global/collections/default_collection/engines/my-app/servingConfigs/my_app-1234567_id",
   "displayName": "jane-day-test-serving-config-for-boost-bury",
   "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
   "modelId": "my-app",
   "diversityLevel": "no-diversity",
   "diversityType": "RULE_BASED_DIVERSITY",
   "mediaConfig": {}
   }
   

   Este comando remove todos os controlos de aumento da configuração de publicação, my_app-1234567_id