Fornecer um script para critérios de recomendação de tarefa personalizados

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 1 min. de leitura
  • Diretrizes para criar scripts em critérios de recomendação para uma política de recomendação de tarefa inteligente.

    Objeto de retorno do script de personalização

    Seu script deve retornar um objeto JavaScript em uma forma mínima da seguinte forma:
    { 
      "<task sys_id1>": 
        {
          "rating": <rating1>
        },
      "<task sys_id2>”:
        {
          "rating": <rating2>
        },
      …
    }

    Para restrições de filtro, defina a classificação de objetos de retorno como um para unificar o resultado da restrição de filtro dos critérios de recomendação usando sn_task_recommend.TaskRecommendationUtil.setRatingToOne(your objeto); método.

    Para normalizar o resultado da classificação dos critérios de classificação, o objeto JavaScript de retorno deve incluir informações de normalização.
    {           
        "<task <sys_id1>":     
            {
                "rating": <rating1>, 
                "normalizationData": 
                    {
                        "numerator": <numerator value1>,
                        "denominator": <denominator value1> 
                    }
            },    
        "<task <sys_id2>":     
            {
                "rating": <rating2>, 
                "normalizationData": 
                    {
                        "numerator": <numerator value2>,
                        "denominator": <denominator value2> 
                    }
            },
        ...
    }
    Para critérios de classificação, o objeto de retorno pode conter dados para normalização final.
    Nota:
    Se os scripts incluírem dados de normalização, você poderá consultar as inclusões de script padrão nos critérios de recomendação predefinidos:
    • A restrição de filtragem Excluir tarefas que o agente não pode viajar para: sn_fsm_task_rec.TaskRecommendationDistanceRuleProcessador
    • A distância dos critérios de classificação da tarefa: RankTaskOnDistance()

    Script personalizado nos critérios de recomendação

    O exemplo a seguir mostra como escrever um script para os critérios de recomendação.
    var customizedScript = <your-script>; 
    var customizedResult = customizedScript.<your-method>(); 
    ruleResult = TaskRecommendationFSMUtil.parseRuleResult(customizedResult, "<customized-rule>");
    A configuração de exemplo a seguir fornece uma restrição de filtro "Distância da tarefa".
    var distanceRule = new TaskRecommendationDistanceRuleProcessor(args); 
    var ruleProcessResult = distanceRule.processRule(user, tasks, timeStart, timeEnd, 'ranking'); 
    ruleResult = TaskRecommendationFSMUtil.parseRuleResult(ruleProcessResult, "Distance from task");
    Nota:
    Não substitua a palavra-chave da aplicação de recomendação de tarefa Result de regra no script com outras palavras. Caso contrário, a aplicação não poderá processar o resultado da execução da regra.