Criar um app de recomendações personalizado

Console

Para usar o console Google Cloud e criar um app de recomendações personalizado, siga estas etapas:

1. No console Google Cloud , acesse a página Aplicativos de IA.

   Aplicativos de IA

2. Na página Apps, clique em Criar app.

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

4. No campo Nome do app, insira um nome para seu app. O ID do app aparece abaixo do nome dele.

5. Opcional: clique em Editar para editar o ID do app.

6. Clique em Continuar.

7. Para se conectar a um repositório de dados, na página Repositórios de dados, selecione um repositório que contenha dados estruturados ou crie um. Escolha uma destas opções:

   • Selecione um repositório de dados disponível. Um repositório de dados só pode ser anexado a um app e não pode ser removido dele depois.

   • Crie um repositório de dados estruturados e ingira dados nele. Para fazer isso, clique em Criar repositório de dados e siga as etapas no painel Criar um novo repositório de dados que será aberto. Em seguida, selecione o novo repositório de dados. Para mais informações sobre como criar um repositório de dados, consulte Criar um repositório de dados de recomendações personalizadas.

8. Opcional: para conferir uma lista de repositórios de dados indisponíveis, clique em Saiba por quê.

   Uma tabela é exibida com uma lista de repositórios de dados e o motivo da indisponibilidade. Confira alguns motivos pelos quais um repositório de dados pode estar indisponível:

   • O tipo de repositório de dados permite a conexão com apenas um app, e o repositório já está conectado.
   • Seu repositório de dados e seu app estão em regiões diferentes.
   • Seu repositório de dados e seu app são de tipos diferentes. Por exemplo, não é possível conectar um repositório de dados de mídia a um app de recomendações personalizadas.
   • Seu repositório de dados tem pesquisa básica de sites, enquanto um app de recomendações personalizadas exige um repositório com indexação avançada de sites.

9. Clique em Criar.

REST

Antes de usar a linha de comando para criar um app, você precisa ter um repositório de dados. Se você não tiver um repositório de dados, crie um seguindo as etapas em Criar um repositório de dados de recomendações personalizado.

Para usar a linha de comando e criar um app de recomendações, siga estas etapas:

1. Encontre o ID do repositório de dados. Se você já tiver o ID do repositório de dados, pule para a próxima etapa.

   1. No console Google Cloud , acesse a página Aplicativos de IA e, no menu de navegação, clique em Repositórios de dados.

      Acesse a página "Repositórios de dados"

   2. Clique no nome do seu repositório de dados.

   3. Na página Dados do seu repositório de dados, encontre o ID do repositório.

2. Crie um app e conecte-o a um repositório de dados estruturados. Um repositório de dados pode ser anexado a apenas um app e não pode ser removido dele depois.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
   -d '{
     "displayName": "APP_DISPLAY_NAME",
     "dataStoreIds": ["DATA_STORE_ID"],
     "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"],
     "similarDocumentsConfig": {}
   }'
   

   Substitua:

   • PROJECT_ID: o ID do seu Google Cloud projeto.
   • APP_ID: o ID do app de recomendações que você quer criar.
   • APP_DISPLAY_NAME: o nome de exibição do app de recomendações que você quer criar.
   • DATA_STORE_ID: o ID de um repositório de dados de recomendações que você quer adicionar ao app de recomendações.