Crie uma app de recomendações personalizada

Esta página descreve como criar uma app de recomendações personalizada.

Consola

Para usar a Google Cloud consola para criar uma app de recomendações personalizada, siga estes passos:

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

    Aplicações de IA

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

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

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

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

  6. Clique em Continuar.

  7. Para estabelecer ligação a um arquivo de dados, na página Arquivos de dados, selecione um arquivo de dados que contenha dados estruturados ou opte por criar um arquivo de dados. Efetue um dos seguintes passos:

    • Selecione um arquivo de dados existente, se estiver disponível. Um arquivo de dados só pode ser anexado a uma app e não pode ser removido da app posteriormente.

    • Crie um novo repositório de dados estruturados e carregue dados para o mesmo. Para tal, clique em Criar arquivo de dados e siga os passos no painel Criar um novo arquivo de dados que é aberto. Em seguida, selecione o novo arquivo de dados. Para mais informações sobre como criar um arquivo de dados, consulte o artigo Crie um arquivo de dados de recomendações personalizado.

  8. Opcional: para ver uma lista de arquivos de dados indisponíveis, clique em Saiba porquê.

    É apresentada uma tabela com uma lista de armazenamentos de dados e o motivo pelo qual estão indisponíveis. Seguem-se alguns dos motivos pelos quais um repositório de dados pode estar indisponível:

    • O tipo de armazenamento de dados permite a ligação a apenas uma app e o armazenamento de dados já está ligado.
    • O seu repositório de dados e a sua app estão em regiões diferentes.
    • A sua loja de dados e a sua app são de tipos diferentes. Por exemplo, não pode associar um arquivo de dados multimédia a uma app de recomendações personalizada.
    • O seu arquivo de dados tem uma pesquisa básica no Website, enquanto uma app de recomendações personalizadas requer um arquivo de dados com indexação avançada do Website.

  9. Clique em Criar.

REST

Antes de usar a linha de comandos para criar uma app, tem de ter um arquivo de dados existente. Se não tiver um repositório de dados, crie um seguindo os passos em Crie um repositório de dados de recomendações personalizado.

Para usar a linha de comandos para criar uma app de recomendações, siga estes passos:

  1. Encontre o ID da loja de dados. Se já tiver o ID do armazenamento de dados, avance para o passo seguinte.

    1. Na Google Cloud consola, aceda à página Aplicações de IA e, no menu de navegação, clique em Armazenamentos de dados.

      Aceda à página Armazenamentos de dados

    2. Clique no nome do seu arquivo de dados.

    3. Na página Dados da sua loja de dados, obtenha o ID da loja de dados.

  2. Crie uma app e associe-a a um repositório de dados estruturados. Um arquivo de dados só pode ser anexado a uma app e não pode ser removido da app posteriormente.

    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 o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • APP_ID: o ID da app de recomendações que quer criar.
    • APP_DISPLAY_NAME: o nome a apresentar da app de recomendações que quer criar.
    • DATA_STORE_ID: o ID de um arquivo de dados de recomendações existente que quer adicionar à app de recomendações.

O que se segue?