MLSolutionUtil - Global

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • A API MLSolutionUtil fornece métodos para obter Inteligência preditiva previsões.

    A API MLSolutionUtil requer o plug-in Inteligência preditiva (com.glide.platform_ml) e é fornecida no namespace sn_ml.

    Para obter mais informações, consulte Como usar APIs de ML.

    MLSolutionUtil - MLSolutionUtil()

    Instancia um novo objeto MLSolutionUtil.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    
    var mlSolutionUtil = new MLSolutionUtil();
    

    MLSolutionUtil - getPredictions(entrada de objeto, matriz solutionNames, opções de objeto)

    Obtém previsões para uma ou mais soluções especificadas.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    entrada Objeto Matriz GlideRecord ou de objetos JSON como pares de chave-valor.
    solutionNames Matriz Matriz de nomes de soluções para recuperar previsões.
    opções Objeto Opcional. Par de chave-valor do objeto JSON com as seguintes propriedades:
    • top_n: número. Se fornecido, retornará os principais resultados, até o número especificado de previsões.
    • apply_threshold: booliano. Verifica o valor do limite da solução e o aplica ao conjunto de resultados. O valor do limite é o limite de solução para semelhança ou o limite de nível de classe para classificação. O valor padrão é verdadeiro.
    • custom_results_filter: cadeia de caracteres. Somente soluções de semelhança. Especifica o conjunto permitido do qual os resultados são retornados usando uma consulta codificada.
    Tabela 3. Retorna
    Tipo Descrição
    Matriz Par de chave-valor JSON que contém o resultado da previsão agrupado por nome da solução e classificado por sys_id ou record_number.
    • valorprevisto: cadeia de caracteres. Valor que representa o resultado da previsão.
    • previstoSysId: cadeia de caracteres. O sys_id do valor previsto. Os resultados podem ser de qualquer tabela na qual as informações estejam sendo previstas.
    • Confiança: número. Valor da confiança associada à previsão. Por exemplo, 53,84.
    • Limite: Número. Valor do limite configurado associado à previsão.
    • detalhadoResultados: objeto. Somente soluções de semelhança. Par de chave-valor JSON que contém detalhes sobre os índices de texto correspondentes.
    var solutionNames = ['soluton1', 'solution2'];
    
    var input = new GlideRecord("incident");
    input.get("0ef47232db801300864adfea5e961912");
    
    // configure optional parameters
    var options = {};
    options.top_n = 3;
    options.apply_threshold = false;
    
    var mlSolutionUtil = new MLSolutionUtil();
    var results = mlSolutionUtil.getPredictions(input, solutionNames, options);
    
    // pretty print JSON results
    gs.print(JSON.stringify(JSON.parse(results), null, 2));

    Saída:

    {
      solution1:  {
        input_gr_sys_id1: [
                    {
                        predictedValue : xxx,
                        predictedSysId : xx0,
                        confidence : xxx,
                        threshold : xxx,
                        detailedResults : [.....]
    
                    }, 
                    {
                        predictedValue : yyy,
                        predictedSysId : xx1,
                        confidence : xxx,
                        threshold : xxx,
                        detailedResults : [.....]
                    }
            ],
        input_gr_sys_id2 : [
                    {
                        predictedValue : xxx,
                        predictedSysId : xx0,
                        confidence : xxx,
                        threshold : xxx,
                        detailedResults : [.....]
    
                    }, 
                ...
            ]
      }
    
      solution2:  {
          ...
    }