Criar um app de recomendações genéricas

Esta página descreve como criar um app de recomendações genéricas.

Console

Para usar o console do Google Cloud e criar um app de recomendações genéricas, siga 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, 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 do mecanismo.

  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 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 anexado a apenas um app e não pode ser removido dele mais tarde.

    • Crie um novo repositório de dados e faça a ingestão de 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 um repositório de dados de recomendações genéricas.

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

    Uma tabela é mostrada com uma lista de repositórios de dados e o motivo de eles não estarem disponíveis. 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.
    • 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.

  9. 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.

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 do Google Cloud, acesse a página Criador de agentes 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. Um repositório de dados pode ser anexado a apenas um app e não pode ser removido dele mais tarde.

    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 que você quer adicionar ao app de recomendações.

A seguir