Comece a usar recomendações personalizadas

Comece a usar recomendações personalizadas

Nota: esta funcionalidade é uma oferta de pré-visualização, sujeita aos "Termos das Ofertas de Pré-DG" dos Termos Específicos do Serviço da GCP. Os produtos e as funcionalidades de pré-DG podem ter apoio técnico limitado e as alterações aos produtos e às funcionalidades de pré-DG podem não ser compatíveis com outras versões de pré-DG. Para mais informações, consulte as descrições das fases de lançamento. Além disso, ao utilizar esta funcionalidade, aceita os Termos de pré-visualização da IA generativa ("Termos de pré-visualização"). Para esta funcionalidade, pode tratar dados pessoais conforme descrito na Alteração ao Tratamento de Dados do Cloud, sujeito às restrições e obrigações aplicáveis no Contrato (conforme definido nos Termos de Pré-visualização).

Pode criar rapidamente uma app de recomendações personalizada de última geração com os seus próprios dados que pode sugerir conteúdo semelhante ao conteúdo que o utilizador está a ver atualmente.

Este tutorial explica como criar uma app de recomendações personalizada para dados estruturados. Neste caso, os dados estruturados estão no formato NDJSON carregados a partir de um contentor do Cloud Storage.

Antes de seguir este tutorial, certifique-se de que concluiu os passos em Antes de começar.

---

Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Orientar-me:

Visita guiada

---

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Vertex AI Search (Discovery Engine), Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs
Make sure that you have the following role or roles on the project: Discovery Engine Admin
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Aceder ao IAM
2. Selecione o projeto.
3. Clique em Conceder acesso.

4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

5. Na lista Selecionar uma função, selecione uma função.
6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
7. Clique em Guardar.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Vertex AI Search (Discovery Engine), Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Make sure that you have the following role or roles on the project: Discovery Engine Admin

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Aceder ao IAM
2. Selecione o projeto.
3. Clique em Conceder acesso.

4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

5. Na lista Selecionar uma função, selecione uma função.
6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
7. Clique em Guardar.

Ative o Vertex AI Search

1. Na Google Cloud consola, aceda à página Aplicações de IA.

   Aplicações de IA

2. Opcional: clique em Permitir que a Google faça uma amostragem seletiva da entrada do modelo e das respostas.

3. Clique em Continuar e ativar a API.

Crie um arquivo de dados

Este procedimento explica como criar um repositório de dados e carregar os dados de exemplo fornecidos.

1. Aceda à página Armazenamentos de dados.

2. Clique em Criar arquivo de dados.

3. Na página Selecione uma origem de dados, selecione Cloud Storage.

4. Na página Importar dados do Cloud Storage, selecione Dados estruturados (JSONL).

5. Clique em Ficheiro.

6. No campo gs://, introduza o seguinte valor:

   cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson
   

   Este contentor do Cloud Storage contém um ficheiro formatado em NDJSON de filmes disponibilizados pela Kaggle.

7. Clique em Continuar.

8. Atribua as propriedades principais da seguinte forma:

   Nome do campo	Propriedade principal
   homepage	uri
   overview	description

   Em seguida, clique em Continuar.

9. Introduza um nome a apresentar para o seu arquivo de dados e, de seguida, clique em Criar.

10. Clique no nome do arquivo de dados.

11. Na página Dados, aceda ao separador Atividade para ver o estado do carregamento de dados. A mensagem Importação concluída é apresentada na coluna Estado quando o processo de importação estiver concluído. Para este conjunto de dados, normalmente, este processo demora entre dois e três minutos. Pode ter de clicar em Atualizar para ver a mensagem Importação concluída.

12. Clique no separador Documentos para ver os documentos importados.

Crie uma app

Em seguida, cria uma app de recomendações e associa a loja de dados que criou anteriormente.

1. Aceda à página Apps.

2. Clique em Criar app.

3. Na página Criar app, em Motor de recomendações, clique em Criar.

4. No campo Nome da app, introduza um nome para a sua app. O ID da app é apresentado abaixo do nome da app.

5. Clique em Continuar.

6. Na lista de armazéns de dados, selecione o armazém de dados que criou anteriormente.

7. Clique em Criar.

Pré-visualize a sua app

1. No menu de navegação, clique em Pré-visualizar para testar a app.

2. Se vir a mensagem "Pode pré-visualizar o motor de recomendações aqui. Ainda estamos a preparar o motor. Volte a consultar mais tarde", aguarde e atualize a página periodicamente. Pode ter de aguardar algumas horas ou até ao dia seguinte para pré-visualizar os seus dados.

3. Clique no campo ID do documento. É apresentada uma lista de IDs de documentos.

4. Clique no ID do documento para o documento para o qual quer receber recomendações. Em alternativa, introduza um ID do documento no campo ID do documento.

5. Clique em Receber recomendações. É apresentada uma lista de documentos recomendados.

6. Clique num documento para ver os respetivos detalhes.

Implemente a sua app

Não existe nenhum widget de recomendações para implementar a sua app. Para testar a app antes da implementação:

1. Aceda à página Dados e copie o ID de um documento.

2. Aceda à página Integração. Esta página inclui um comando de exemplo para o método servingConfigs.recommend na API REST.

3. Cole o ID do documento que copiou anteriormente no campo ID do documento.

4. Deixe o campo User Pseudo ID tal como está.

5. Copie o pedido de exemplo e execute-o no Cloud Shell.

   Os resultados são os IDs dos documentos recomendados com base no documento que escolheu.

Para obter ajuda na integração da app de recomendações na sua app Web, consulte os exemplos de código para C#, Go, Java, Node.js, PHP e Ruby em Receba recomendações para uma app.

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

1. Para evitar custos Google Cloud desnecessários, use o Google Cloud console para eliminar o seu projeto se não precisar dele.
2. Se criou um novo projeto para saber mais sobre o Vertex AI Search e já não precisar do projeto, elimine-o.
3. Se usou um Google Cloud projeto existente, elimine os recursos que criou para evitar incorrer em cobranças na sua conta. Para mais informações, consulte o artigo Elimine uma app.
4. Siga os passos em Desative a Pesquisa do Vertex AI.

O que se segue?

• Introdução ao Vertex AI Search
• Acerca das apps e das lojas de dados