ClusteringsolutionVersion - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 19 min. de leitura

    • . ClusteringsolutionVersion A API é um objeto programável usado em Inteligência preditiva armazenamentos.

    Este A API requer Inteligência preditiva plug-in (com.glide.platform_ml) e é fornecido em sn_ml namespace.

    Ele é usado para trabalhar com versões de solução baseadas em API ClusteringSolution objetos no Armazenamento de soluções Clustering .

    O sistema cria uma versão de solução sempre que você treina uma definição de solução. A maioria das versões é criada durante o treinamento programado da solução.

    Os métodos nesta API podem ser acessados usando o seguinte ClusteringSolution métodos:

    ClusteringSolutionVersion - cancelUpdateJob()

    Cancela um trabalho de atualização em um instrutor.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 2. Retorna
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como cancelar um trabalho de treinamento ativo que foi enviado usando o. SubmitTrainingJob() método.

    var myCluster = new sn_ml.ClusteringSolutionStore.get("ml_x_snc_global_global_clustering_solution");
var mlSolutionVersion = myCluster.getActiveVersion();

mlSolutionVersion.cancelUpdateJob();

    ClusteringSolutionVersion - deleteClusterAssignments (opções de objeto)

    Exclui atribuições de cluster de linhas por posição na sequência de tabelas ou GlideDateTime.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    opções Objeto Objeto que define uma opção para excluir atribuições de cluster.
    Nota:
    Somente uma opção de exclusão é válida.
    Options.updatedUntil Cadeia de caracteres Exclui linhas de clusters com updated_since valores que ocorrem antes deste valor. O formato deve ser fornecido como GlideDateTime .
    { "updatedUntil" : "String" }
    options.sequenceUntil Cadeia de caracteres Exclui linhas de clusters com insert_sequence Valores que ocorrem antes deste valor na tabela Detalhes do cluster de ML [ml_cluster_detail]. O valor do ponto de partida da posição da sequência é 1. 
    { "sequenceUntil" : Number }
    Tabela 4. Retornos
    Tipo Descrição
    Número Número de linhas excluídas da tabela Detalhes do cluster de ML [ml_cluster_detail].

    O exemplo a seguir mostra como excluir linhas de clusters com updated_since tempo anterior '2020-06-28 02:50:53' .

    var mlSolution = sn_ml.ClusteringSolutionStore.get("ml_x_snc_global_global_clustering_solution");

var mlSolutionVersion = mlSolution.getActiveVersion();

var options = {};
options.updatedUntil = '2020-06-28 02:50:53';

var results = mlSolutionVersion.deleteClusterAssignments(options);

gs.print("Number of deleted rows: "+results);

    Saída:

    Number of deleted rows: 6417

    O exemplo a seguir mostra como excluir linhas de clusters com updated_since posicionados sequencialmente antes de 1000 .

    var mlSolution = sn_ml.ClusteringSolutionStore.get("ml_x_snc_global_global_clustering_solution");

var mlSolutionVersion = mlSolution.getActiveVersion();

var options = {};
options.sequenceUntil = 1000;

var results = mlSolutionVersion.deleteClusterAssignments(options);

