Perguntas frequentes sobre a conta do Recomendações Inteligentes
Este artigo fornece respostas para perguntas ou problemas comuns que podem surgir ao usar o Recomendações Inteligentes.
Conteúdo
-
Manutenção de conta
- Como crio uma conta do Recomendações Inteligentes?
- Como crio recursos de modelagem e veiculação?
- Como entro em contato com a equipe de suporte?
- Onde posso encontrar a URL do ponto de serviço?
- Meu contrato de dados tem erros, o que eles significam?
- Como posso visualizar os logs de erros para minha instância de modelagem?
- Por que não consigo ver nenhum log gravado na minha pasta de logs?
- O que acontece se eu configurar incorretamente o carimbo de data/hora?
- Meus arquivos Model.JSON/CSVs não estão sendo lidos corretamente?
- Qual é a abordagem recomendada para atualizar meus dados de entrada corretamente?
-
Resultados da API e registro de erros em log
- Como posso verificar se sou um usuário autorizado para fazer solicitações de API?
- A solicitação falhou, mas a URL está correta?
- Acabei de criar uma conta, mas não estou vendo os resultados?
- Como posso acompanhar o status de um modelo na minha conta IR?
- Onde estão meus arquivos de log ou por que eles estão vazios?
- Por que apenas determinados produtos ou determinadas listas não retornam resultados?
- O que devo fazer se meus resultados de Mais Populares estiverem vazios?
- O que devo fazer se meus resultados de "sugestões" estiverem vazios?
- Por que não estou vendo recomendações de itens semelhantes?
- Onde posso encontrar a lista completa de códigos de status da API?
- Quais parâmetros o Recomendações Inteligentes suporta para rastrear solicitações de API?
Manutenção de conta
Esta seção é destinada a perguntas relacionadas à configuração ou à manutenção de contas do Recomendações Inteligentes.
Como crio uma conta do Recomendações Inteligentes?
Para obter as etapas de como configurar sua conta, acesse Visão geral da configuração.
Como crio recursos de modelagem e veiculação?
Para obter as etapas sobre como criar recursos de modelagem e veiculação, consulte a etapa 5 do guia de início rápido de criação de conta.
Como entro em contato com a equipe de suporte do Recomendações Inteligentes?
Para perguntas ou problemas não respondidos, você pode entrar em contato com a equipe de suporte do Recomendações Inteligentes abrindo um tíquete de suporte no Portal do Microsoft Azure.
- No menu à esquerda, selecione Ajuda + suporte.
- Selecione Criar uma solicitação de suporte.
- Preencha o formulário. Um tíquete de suporte é criado.
Onde posso encontrar a URL do ponto de extremidade de veiculação?
Para ver as etapas sobre como localizar a URL do Ponto de Extremidade de Veiculação, acesse sua conta do Recomendações Inteligentes no portal do Azure e pesquise o Recurso de Ponto de Extremidade que deseja usar. No portal, você pode copiar o ponto de extremidade da URL de veiculação. Para mais informações, acesse o guia de início rápido para visualizar os resultados das recomendações.
Como faço para resolver erros no contrato de dados?
Para entender os logs de erros que estão sendo retornados no contrato de dados, acesse Tipos de erros.
Como posso visualizar os logs de erros para minha instância de modelagem?
Para visualizar os logs de erros da sua instância de modelagem, configure sua conta para habilitar a modelagem de erros. Para obter mais informações, acesse Registro de erro de configuração. Para obter mais informações sobre os tipos de erro que podem ser retornados, acesse Tipos de erros.
Por que não consigo ver nenhum log gravado na minha pasta de logs?
Se você não conseguir ver nenhum log gravado em sua pasta de logs dedicada, verifique se sua conta IR tem acesso para gravar no contêiner relevante:
- Acesse sua conta do Recomendações Inteligentes.
- Selecione a guia Relatórios.
- Clique no botão "Verificar Acesso"
- Se a mensagem retornada disser que "A configuração para acesso à conta de armazenamento está ausente", você precisará conceder permissões de gravação para acessar o contêiner associado. Se a mensagem retornada disser que "A conta de armazenamento solicitada não existe ou você não tem permissões", verifique se a URL fornecida está correta.
O que acontece se eu configurar incorretamente o carimbo de data/hora?
Se você estiver enfrentando problemas com os carimbos de data/hora, o produto será removido da lista de candidatos disponíveis e filtrado das recomendações. Para corrigir esse problema, comece verificando as entradas da entidade de dados ItemsAndVariants e verifique se a data de lançamento está no formato de data e hora compatível (que é "aaaa-MM-ddTHH: mm:ss.fffZ").
Problemas ao ler os CSVs model.json
Abrir os CSVs no Excel ou em qualquer outra ferramenta não compatível com CSV pode remover colunas vazias necessárias no formato CSV para Entidades de Dados. Sugerimos abrir e verificar seus CSVs no Bloco de notas ou em um aplicativo relacionado que não modificará o conteúdo.
Qual é a abordagem recomendada para atualizar meus dados de entrada corretamente?
Se você tentar modelar e atualizar seus dados de entrada ao mesmo tempo, às vezes isso pode levar à modelagem de dados de versões de dados mistos e resultados de recomendação indesejados. Consulte nosso Guia de melhores práticas para obter mais informações sobre como atualizar devidamente os dados de entrada.
Resultados da API e registro de erros em log
Nesta seção, você encontrará perguntas relacionadas aos resultados da API ou documentação de registro de erros em log.
Como posso verificar se sou um usuário autorizado para fazer solicitações de API?
Os usuários devem ser adicionados à lista de usuários autorizados para um recurso de ponto de extremidade antes de chamarem o serviço com êxito. Para obter mais informações sobre como verificar o status de usuários autorizados, acesse a etapa 2 do guia de início rápido para criar solicitações de API.
A solicitação falhou, mas a URL está correta?
Se a URL estiver correta, é possível que o usuário que está fazendo a solicitação não esteja na lista de usuários autorizados para este recurso de ponto de extremidade.
Para obter mais informações sobre como verificar o status de usuários autorizados, acesse a etapa 2 do guia de início rápido para criar solicitações de API.
Acabei de criar uma conta, mas não estou vendo os resultados.
Se a conta acabou de ser iniciada, o serviço levará algum tempo até que os resultados estejam disponíveis. Você pode acompanhar o status de modelagem de cada um dos modelos que criou. Para obter mais informações, consulte nosso Guia de Relatórios de Status de Modelagem.
Você também pode consultar a pasta de logs para saber mais sobre quaisquer problemas com seu contrato de dados e se precisa fazer alterações ou correções.
Se você ainda não conseguir ver nenhum resultado, verifique se concedeu à sua conta de Recomendações Inteligentes a permissão para ler os dados do contêiner relevante:
- Acesse sua conta do Recomendações Inteligentes.
- Selecione a guia "Modelagem".
- Escolha o componente de modelagem relevante.
- Selecione a guia "Cadeia de Conexão".
- Clique no botão "Verificar Acesso".
- Se a mensagem retornada disser que "A configuração para acesso à conta de armazenamento está ausente", você precisará conceder permissões de leitura para acessar o contêiner associado. Se a mensagem retornada disser que "A conta de armazenamento solicitada não existe ou você não tem permissões", verifique se a URL fornecida está correta.
Além disso, verifique se as pastas e os arquivos corretos foram colocados na conta de armazenamento. Para mais informações, consulte Baixar o arquivo model.json e configurar a pasta raiz.
Como posso acompanhar o status de modelagem?
Os clientes do Recomendações Inteligentes podem rastrear o status de modelagem de cada um dos modelos criados nas contas. Depois que você configurar um modelo, o serviço criará periodicamente um arquivo de log de status para relatar o status atual de todos os algoritmos (para sua camada de modelagem). Para saber mais sobre como acessar esses logs, consulte Guia dos relatórios de status da modelagem.
Onde estão meus arquivos de log ou por que eles estão vazios?
Seus arquivos de log podem estar vazios se você não concedeu as permissões corretas de Colaborador de Dados do Storage Blob ou apontou para a cadeia de conexão incorreta. Para confirmar, siga nosso guia de início rápido.
Além disso, certifique-se de que seus arquivos de log de erros foram configurados corretamente e verifique se sua cadeia de conexão para sua instância de modelagem aponta para a pasta que contém seus arquivos de log.
Por que apenas determinados produtos ou determinadas listas não retornam resultados?
Em geral, interações insuficientes para um determinado item ou usuário podem afetar a qualidade dos resultados ou a falta de retorno de qualquer resultado. Às vezes, novos produtos também precisam de algum tempo para adquirir sinais antes de aparecer em certas listas de recomendações. Você sempre pode ver mais detalhadamente o desempenho do seu produto usando os painéis.
O que devo fazer se meus resultados de Mais Populares estiverem vazios?
A API da Lista Mais Populares leva em consideração a idade de um produto e sua contagem de interações ao pontuar (classificar) cada item na lista.
Primeiro contamos o número de interações em uma janela de tempo definida, consideramos depois fatores de idade do produto (dias desde a data de lançamento, conforme aparece no catálogo). Quanto mais novo um item, maior a pontuação e, à medida que um produto "envelhece", sua pontuação decai exponencialmente.
Para controlar os resultados no Mais Populares, você precisará ajustar dois campos configuráveis na Pasta de entidade de dados de Configuração do Registro:
- TrendingListMaxAgeDays define a idade máxima, em dias, de um produto. Um produto lançado há mais tempo do que o definido em TrendingListMaxAgeDays não vai aparecer na lista Mais Populares.
- TrendingListTransactionsIntervalDays define a janela de tempo em que as interações são agregadas. Um item pode ser mais antigo que esse valor, mas somente as interações feitas há menos dias que o definido em TrendingListTransactionsIntervalDays serão contadas.
Ajuste essas configurações na sua entidade de dados Configuração do Registro e republique seu modelo. Depois, você deverá começar a ver os resultados das recomendações.
O que devo fazer se meus resultados de "sugestões" estiverem vazios?
O recurso "sugestões" só está disponível para instâncias de modelagem com um conjunto de recursos marcado como Standard ou Premium. Se você confirmou que o conjunto de recursos foi configurado corretamente, verifique os usuários para os quais você está tentando obter recomendações. Uma ID de usuário sem dados históricos de interação (como compras anteriores) não retornará resultados ao chamar "sugestões". Confirme também se o usuário optou por não receber recomendações personalizadas recentemente. Qualquer usuário que desativou a personalização não receberá recomendações personalizadas.
Por que não estou vendo recomendações de itens semelhantes?
Como as recomendações de itens semelhantes se baseiam em imagens semelhantes e essas recomendações serão exibidas apenas para clientes que selecionaram o conjunto de recursos Premium e compartilharam fotos de seus itens no contrato de dados. Confirme se você selecionou o conjunto de recursos Premium para seu modelo e configurou corretamente conforme descrito nas Entidades de dados de mapeamentos de imagem para item.
Onde posso encontrar a lista completa de códigos de status da API?
A lista completa de Códigos de status da API estão disponíveis na página Solicitações de API de exemplo, aqui.
Quais parâmetros o Intelligent Recommendation suporta para rastrear solicitações de API?
É opcional adicionar um ou mais dos seguintes IDs de rastreamento como parâmetros de cabeçalho para suas solicitações de API. Caso você encontre problemas com suas solicitações de API, adicionando um ou mais desses parâmetros, podemos rastrear e investigar suas solicitações com mais eficiência de acordo com os IDs relevantes que você fornecer.
| Parâmetro-chave do cabeçalho | Descrição |
|---|---|
| CorrelationId | |
| trace-id | |
| parent-id | Pode ser utilizado de acordo com a sua necessidade para agrupar pedidos, por exemplo do mesmo usuário, região, etc. |
Esses parâmetros de cabeçalho podem ser adicionados a qualquer tipo de solicitação, independentemente do URI, parâmetros de consulta, cenário etc.
Confira também
Guia de Início Rápido: configurar e executar Recomendações Inteligentes com dados de exemplo
Guia de Início Rápido: fazer uma chamada à API autenticada
Códigos de status da API
Logs de erro
Visão geral da configuração
Visão geral do contrato de dados