MLSolutiResult - Global (descontinuado)

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • . MLSolutiResult A API fornece métodos para gerenciar informações de cluster e membros de uma solução de cluster. Você pode incorporar os resultados na lógica de negócios.

    Nota:
    Esta API foi descontinuada e deve ser removida em uma versão futura. Consulte Usando APIs DE ML para obter as diretrizes mais recentes.

    MLSolutionResult - MLSolutionResult()

    Instancia um novo objeto MLSolutiResult.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum

    MLSolutionResult - findActiveSolution(String solutionName)

    Retorna o objeto de solução.

    Este método retornará as soluções somente se a definição ml_solution e a solução estiverem ativas (ou seja, treinadas). Para obter informações, consulte Criar e treinar uma solução de cluster .

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    solutionName Cadeia de caracteres Nome do registro ml_solution de cluster.
    Tabela 3. Retornos
    Tipo Descrição
    Objeto Objeto de solução de cluster para o especificado Nome da solução se a definição ml_solution e a solução estiverem ativas, caso contrário, nulo.
    var solutionName = 'ml_incident_assignment';
      var MLS = new MLSolutionResult();
      var solution = MLS.findActiveSolution(solutionName);
      gs.print(solution);
            

    MLSolutiResult - getClusterAssignments(cadeia de caracteres solutionName, opções de objeto)

    Retorna todos os membros de uma solução de cluster.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    solutionName Cadeia de caracteres Nome da solução de cluster ativa.
    opções Objeto Opcional. Restringe os resultados retornados por grupo e nível em uma solução de cluster.

    Padrão: Retorna associações de cluster para todos os clusters.

    options.segmentation_field Cadeia de caracteres Opcional. Identifica o campo de segmentação para o qual recuperar associações de cluster, por exemplo, grupo de atribuição.

    Este campo fornece o mesmo agrupamento que as opções fornecidas por meio de Agrupar por caixa de seleção em Definições de solução de cluster tabela. As informações fornecidas variam de acordo com a tabela selecionada em Tabela campo. Para obter informações, consulte Criar e treinar uma solução de cluster .

    options.cluster_id Cadeia de caracteres Opcional. O sys_id da tabela ml_cluster_summary.
    options.rec_sys_id Cadeia de caracteres Opcional. O sys_id do registro de tabela no qual a solução de cluster se baseia.
    Tabela 5. Retornos
    Tipo Descrição
    Matriz Matriz de objetos de resultado, incluindo:
    • Segmentação - Nome do campo pelo qual agrupar os dados
    • Cluster_num: Número de cluster exclusivo em uma solução de clusters (ou seja, rótulo)
    • rec_sys_id - O sys_id do registro da tabela no qual a solução de cluster se baseia
    • rec_display_id - Nome do registro associado ao registro sys_id.

    O exemplo a seguir mostra como retornar todos os membros do cluster para uma solução sem definir valores para o objeto de opções.

    var solutionName = "<Name_of_Active_Cluster_Solution>";
    var solutionResult = new MLSolutionResult();
    var outcome_array = solutionResult.getClusterAssignments(solutionName);
    for (var i = 0; i < outcome_array.length; i++) {
       gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
    }

    O exemplo a seguir mostra como retornar todos os membros do cluster para um registro usando options.rec_sys_id.

    var now_GR = new GlideRecord('incident');
    now_GR.get('sys_id');
    
    var solutionName = "solution_example";
    var solutionResult = new MLSolutionResult();
    var options = { "rec_sys_id": now_GR.getUniqueValue() };
    var outcome_array = solutionResult.getClusterAssignments(solutionName, options);
    for (var i = 0; i < outcome_array.length; i++) {
       gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
    }

    MLSolutiResult - getClusterInfo(cadeia de caracteres solutionName, opções de objeto)

    Retorna todas as informações de resultado de uma solução de cluster.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    solutionName Cadeia de caracteres Nome da solução de cluster ativa.
    opções Objeto Opcional. Restringe os resultados retornados por grupo e nível em uma solução de cluster.

    Padrão: Retorna associações de cluster para todos os clusters.

    options.segmentation_field Cadeia de caracteres Opcional. Identifica o campo de segmentação para o qual recuperar associações de cluster, por exemplo, grupo de atribuição.

    Este campo fornece o mesmo agrupamento que as opções fornecidas por meio de Agrupar por caixa de seleção em Definições de solução de cluster tabela. As informações fornecidas variam de acordo com a tabela selecionada em Tabela campo. Para obter informações, consulte Criar e treinar uma solução de cluster .

    options.cluster_id Cadeia de caracteres Opcional. O sys_id da tabela ml_cluster_summary.
    Tabela 7. Retornos
    Tipo Descrição
    Matriz Matriz de objetos de resultado, incluindo:
    • Segmentação - Nome do campo pelo qual agrupar os dados
    • Cluster_num: Número de cluster exclusivo em uma solução de clusters (ou seja, rótulo)
    • Total_members - Número de registros no cluster (ou seja, tamanho)
    • Cluster_quality - Valor do percentil de qualidade do cluster
    var solutionName = "solution_example";
    var solutionResult = new MLSolutionResult();
    var outcome_array = solutionResult.getClusterInfo(solutionName);
    for (var i = 0; i < outcome_array.length; i++) {
    gs.print(outcome_array[i].segmentation + ' ' + outcome_array[i].cluster_num + ' ' + outcome_array[i].total_members + ' ' + outcome_array[i].cluster_quality);
    }