gs.print("Number of deleted rows: "+results);

    Saída:

    Number of deleted rows: 999

    ClusteringSolutionVersion - getClusterAssignments (opções de objeto)

    Obtém atribuições para uma solução de cluster.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    opções Objeto Valores a serem usados para restringir os resultados retornados por grupo, nível, horas de atualização do sistema e número de linha da tabela em uma solução de cluster. Mínimo de um argumento deve ser especificado.
    {
     "cluster_id": "String",
     "group_by": "String",
     "limit": Number,
     "sequenceSince": Number,
     "sequenceUntil": Number,
     "topNPerCluster": Number,
     "updatedSince": "String",
     "updatedUntil": "String"
}
    options.cluster_id Cadeia de caracteres Opcional. ID de cluster de uma solução treinada na tabela Resumo do cluster [ml_cluster_summary].
    options.group_by Cadeia de caracteres Opcional. Identifica o campo de segmentação para o qual recuperar associações de cluster, por exemplo, assignment_group.

    Este campo fornece o mesmo agrupamento que as opções fornecidas em Agrupar por caixa de seleção em Definição de Clustering formulário. As informações fornecidas variam de acordo com a tabela selecionada em Tabela campo. Para obter mais informações, consulte Criar e treinar uma solução de cluster .
    options.limit Número Opcional. Número máximo de atribuições de cluster a serem recuperadas.
    options.sequenceSince Número Posição inicial em uma sequência de tabela. Retorna informações para clusters com insert_sequence habilitado e posicionado após esse valor na tabela Detalhes do cluster de ML [ml_cluster_detail]. O valor do ponto de partida da posição da sequência é 1.
    options.sequenceUntil Número Retorna atribuições para clusters com insert_sequence Valores que ocorrem antes deste valor na tabela Detalhes do cluster de ML [ml_cluster_detail]. O valor do ponto de partida da posição da sequência é 1.
    Options.TopNPerCluster Número Número de principais resultados a receber para cada cluster.
    Options.updatedDesde Cadeia de caracteres Opcional. Data e hora. Retorna informações para clusters com sys_updated_on após o valor fornecido em GlideDateTime .
    Options.updatedUntil Cadeia de caracteres Opcional. Data e hora. Retorna informações para clusters com sys_updated_on antes do valor fornecido em GlideDateTime .
    Tabela 6. Retornos
    Tipo Descrição
    Matriz Lista de objetos que contêm informações de cluster em ordem crescente por cluster_id.
    [
    {
       "cluster_id": "String",
       "group_by": "String",
       "rec_display_id": "String",
       "rec_sys_id": "String"
     }
]
    <object>.cluster_id Número de cluster exclusivo em uma solução de clusters.
    <object>.group_by Se agrupado, nome do campo de segmentação associado a este cluster.
    <object>.rec_display_id Número e tipo de registro.
    <object>.rec_sys_id Sys_id do registro.

    O exemplo a seguir mostra como usar o. optionsobjeto para filtrar resultados de cluster.

    var mlSolution = sn_ml.ClusteringSolutionStore.get("solution_name");

var mlSolutionVersion = mlSolution.getActiveVersion();

var options = {};
options.clusterId = 56;
options.topNPerCluster = 10;
options.updatedUntil = '2020-01-17 23:16:14'; 
options.updatedSince = '2020-01-17 23:16:13'; 
options.sequenceUntil = 1000; 
options.sequenceSince = 1100; 
options.limit = 100;

var results = mlSolutionVersion.getClusterAssignments(options)

gs.print(results);

    Saída:

    [{"cluster_id":"1","rec_display_id":"Incident": "INC0014483","rec_sys_id":"04e33e7adb401300864adfea5e961900","group_by":"network"},
 {"cluster_id":"1","rec_display_id":"Incident": "INC0011133","rec_sys_id":"5bd23af2db401300864adfea5e96194d","group_by":"network"}]

    ClusteringSolutionVersion - getClusterInfo(opções de objeto)

    Obtém informações de uma solução de cluster especificada na loja. A medição de pureza fornece informações como uma porcentagem para os campos de cluster nos quais a pureza se baseia.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    opções Objeto Opcional. Objeto que contém propriedades que permitem filtrar resultados em uma solução de cluster.
    {
  "clusterId": "String",     
  "groupBy": "String",
  "limit": "String",
  "recSysId": "String",
  "sequenceSince": Number,
  "sequenceUntil": Number,
  "updatedSince": "String",
  "updatedUntil": "String"
}

    Padrão: Retorna associações de cluster para todos os clusters.
    ClusterId Cadeia de caracteres Opcional. ID de cluster de uma solução treinada na tabela Resumo do cluster [ml_cluster_summary].
    options.groupBy Cadeia de caracteres Opcional. Identifica o campo de segmentação para o qual recuperar associações de cluster, por exemplo, assignment_group.

    Este campo fornece o mesmo agrupamento que as opções fornecidas em Agrupar por caixa de seleção em Definição de Clustering formulário. As informações fornecidas variam de acordo com a tabela selecionada em Tabela campo. Para obter mais informações, consulte Criar e treinar uma solução de cluster .
    options.limit Número Opcional. Número máximo de atribuições de cluster a serem recuperadas.
    Options.recSysId Cadeia de caracteres Opcional. Sys_id de um registro pelo qual encontrar informações do cluster.
    options.sequenceSince Número Posição inicial em uma sequência de tabela. Retorna informações para clusters com insert_sequence habilitado e posicionado após esse valor na tabela Detalhes do cluster de ML [ml_cluster_detail]. O valor do ponto de partida da posição da sequência é 1.
    options.sequenceUntil Número Opcional. Posição final em uma sequência de tabela. Retorna atribuições para clusters com insert_sequence Valores que ocorrem antes deste valor na tabela Detalhes do cluster de ML [ml_cluster_detail]. O valor do ponto de partida da posição da sequência é 1.
    Options.updatedDesde Cadeia de caracteres Opcional. Data e hora. Retorna informações para clusters com sys_updated_on após o valor fornecido em GlideDateTime formato.
    Options.updatedUntil Cadeia de caracteres Opcional. Data e hora. Retorna informações para clusters com sys_updated_on antes do valor fornecido em GlideDateTime .
    Tabela 8. Retornos
    Tipo Descrição
    Matriz Lista de objetos que contêm informações de cluster.
    [
  {   
    "cluster_concept": "String",
    "cluster_id": "String",
    "cluster_quality": "String",
    "cluster_size": "String",
    "group_by": "String",
    "insert_sequence": "String",
    "purity": "String",
    "sys_updated_on": "String"
  }
]
    <object>.cluster_concept Conjunto de palavras que descrevem o cluster em ordem decrescente de frequência.

    Tipo de dados: Cadeia de caracteres
    <object>.cluster_id Número de cluster exclusivo em uma solução de clusters.
    <object>.cluster_quality Número de 0 a 100. Números mais altos indicam maior densidade de cluster.

    Tipo de dados: Cadeia de caracteres
    <object>.cluster_size Número de registros em um cluster.

    Tipo de dados: Cadeia de caracteres
    <object>.group_by Se agrupado, nome do campo de segmentação associado a este cluster.

    Tipo de dados: Cadeia de caracteres
    <object>.insert_sequence Número da posição sequencial do cluster na tabela Resumo do cluster [ml_cluster_summary].

    Tipo de dados: Cadeia de caracteres
    <object>.pureza Valor percentual que representa a pureza da qualidade do cluster.
    <object>.sys_updated_on Sistema GlideDateTime valor que representa a data e a hora em que este cluster foi atualizado pela última vez.

    Tipo de dados: Cadeia de caracteres

    O exemplo a seguir mostra como definir o parâmetro do objeto de opções e imprimir os resultados do cluster filtrados.

    var mlSolution = sn_ml.ClusteringSolutionStore.get("ml_x_snc_global_global_clustering_solution");

