FAQ sobre contas do Intelligent Recommendations
Este artigo fornece respostas a perguntas ou problemas comuns que poderão ocorrer durante a utilização do Intelligent Recommendations.
Conteúdo
- Manutenção da Conta
- Como crio uma conta do Intelligent Recommendations?
- Como crio recursos de modelação e entrega?
- Como contacto a equipa de suporte?
- Onde posso encontrar o URL do ponto de entrega?
- O meu contrato de dados tem erros. O que significam?
- Como posso ver os registos de erros da minha instância de modelação?
- Por que é que não consigo ver os meus registos escritos na pasta de registos?
- O que acontece se eu configurar mal o carimbo de data/hora de data?
- Os meus ficheiros Model.JSON/CSVs não estão a ser lidos corretamente?
- Qual é a abordagem recomendada para atualizar os meus dados de entrada corretamente?
- Resultados da API e Registo de erros
- Como posso verificar se sou um utilizador autorizado para fazer pedidos à API?
- O pedido falhou, mas o URL está correto?
- Acabei de criar uma conta, mas não estou a ver resultados?
- Como posso monitorizar o estado de um modelo na minha conta de IR?
- Onde estão os meus ficheiros de registo ou porque é que estão vazios?
- Porque é que apenas determinados produtos ou determinadas listas não devolvem resultados?
- O que devo fazer se os meus resultados de mais populares estiverem vazios?
- O que devo fazer se os meus resultados de "seleções para si" estiverem vazios?
- Porque é que não vejo recomendações de aspetos semelhantes?
- Onde posso encontrar a lista completa de códigos de estado da API?
- Que parâmetros suporta o Intelligent Recommendations para monitorizar pedidos de API?
Manutenção da conta
Esta secção destina-se a perguntas relacionadas com a configuração ou a manutenção de contas do Intelligent Recommendations.
Como crio uma conta do Intelligent Recommendations?
Para mais passos sobre como configurar a sua conta, aceda a Descrição geral da configuração.
Como crio recursos de modelação e entrega?
Para mais passos sobre como criar modelos e entregar recursos, consulte o passo 5 do guia de início rápido da criação de contas.
Como contacto a equipa de suporte do Intelligent Recommendations?
Para perguntas ou problemas não respondidos, poderá contactar a equipa de suporte do Intelligent Recommendations criando uma pedido de suporte no portal do Microsoft Azure.
- No menu esquerdo, selecione Ajuda + suporte.
- Selecione Criar um novo pedido de suporte.
- Conclua o formulário. É criado um pedido de suporte.
Onde posso encontrar o URL do ponto final de entrega?
Para passos sobre como localizar o URL do Ponto Final de Entrega, aceda à sua conta do Intelligent Recommendations no portal do Azure e pesquise pelo Recurso do Ponto Final que pretende utilizar. A partir daí, pode copiar o ponto final do URL de entrega. Para mais informações, aceda ao guia de início rápido para ver resultados de recomendações.
Como resolver erros no contrato de dados?
Para compreender os registos de erros a ser devolvidos no contrato de dados, aceda a Tipos de erros.
Como posso ver os registos de erros da minha instância de modelação?
Para ver os registos de erros da instância de modelação, configure a sua conta para ativar a modelação de erros. Para mais informações, aceda a Configurar o registo de erros. Para mais informações sobre os tipos de erros que podem ser devolvidos, aceda a Tipos de erros.
Por que é que não consigo ver os meus registos escritos na pasta de registos?
Se não conseguir ver quaisquer registos escritos na pasta de registos dedicada, poderá verificar se a sua conta de IR tem acesso para escrever no contentor relevante:
- Aceda à sua conta do Intelligent Recommendations.
- Selecione o separador Relatórios.
- Clique no botão "Verificar Acesso"
- Se a mensagem devolvida indicar que "A configuração para aceder à conta de armazenamento está em falta", é necessário conceder permissões de escrita para aceder ao contentor associado. Se a mensagem devolvida indicar que "A conta de armazenamento pedida não existe ou não tem permissões", certifique-se de que o URL indicado está correto.
O que acontece se eu configurar mal o carimbo de data/hora de data?
Se estiver a ter problemas com os seus carimbos de dada/hora, o produto é removido da lista de candidatos disponíveis e filtrado para fora das recomendações. Para corrigir este problema, comece por verificar as entradas da entidade de dados ItemsAndVariants e certifique-se de que a data de lançamento está no formato de data-hora suportado (que é "yyyy-MM-ddTHH: mm:ss.fffZ").
Problemas com a leitura de CSVs do model.json
Abrir os CSVs no Excel, ou em qualquer outra ferramenta compatível com CSV, poderá remover colunas vazias que são obrigatórias no formato CSV para Entidades de Dados. Sugerimos a abertura e a verificação dos seus CSVs no Bloco de Notas ou numa aplicação relacionada que não modifique o conteúdo.
Qual é a abordagem recomendada para atualizar os meus dados de entrada corretamente?
Se tentar modelar e atualizar os dados de entrada ao mesmo tempo, por vezes, poderá levar à modelação de dados de versões de dados mistas e resultados de recomendações indesejáveis. Consulte o nosso Guia de Melhores Práticas para obter mais informações sobre como atualizar os dados de entrada corretamente.
Resultados da API e registo de erros
Esta secção destina-se a perguntas relacionadas com os resultados da API ou com a documentação dos registos de erros.
Como posso verificar se sou um utilizador autorizado para fazer pedidos à API?
Os utilizadores têm de ser adicionados à lista de utilizadores autorizados para um recurso de ponto final antes de poderem chamar o serviço com êxito. Para mais informações sobre como verificar o estado de utilizadores autorizados, aceda ao passo 2 do guia de início rápido para construir pedidos de API.
O pedido falhou, mas o URL está correto.
Se o URL estiver correto, é possível que o utilizador que está a criar o pedido não se encontra na lista de utilizadores autorizados para este recurso de ponto final.
Para mais informações sobre como verificar o estado de utilizadores autorizados, aceda ao passo 2 do guia de início rápido para construir pedidos de API.
Acabei de criar uma conta, mas não estou a ver resultados.
Se tiver acabado de começar, o serviço demora algum tempo até que os resultados estejam disponíveis. Pode monitorizar o estado da modelação de cada um dos modelos que criou. Para obter mais informações, consulte o nosso Guia de Relatórios de Estado de Modelação.
Também pode ver a pasta de registos para ficar a saber sobre quaisquer problemas com o contrato de dados e se necessita de efetuar alterações ou correções.
Se ainda não conseguir ver resultados, certifique-se de que deu à conta Intelligent Recommendations uma permissão para ler os dados do contentor relevante:
- Aceda à sua conta do Intelligent Recommendations.
- Selecione o separador "Modelação".
- Escolha o componente de modelação relevante.
- Selecione o separador "Cadeia de Ligação".
- Clique no botão "Verificar Acesso".
- Se a mensagem devolvida indicar que "A configuração para aceder à conta de armazenamento está em falta", é necessário conceder permissões de leitura para aceder ao contentor associado. Se a mensagem devolvida indicar que "A conta de armazenamento pedida não existe ou não tem permissões", certifique-se de que o URL indicado está correto.
Além disso, verifique se as pastas e os ficheiros corretos estão colocados na conta de armazenamento. Para mais informações, consulte Transferir o ficheiro model.json e configurar a pasta raiz.
Como posso monitorizar o estado de modelação?
Os clientes do Intelligent Recommendations podem monitorizar o estado de modelação para cada um dos modelos criados nas suas contas. Depois de configurar um modelo, o serviço irá criar periodicamente um ficheiro de registo do estado para reportar o estado atual de todos os algoritmos (para o seu escalão de modelação). Para saber mais sobre como aceder a estes registos, consulte o Guia de Relatórios de Estado de Modelação.
Onde estão os meus ficheiros de registo ou porque é que estão vazios?
Os ficheiros de registos poderão estar vazios se não tiver concedido as permissões de Contribuidor de Dados de Blobs de Armazenamento corretas ou apontadas para a cadeia de ligação incorreta. Para confirmar, siga o nosso guia de início rápido.
Certifique-se também de que os seus ficheiros de registo de erros foram configurados corretamente e verifique se a cadeia de ligação para a instância de modelação aponta para a pasta que contém os seus ficheiros de registo.
Porque é que apenas determinados produtos ou determinadas listas não devolvem resultados?
Em geral, as interações insuficientes para um determinado item ou utilizador podem a afetar a qualidade dos resultados ou a falta de resultados a ser devolvidos. Por vezes, os produtos novos também necessitam de algum tempo para adquirir sinais antes de aparecerem em determinadas listas de recomendações. Pode analisar melhor o desempenho do seu produto utilizando os dashboards.
O que devo fazer se os meus resultados de mais populares estiverem vazios?
A API de lista de mais populares considera a idade de um produto e as respetivas contagens de interações quando classifica (ordena) cada item na lista.
Comece por contar o número de interações numa janela de tempo definida e, em seguida, o nosso modelo considera a idade do produto (dias desde a data de lançamento, como aparece no catálogo). Quanto mais recente for um item, maior será a classificação e, à medida que o produto "amadurece", a respetiva classificação decai exponencialmente.
Para controlar os resultados em Mais Populares, terá de ajustar dois campos configuráveis na pasta de entidades de dados da Configuração de Recomendações:
- TrendingListMaxAgeDays define a idade máxima em dias de um produto. Um produto que foi lançado há mais do que TrendingListMaxAgeDays dias não aparece na lista de mais populares.
- TrendingListTransactionsIntervalDays define a janela de tempo na qual as interações são agregadas. Um item pode ser mais antigo que este valor, mas só são contabilizadas interações com menos de TrendingListTransactionsIntervalDays dias.
Ajuste estas definições na entidade de dados de Configuração de Recomendações e volte a publicar o modelo. Em seguida, deverá começar a ver os resultados de recomendações.
O que devo fazer se os meus resultados de "seleções para si" estiverem vazios?
A capacidade de "seleções para si" só está disponível para instâncias de modelação com um conjunto de caraterísticas marcado como Padrão ou Premium. Se tiver confirmado que o conjunto de caraterísticas foi configurado corretamente, veja em maior detalhe os utilizadores para os quais está a tentar obter recomendações. Um ID de utilizador sem dados de interação históricos (como compras anteriores) não devolve resultados quando chama "seleções para si". Confirme também se o utilizador optou ativamente por não receber recomendações personalizadas recentemente. Qualquer utilizador que tenha optado ativamente de participar na personalização não receberá recomendações personalizadas.
Porque é que não vejo recomendações de Aspetos Semelhantes?
As recomendações de Aspetos Semelhantes baseiam-se em imagens semelhantes e estas recomendações só serão apresentadas a clientes que tenham selecionado o conjunto de caraterísticas Premium e que tenham partilhado fotografias dos respetivos itens no contrato de dados. Confirme que selecionou o conjunto de caraterísticas Premium para o modelo e que configurou corretamente as imagens conforme descrito nas Entidades de dados de mapeamento de imagem para item.
Onde posso encontrar a lista completa de códigos de estado da API?
A lista completa de Códigos de Estado da API está disponível na página Pedidos de API de Amostra, aqui.
Que parâmetros suporta o Intelligent Recommendations para monitorizar pedidos de API?
É opcional adicionar um ou mais IDs de rastreio seguintes como parâmetros de cabeçalho aos seus pedidos de API. Caso se depare com problemas com os seus pedidos de API, adicionando um ou mais desses parâmetros, podemos monitorizar e investigar os seus pedidos de forma mais eficaz de acordo com os IDs relevantes que fornecer.
| Parâmetro-chave de cabeçalho | descrição |
|---|---|
| CorrelationId | |
| trace-id | |
| parent-id | Podem ser utilizadas de acordo com as suas necessidades para agrupar pedidos, por exemplo, o mesmo utilizador, região, etc. |
Esses parâmetros de cabeçalho podem ser adicionados a qualquer tipo de pedido, independentemente do URI, parâmetros de consulta, cenário, etc.
Consulte também
Guia de início rápido: Configurar e executar o Intelligent Recommendations com dados de amostraGuia de início rápido: Fazer uma chamada à API autenticadaCódigos de Estado da APIRegistos de ErrosDescrição geral da configuraçãoDescrição geral do contrato de dados