Disparar manualmente o ciclo de modelagem

Artigo
10/07/2024

Este artigo orienta os desenvolvedores que desejam usar a ferramenta "Modelar Agora", uma forma de acionar manualmente um ciclo de preparação do recurso de modelagem.

Após a criação e a implantação de um recurso de modelagem, o Recomendações Inteligentes continuará processando os dados por meio de um ciclo de preparação periódico. Por padrão, o ciclo de preparação de dados ocorre a cada 36 horas.

Você pode optar por disparar manualmente o ciclo de modelagem (com algumas limitações) antes do agendamento padrão de 36 horas. Os motivos para um push de modelagem padrão podem ser devido ao ajuste fino de dados de última hora ou como resultado de erros de configuração de dados no Azure Data Lake Storage.

Para disparar manualmente o processo de modelagem, use a chamada à API descrita neste artigo.

Como disparar manualmente o processo de modelagem

Desencadear um ciclo de modelagem com o Insomnia

A seguinte solicitação POST inicia um novo ciclo de modelagem:

https://<your-endpoint-url>/Control/V1.0/Model?modeling=<your-modeling-name>

Você pode encontrar a URL do ponto de extremidade usando as etapas no Guia de Início Rápido para ver os resultados das recomendações.

Limitações com o acionamento manual do processo de modelagem

Há algumas limitações a serem consideradas para disparar manualmente o processo de modelagem:

Um usuário pode executar uma nova solicitação POST do Model Now a cada 30 minutos.
Um usuário pode fazer até 5 solicitações POST durante 24 horas (janela contínua).
O parâmetro de modelagem é considerado opcional. Se você não especificou nenhum parâmetro, o recurso de modelagem padrão é acionado.
Semelhante a todas as outras chamadas à API, disparar o processo de modelagem com a solicitação POST é uma chamada autenticada para o ponto de extremidade do Recomendações Inteligentes, portanto, será necessário incluir as informações de autenticação. Para mais informações, consulte o Guia de Início Rápido para chamadas à API autenticadas.

Exemplos de resposta da API

Mensagem de êxito

Uma resposta bem-sucedida inclui uma mensagem de êxito:

{
    "status": "Success",
    "environmentId": "your env id will be written here",
    "version": "20210930173241" // this is the timestamp of the trigger
}

Mensagem de erro

Pode ocorrer uma mensagem de erro:

Se um ciclo de preparação já estiver em andamento
Caso já tenham sido enviadas muitas solicitações de Gatilho, excedendo a frequência permitida (máximo de 5 tentativas a cada 24 horas ou mais de uma vez por janela de 30 minutos).

A mensagem de erro é semelhante a esta:

{
    "error": {
        "code": "TooManyRequests",
        "message": "Too many requests"
    }
}

Para saber mais sobre outras mensagens de erro que podem ocorrer durante o processo de modelagem, consulte Registros de erros.

Confira também

Visão geral do contrato de dados
Guia de início rápido: criar uma solicitação de API
Guia de Início Rápido: configurar e executar o Recomendações Inteligentes com dados de exemplo
Visão geral da implantação

Compartilhar via