var mlSolutionVersion = mlSolution.getActiveVersion();

var options = {};
options.updatedSince = '2020-05-28 02:09:53'; 
options.updatedUntil = '2020-05-28 03:15:00';
options.sequenceSince = 1;
options.limit = 10;

var results = mlSolutionVersion.getClusterInfo(options);

gs.print(JSON.stringify(JSON.parse(results), null, 2));

    Saída:

    [
  {
    "cluster_id": "1",
    "cluster_quality": "100",
    "cluster_size": "17",
    "purity": "",
    "insert_sequence": "8",
    "group_by": "VPN   Customer",
    "sys_updated_on": "2020-05-28 02:09:53",
    "cluster_concept": "vpn instance connection ldap user log unable usability tunnel"
  },
  {
    "cluster_id": "1",
    "cluster_quality": "100",
    "cluster_size": "10",
    "purity": "",
    "insert_sequence": "24",
    "group_by": "Live Feed",
    "sys_updated_on": "2020-05-28 02:09:53",
    "cluster_concept": "feed live user note work disable group default usability sort"
  },
  {
    "cluster_id": "1",
    "cluster_quality": "100",
    "cluster_size": "18",
    "purity": "",
    "insert_sequence": "40",
    "group_by": "Integrations",
    "sys_updated_on": "2020-05-28 02:09:53",
    "cluster_concept": "integrate usability certificate error"
  },
...
]

    ClusteringSolutionVersion - getProperties()

    Obtém propriedades do objeto de solução e o número da versão.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Objeto Conjunto de dados e. ClusteringSolution detalhes da versão. Os resultados variam de acordo com a configuração da propriedade do objeto.
    {
  "algorithmConfig": {Object},
  "datasetProperties": {Object},
  "domainName": "String",
  "encoder": {Object},
  "groupByFieldName": "String", 
  "inputFieldNames": [Array],
  "isActive": Boolean,
  "label": "String",
  "minRecordsPerCluster": Number,
  "name": "String",
  "processingLanguage": "String",
  "scope": "String",
  "stopwords": [Array],
  "trainingFrequency": "String",
  "updateFrequency": "String",
  "versionNumber": Number
}
    <Object>.AlgorithmConfig Objeto JavaScript que contém propriedades de configuração do algoritmo.Os resultados da propriedade variam de acordo com o valor definido em algorithmpropriedade.

    Tipo de dados: Objeto

    'algorithmConfig' : {
  "algorithm": "String",  
  // See algorithmConfig.algorithm setting description for property settings based on algorithm
}
    <Object>.AlgorithmConfig.algorithm Método para codificar sua solução.
    Propriedades para dbscan:
    'algorithmConfig': {
  "algorithm": "dbscan",
  "distanceMetric": "String",
  "epsilon": Number,
  "minimumNeighbours": Number
}
    Propriedades para kmeans:
    'algorithmConfig': {
  "algorithm": "kmeans",
  "targetCoverage": Number
}

    Tipo de dados: Cadeia de caracteres
    <Object>.AlgorithmConfig.distanceMetric Algoritmo DBSCAN somente. Métrica de distância para verificar objetos de dados semelhantes.

    Tipo de dados: Cadeia de caracteres
    <Object>.AlgorithmConfig.epsilon Algoritmo DBSCAN somente. Valor decimal entre 0 e 1 que representa o tamanho do raio de pesquisa da vizinhança.

    Tipo de dados: Número
    <Object>.AlgorithmConfig.minimumNeighbors Algoritmo DBSCAN somente. Número mínimo de vizinhos necessários em um ponto para fazer parte de um cluster. Para levenshteinDistanceo valor deve ser 1 para que nenhum ponto seja excluído do conjunto de dados.

    Tipo de dados: Número
    <Object>.AlgorithmConfig.targetCoverage Algoritmo K-means somente. Campo de percentil para filtrar registros menos semelhantes entre si.

    Tipo de dados: Número
    <Object>.DatasetProperties

    Lista as propriedades do DatatsetDefinition objeto associado à solução.

    {
  "encodedQuery": "String",
  "fieldDetails": [Array],
  "fieldNames": [Array],
  "tableName": "String"
}

    Tipo de dados: Objeto
    <Object>.DatasetProperties.encodedQuery Cadeia de caracteres de consulta codificada no formato Glide padrão. Consulte Cadeias de caracteres de consulta codificadas .

    Tipo de dados: Cadeia de caracteres
    <Object>.DatasetProperties.fieldDetails Lista de objetos JavaScript que especificam propriedades de campo.

    Tipo de dados: Matriz de objetos

    [
  {
    "name": "String",
    "type": "String"
  }
]
    <Object>.datasetProperties.fieldDetails.name Nome do campo que define o tipo de informação ao qual restringir este conjunto de dados.

    Tipo de dados: Cadeia de caracteres
    <Object>.DatasetProperties.fieldDetails.type Tipo de campo de aprendizado de máquina.

    Tipo de dados: Cadeia de caracteres
    <Object>.DatasetProperties.fieldnames Lista de nomes de campos da tabela especificada como cadeias de caracteres. Por exemplo, "Fieldnames" : ["short_description", "prioridade"] .

    Tipo de dados: Matriz
    <Object>.DatasetProperties.tablename Nome da tabela do conjunto de dados. Por exemplo, "Tablename" : "Incidente" .

    Tipo de dados: Cadeia de caracteres
    <Object>.Domainname Nome de domínio associado a este conjunto de dados. Consulte Domain Separation e. Inteligência preditiva.

    Tipo de dados: Cadeia de caracteres
    Object.encoderProperties Objeto do codificador atribuído a esta solução. Consulte Encoder - Encoder (configuração de objeto).

    Tipo de dados: Objeto
    Object.groupByFieldName Nome do campo pelo qual o sistema agrupa registros em um ou mais clusters.

    Tipo de dados: Cadeia de caracteres
    Object.inputFieldNames Lista de nomes de campos de entrada como cadeias de caracteres. O modelo usa esses campos usados para fazer previsões.

    Tipo de dados: Cadeia de caracteres
    <Object>.IsActive Sinalizador que indica se esta versão está ativa.
    Valores válidos:
    • Verdadeiro: A versão está ativa.
    • Falso: A versão não está ativa.

    Tipo de dados: Cadeia de caracteres
    <Object>.label Identifica a tarefa de previsão. 
    {
  "label": "my first prediction"
}

    Tipo de dados: Cadeia de caracteres
    <Object>.MinRecordsPerCluster Número mínimo de registros a serem permitidos em qualquer cluster.

    Tipo de dados: Número
    <Object>.name Nome atribuído pelo sistema.

    Tipo de dados: Cadeia de caracteres
    <Object>.ProcessingLanguage Linguagem de processamento no formato de código de idioma ISO 639-1 de duas letras.

    Tipo de dados: Cadeia de caracteres
    <Object>.escopo Escopo do objeto. Atualmente, o único valor válido é global .

    Tipo de dados: Cadeia de caracteres
    <Object>.palavras irrelevantes Opcional. Lista predefinida de cadeias de caracteres que o sistema gera automaticamente com base em languageconfiguração de propriedade. Para obter detalhes, consulte Crie uma lista de palavras irrelevantes personalizada .

    Tipo de dados: Matriz
    <Object>.TrainingFrequency A frequência para treinar novamente o modelo.
    Valores possíveis:
    • every_30_days
    • every_60_days
    • every_90_days
    • every_120_days
    • every_180_days
    • run_once
    Padrão: Run_once

    Tipo de dados: Cadeia de caracteres
    <Object>.UpdateFrequency A frequência na qual o modelo da definição da solução deve ser recriado.
    Valores possíveis:
    • _not_update
    • every_1_day
    • every_1_hour
    • every_6_hours
    • every_12_hours
    • every_1_minute
    • every_15_minutes
    • every_30_minutes
    Padrão: Do_not_update

    Tipo de dados: Cadeia de caracteres
    <Object>.VersionNumber Número da versão do ClusteringSolution objeto.

    O exemplo a seguir obtém propriedades da versão do objeto ativo no armazenamento.

    // Get properties
