MLSolutionResult - Global (descontinuado)

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura
  • 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 Uso de APIs de ML para obter as diretrizes mais recentes.

    MLSolutionResult - findActiveSolution(cadeia de caracteres solutionName)

    Retorna o objeto de solução.

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

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    solutionName Cadeia de caracteres Nome do registro ml_solution de clustering.
    Tabela 2. Retorna
    Tipo Descrição
    Objeto Objeto de solução de clustering para o solutionName especificado se a definição e a solução de 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 cluster.

    Tabela 3. 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: 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 grupo 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 Criar e treinar uma solução de clustering .

    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 na qual a solução de cluster se baseia.
    Tabela 4. Retorna
    Tipo Descrição
    Matriz Matriz de objetos de resultado, incluindo:
    • segmentação — Nome do campo pelo qual os dados serã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 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 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 5. 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: 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 grupo 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 Criar e treinar uma solução de clustering.

    opções.cluster_id Cadeia de caracteres Opcional. O sys_id da tabela ml_cluster_summary.
    Tabela 6. Retorna
    Tipo Descrição
    Matriz Matriz de objetos de resultado, incluindo:
    • segmentação — Nome do campo pelo qual os dados serã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);
    }

    MLSolutionResult - MLSolutionResult()

    Instancia um novo objeto MLSolutionResult.

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