Criar um app de recomendações genéricas

Nesta página, descrevemos como criar um app de recomendações genéricas.

Console

Para usar o console do Google Cloud para criar um app de recomendações genéricas, siga as instruções abaixo. estas etapas:

  1. No Console do Google Cloud, acesse a página Criador de agentes.

    Agent Builder.

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

  3. Na página Criar app, selecione Recomendações.

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

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

  6. Em Conteúdo, verifique se Genérico está selecionado.

  7. Clique em Continuar.

  8. Para se conectar a um repositório de dados, na página Repositórios de dados, selecione um repositório que você criou anteriormente ou crie um novo repositório. Escolha uma destas opções:

    • Selecione um repositório de dados, se disponível. Um repositório de dados pode ser anexada a apenas um app e não pode ser removida dele depois.

    • Criar um novo repositório de dados e ingerir dados nele. Para isso, clique em Criar repositório de dados e siga as etapas no painel Criar um novo repositório de dados que é aberto. Em seguida, selecione o novo repositório de dados. Para mais informações sobre como criar um repositório de dados, consulte Criar dados genéricos de recomendações Store.

  9. 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 a razão pela qual eles são indisponível. Estes são alguns dos motivos pelos quais um repositório de dados pode ser indisponível:

    • O tipo de repositório de dados permite a conexão com apenas um app, e o repositório já está conectado.
    • O repositório de dados e o app estão em regiões diferentes.
    • O repositório de dados e o 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 genéricas.
    • Seu repositório de dados tem pesquisa básica no site, enquanto um app genérico de recomendações exige um repositório de dados com indexação avançada de sites.

  10. Clique em Criar.

REST

Antes de usar a linha de comando para criar um app, é necessário ter um armazenamento de dados. Se você não tiver um repositório de dados, siga as etapas em Criar um repositório de dados de recomendações genéricas.

Se quiser usar a linha de comando para criar um app de recomendações, siga estas etapas:

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

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

      Acessar 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. 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 projeto do Google Cloud.
    • 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 atual. que você quer adicionar ao app de recomendações.

A seguir