var mlSolution = sn_ml.ClusteringSolutionStore.get('ml_x_snc_global_global_clustering_solution');

gs.print(JSON.stringify(JSON.parse(mlSolution.getActiveVersion().getProperties()), null, 2));

    Saída:

    *** Script: {
  "algorithmConfig": {
    "algorithm": "kmeans",
    "targetCoverage": "90"
  },
  "datasetProperties": {
    "tableName": "incident",
    "fieldNames": [
      "category",
      "short_description",
      "state",
      "description"
    ],
    "encodedQuery": "activeANYTHING"
  },
  "domainName": "global",
  "encoderProperties": {
    "datasetsProperties": [
      {
        "tableName": "incident",
        "fieldNames": [
          "assignment_group",
          "short_description",
          "description"
        ],
        "encodedQuery": "activeANYTHING"
      }
    ],
    "domainName": "global",
    "isActive": "true",
    "label": "my encoder definition",
    "name": "ml_x_snc_global_global_my_encoder_definition",
    "processingLanguage": "en",
    "stopwords": [
      "Default English Stopwords"
    ],
    "versionNumber": "1"
  },
  "groupByFieldName": "category",
  "inputFieldNames": [
    "short_description"
  ],
  "isActive": "true",
  "label": "clustering solution",
  "minRecordsPerCluster": 2,
  "name": "ml_x_snc_global_global_clustering_solution",
  "processingLanguage": "en",
  "stopwords": [
    "Default English Stopwords"
  ],
  "updateFrequency": "do_not_update",
  "versionNumber": "1"
}

    ClusteringSolutionVersion - getStatus(boolian includeDetails)

    Obtém o status de conclusão do treinamento.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    IncludeDetalhes Booliano Sinalizador que indica se o status deve ser retornado details.
    Valores válidos:
    • Verdadeiro: Retorna detalhes adicionais.
    • Falso: Não retorna detalhes adicionais.

    Padrão: Falso
    Tabela 12. Retornos
    Tipo Descrição
    Objeto Objeto JavaScript que contém informações de status de treinamento para. ClusteringSolution objeto.
    {
  "state": "String",
  "percentComplete": "Number as a String",
  "hasJobEnded": "Boolean value as a String",
  "details": {Object}
}
    <Object>.state Estado de conclusão do treinamento. Se o trabalho de treinamento atingir um estado de terminal, o trabalho não deixará esse estado. Se o estado for terminal, o hasJobEndeda propriedade está definida como verdadeiro .
    Valores possíveis:
    • buscando_files_for_training
    • preparing_data
    • tente novamente
    • solution_cancelled (terminal)
    • solution_complete (terminal)
    • solution_error (terminal)
    • solution_incomplete
    • training_request_received
    • training_request_timed_out (terminal)
    • training_solution
    • uploading_solution
    • waiting_for_training

    Tipo de dados: Cadeia de caracteres
    <Object>.HasJobEnded Sinalizador que indica se o treinamento está concluído.
    Valores válidos:
    • Verdadeiro: O treinamento foi concluído.
    • Falso: O treinamento está incompleto.

    Tipo de dados: Valor booliano como uma cadeia de caracteres
    <Object>.PercentCompletar Percentual de treinamento concluído. Se a porcentagem de conclusão for menor que 100, o trabalho poderá estar em um estado terminal. Por exemplo, se o treinamento expirar.

    Tipo de dados: Número como uma cadeia de caracteres

    Intervalo: 0 a 100
    <Object>.detalhes Objeto que contém uma lista de detalhes adicionais de treinamento.

    Tipo de dados: Objeto

    O exemplo a seguir mostra um resultado bem-sucedido com o treinamento concluído.

    // Get status
