MLSolutionResult - Global (descontinuado)

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura
  • A API MLSolutionResult 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 Como usar APIs de ML para obter as diretrizes mais recentes.

    MLSolutionResult – MLSolutionResult()

    Instancia um novo objeto MLSolutionResult.

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

    MLSolutionResult – findActiveSolution(cadeia de caracteres solutionName)

    Retorna o objeto de solução.

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

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

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

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

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

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

    opções.segmentação_campo Cadeia de caracteres Opcional. Identifica o campo de segmentação para o qual serão recuperadas associações de cluster, por exemplo, grupo de atribuição.

    Este campo fornece o mesmo agrupamento que as opções fornecidas por meio da caixa de seleção Usar agrupar por na tabela Definições de solução de cluster. As informações fornecidas variam de acordo com a tabela selecionada no campo Tabela. Para obter informações, consulte Criação e treinamento de uma solução de cluster .

    opções.cluster_id Cadeia de caracteres Opcional. O sys_id da tabela ml_cluster_summary.
    opções.rec_sys_id Cadeia de caracteres Opcional. O sys_id do registro da tabela em que 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 os dados são agrupados
    • 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 em que 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 de 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 de cluster para um registro usando opções.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);
    }

    MLSolutionResult - 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. Limita os resultados retornados por grupo e nível em uma solução de clustering.

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

    opções.segmentação_campo Cadeia de caracteres Opcional. Identifica o campo de segmentação para o qual serão recuperadas associações de cluster, por exemplo, grupo de atribuição.

    Este campo fornece o mesmo agrupamento que as opções fornecidas por meio da caixa de seleção Usar agrupar por na tabela Definições de solução de cluster. As informações fornecidas variam de acordo com a tabela selecionada no campo Tabela. Para obter informações, consulte Criação e treinamento de uma solução de cluster.

    opções.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 os dados são agrupados
    • 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);
    }