var mlSolution = sn_ml.ClusteringSolutionStore.get('ml_x_snc_global_global_cluster_solution');

gs.print(JSON.stringify(JSON.parse(mlSolution.getActiveVersion().getStatus(true), null, 2)));

    Saída:

    {
 "state":"solution_complete",
 "percentComplete":"100",
 "hasJobEnded":"true",
 "details":{"stepLabel":"Solution Complete"} // This information is only returned if getStatus(true);
}

    O exemplo a seguir mostra um resultado malsucedido com o treinamento concluído.

    // Get status
var solutionName = 'ml_x_snc_global_global_cluster_solution';
var mlSolution = sn_ml.ClusteringSolutionStore.get(solutionName);
var trainingStatus = mlSolution.getLatestVersion().getStatus();

gs.print(JSON.stringify(JSON.parse(trainingStatus), null, 2));

    Saída:

    {
 "state":"solution_error",
 "percentComplete":"100",
 "hasJobEnded":"true"
}

    ClusteringSolutionVersion - getTopNPurityInfo(opções de objeto)

    Obtém os principais resultados de pureza para uma solução de cluster. A medição de pureza fornece informações como uma porcentagem para os campos de cluster nos quais a pureza se baseia.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    opções Objeto Opções que determinam o número e o formato dos principais resultados de pureza do cluster.
    {
  "clusterIds": [Array],
  "groupBy": [Array],
  "purityFields": [Array],
  "topN": Number,
  "topNFields": Number
}
    ClusterIds Matriz Opcional. Lista de IDs de cluster fornecida como cadeias de caracteres. Um ID de cluster é fornecido na tabela Resumo do cluster [ml_cluster_summary]. Se fornecido, este método retornará informações do cluster de pureza para cada cluster especificado.

    Padrão: Este método retorna informações de pureza para todos os clusters.
    options.groupBy Matriz Opcional. Lista de cadeias de caracteres de campo group_by da tabela para ajudar o sistema a identificar a classe mais frequente no cluster. Se fornecido, retorna informações de pureza para soluções de cluster usando campos group_by. A tabela Resumo do cluster [ml_cluster_summary] lista clusters e todos os valores de Group By associados.

    Este campo se aplica somente a clusters que usam agrupar por na definição de cluster. Os campos qualificados são listados em Tabela campo. Para obter detalhes sobre o recurso Agrupar por, consulte Criar e treinar uma solução de cluster .
    Options.purityFields Matriz Opcional. Lista de cadeias de caracteres do campo de pureza. Se fornecido, este método retornará somente informações para esses campos de pureza. Você pode exibir valores de pureza de um cluster nas listas da tabela Resumo do cluster [ml_cluster_summary].
    Nota:
    Se ambos purity_fieldse. top_n_fieldseste método retorna top_n_fieldsem primeiro lugar, seleciona os campos de purity_fields.

    Padrão: Retorna informações de pureza para todos os campos de pureza salvos para o cluster.
    TopN Número Opcional. Restringe o número de previsões para retornar aos valores mais altos para cada campo de pureza.

    Valor máximo: 10

    Padrão: Retorna todas as informações de pureza para cada campo de pureza.
    Options.toNFields Número Opcional. Restringe o número de campos de pureza retornados a campos com a pureza mais alta para cada cluster.

    Valor máximo: 10

    Padrão: Retorna todos os campos no cluster.
    Tabela 14. Retornos
    Tipo Descrição
    Cadeia de caracteres Cadeia de caracteres formatada em JSON que contém uma lista de clusters com campos de pureza e detalhes.
    Nota:
    Os resultados variam de acordo com as configurações feitas em optionsparâmetro de entrada.

    As informações a seguir ilustram como os resultados de pureza do cluster são classificados e categorizados. Consulte o exemplo para obter a saída real.

    {
  "<clusterID>":[
    // List sorted by purity per field
    { "<fieldName>":[
      // List sorted by purity per field value
      {"<field_val1_1>":"<purity>"},
        // Additional field values
    ]},
    // Additional fields
  ],	  
  // Additional clusters
}
    Cadeia de caracteres.<clusterID> Lista de clusters organizados em ordem decrescente por valor de pureza por cluster.

    Tipo de dados: Matriz
    Cadeia de caracteres.<clusterID>.<field> Lista de objetos que representam campos de pureza organizados em ordem decrescente por valor de pureza por campo. . options.top_n_fieldsa propriedade do parâmetro do objeto de entrada determina o número de campos retornados.
    "<field>":[{"<field_val>":"<purity>"}]}

    Tipo de dados: Matriz
    Cadeia de caracteres.<clusterID>.<field>.<values> Lista de objetos que contêm valor de campo e pureza. Por exemplo, [[5":"100"]] é um campo de prioridade com uma pontuação de 5 e um valor de pureza de 100%. Lista de resultados em ordem decrescente por porcentagem de pureza. . options.top_na propriedade do parâmetro do objeto de entrada determina o número de resultados retornados.

    Tipo de dados: Matriz

    O exemplo a seguir mostra como obter os dois principais resultados de pureza para o campo de categoria em soluções de cluster específicas.

    var solution = new GlideRecord('ml_solution');
solution.addQuery('sys_id', '<clustering_solution_sys_id>');
solution.addQuery('active', 'true');
solution.query();

while (solution.next()) {

  var options = {};
  options.clusterIds = ['1', '3', '5'];
  options.purityFields = ['category'];
  options.topN = '2';
  options.topNFields = '2';

  var clustering = new sn_ml.ClusteringSolutionVersion(solution);
  var results = clustering.getTopNPurityInfo(options);

  gs.info(results);
}

    A saída exibe informações de pureza com base nas configurações fornecidas no parâmetro de opções.

    {"1":[{"category":[{"network":"99.96"},{"inquiry":"0.04"}]}],"3":[{"category":[{"Systems Engineering":"100"}]}],
"5":[{"category":[{"Security":"100"}]}]}

    ClusteringSolutionVersion - getUpdateStatus()

    Obtém o status do trabalho de atualização da solução de cluster mais recente.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 16. Retorna
    Tipo Descrição
    Cadeia de caracteres Estado da atualização da solução de cluster.
    Estados:
    • Erro de rede ou de configuração
    • Ocorreu um erro ao atualizar a solução
    • Buscando arquivos para atualização
    • Preparando dados
    • Desautorizado
    • Atualização concluída
    • A atualização foi cancelada
    • Atualizando solicitação recebida
    • A solicitação de atualização atingiu o tempo limite
    • Atualizando solução
    • Carregando
    • Aguardando

    O exemplo a seguir mostra como obter o status de atualização de uma solução de cluster.

    var myCluster = new sn_ml.ClusteringSolutionStore.get("ml_x_snc_global_global_clustering_solution");

gs.print(JSON.stringify(myCluster.getActiveVersion().getUpdateStatus()));

    Saída:

    "Update Complete"

    ClusteringSolutionVersion - getVersionNumber()

    Obtém o número da versão de um objeto de solução.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Cadeia de caracteres Número da versão.

    O exemplo a seguir mostra como obter um número de versão.

    // Get version number
var mlSolution = sn_ml.ClusteringSolutionStore.get('ml_x_snc_global_global_clustering_solution');

gs.print("Version number: "+JSON.stringify(JSON.parse(mlSolution.getActiveVersion().getVersionNumber()), null, 2));

    Saída:

    Version number: 1

    ClusteringSolutionVersion - Previsão (entrada de objeto, opções de objeto)

    Obtém os dados de entrada para uma previsão.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    entrada Objeto GlideRecord Ou matriz de objetos JSON que contém nomes de campos e valores como pares de chave-valor.
    opções Objeto Valores opcionais para filtrar resultados de previsão.
    {
  "apply_threshold": Boolean,
  "top_n": Number
}
    options.apply_threshold Booliano Sinalizador que indica se o valor limite da solução deve ser verificado e aplicado ao conjunto de resultados.
    Valores válidos:
    • Verdadeiro: Retorna resultados nos quais a confiança é maior que o limite.
    • Falso: Retorna todos os resultados.

    Padrão: Verdadeiro
    opções.top_n Número Se fornecido, retorna os principais resultados, até o número especificado de previsões.
    Tabela 20. Retornos
    Tipo Descrição
    Objeto Objeto JSON que contém os resultados de previsão classificados por sys_id ou record_number. 
    {
    <identifier>: [Array]
}
    <Object>.<identifier> Lista de objetos com detalhes para cada resultado de previsão.

    Tipo de dados: Matriz de objetos

    <identifier>: [
  {
    "confidence": Number,
    "predictedSysId": "String",
    "predictedValue": "String", 
    "threshold": Number
  }
]
    <Object>.<identifier>. <object>.confidence Valor da confiança associada à previsão. Por exemplo, 53,84.

    Tipo de dados: Número
    <Object>.<identifier>. <object>.PredictedSysId O sys_id do valor previsto. Os resultados podem ser de qualquer tabela na qual as informações estão sendo previstas.

    Tipo de dados: Cadeia de caracteres
    <Object>.<identifier>. <object>.PredictedValue Valor que representa o resultado da previsão.

    Tipo de dados: Cadeia de caracteres
    <Object>.<identifier>. <object>.threshold Valor do limite configurado associado à previsão.

    Tipo de dados: Número

    O exemplo a seguir mostra como exibir resultados de previsão para um previsão() Método que usa um GlideRecord por sys_id para entrada e inclui parâmetros opcionais para restringir aos três principais resultados e excluir o valor de limite.

    var mlSolution = sn_ml.ClusteringSolutionStore.get('ml_incident_categorization');

// single GlideRecord input
var input = new GlideRecord("incident");
input.get("<sys_id>");

// configure optional parameters
var options = {};
options.top_n = 3;
options.apply_threshold = false;

var results = mlSolution.getVersion(1).predict(input, options);
// pretty print JSON results
gs.print(JSON.stringify(JSON.parse(results), null, 2));
    {
  "<sys_id/gr>": [
    {
      "confidence": 62.10782320780268,
      "threshold": 20.36,
      "predictedValue": "Clone Issues",
      "predictedSysId": ""
    },
    {
      "confidence": 6.945237375770391,
      "threshold": 16.63,
      "predictedValue": "Instance Administration",
      "predictedSysId": ""
    },
    {
      "confidence": 5.321061076300759,
      "threshold": 23.7,
      "predictedValue": "Administration",
      "predictedSysId": ""
    }
  ]
}

    O exemplo a seguir mostra como exibir resultados de previsão para um previsão() método que usa uma matriz de nomes de campos como pares de chave-valor para entrada e inclui parâmetros opcionais para restringir aos três principais resultados e excluir o valor limite.

    var mlSolution = sn_ml.ClusteringSolutionStore.get("ml_incident_categorization");

// key-value pairs input
var input = [{"short_description":"my email is not working"}, {short_description:"need help with password"}];

// configure optional parameters
var options = {};
options.top_n = 3;
options.apply_threshold = false;
var results = mlSolution.predict(input, options);

// pretty print JSON results
gs.print(JSON.stringify(JSON.parse(results), null, 2));
    {
  "1": [
    {
      "confidence": 37.5023032262591,
      "threshold": 10.72,
      "predictedValue": "Authentication",
      "predictedSysId": ""
    },
    {
      "confidence": 24.439964862166583,
      "threshold": 23.7,
      "predictedValue": "Administration",
      "predictedSysId": ""
    },
    {
      "confidence": 11.736320486031047,
      "threshold": 100,
      "predictedValue": "Security",
      "predictedSysId": ""
    }
  ],
  "2": [
    {
      "confidence": 99,
      "threshold": 17.77,
      "predictedValue": "Email",
      "predictedSysId": ""
    },
    {
      "confidence": 3.182137005157543,
      "threshold": 10.72,
      "predictedValue": "Authentication",
      "predictedSysId": ""
    },
    {
      "confidence": 2.8773826570713514,
      "threshold": -1,
      "predictedValue": "Email (I/f)",
      "predictedSysId": ""
    }
  ]
}

    ClusteringSolutionVersion - submitUpdateJob (opções de objeto)

    Envia trabalhos de atualização de cluster com opções para restringir os resultados a uma tabela específica e filtrar registros correspondentes.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    opções Objeto Objeto JavaScript que contém opções nas quais basear uma atualização de solução de cluster.
    {
        "filter" : "String",
        "table" : "String"
    }
    options.filter Cadeia de caracteres Cadeia de caracteres de consulta codificada no formato Glide padrão. Consulte Cadeias de caracteres de consulta codificadas . Permite a execução de um trabalho de atualização com base no filtro fornecido.
    options.table Cadeia de caracteres Nome da tabela na qual executar um trabalho de atualização.
    Tabela 22. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como enviar um trabalho de atualização.

    var myCluster = new sn_ml.ClusteringSolutionStore.get("ml_x_snc_global_global_clustering_solution");

var options = {"filter" : "precision", "table" : "incident"};

myCluster.getActiveVersion().submitUpdateJob(options);