EncoderStore – Global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • A API EncoderStore fornece métodos para armazenar e recuperar codificadores.

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

    EncoderStore - add(Object mlEncoder)

    Adiciona um novo codificador objeto de solução ao armazenamento e retorna um nome exclusivo.

    Nota:
    Os valores de rótulo não precisam ser exclusivos. Por exemplo, se você executar este método com o mesmo rótulo 10 vezes, este método adicionará 10 objetos diferentes com nomes exclusivos ao armazenamento.
    Tabela 1. Parâmetros
    Nome Tipo Descrição
    mlEncoder Codificador Codificador () objeto a ser adicionado ao armazenamento.
    Tabela 2. Retornos
    Tipo Descrição
    Cadeia de caracteres Nome da solução gerada pelo sistema.

    O exemplo a seguir mostra como adicionar um codificador ao armazenamento. Usar codificador - submitTrainingJob() para executar o trabalho de treinamento depois de adicioná-lo ao armazenamento.

    // Create a dataset 
    var myData = new sn_ml.DatasetDefinition({
    
      'tableName' : 'incident',
      'fieldNames' : ['assignment_group', 'short_description', 'description'],
      'encodedQuery' : 'activeANYTHING'
    
    });
    
    // Create a solution 
    var myEncoder = new sn_ml.Encoder({
    
      'label': "my encoder definition",
      'datasets' : [myData],
      'predictedFieldName' : 'assignment_group',
      'inputFieldNames':['short_description']
    
    });
    
    // Add the encoder to the store to later be able to retrieve it.
    var my_unique_name = sn_ml.EncoderStore.add(myEncoder);

    EncoderStore - deleteObject(String name)

    Remove um objeto de codificador especificado do armazenamento.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome do codificador () objeto a ser excluído.
    Tabela 4. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como excluir um codificador do armazenamento.

    sn_ml.EncoderStore.deleteObject("ml_sn_global_global_encoder");

    EncoderStore - get(nome da cadeia de caracteres)

    Obtém um objeto de codificador de um armazenamento.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome de um codificador em um armazenamento.
    Tabela 6. Retornos
    Tipo Descrição
    Objeto Codificador objeto. Retorna um erro se o objeto não existir.

    O exemplo a seguir mostra como obter um objeto de codificador do armazenamento usando o método get() e exibir seu status de treinamento usando os métodos Codificador - getActiveVersion() e EncoderVersion - getStatus().

    // Get status
    var myEncoder = sn_ml.EncoderStore.get('ml_incident_categorization');
    
    gs.print(JSON.stringify(JSON.parse(myEncoder.getActiveVersion().getStatus(), null, 2)));

    Saída:

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

    EncoderStore - getAllNames(Opções de objeto)

    Obtém os nomes de todos os registros de definição do codificador no armazenamento.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    opções Objeto Opções para restringir resultados nas propriedades especificadas.
    {
      "label": "String",
      "domainName": "String",
      "scope": "String"
    };
    opções.rótulo Cadeia de caracteres Opcional. Rótulo do seu objeto de solução.
    opções.domainName Cadeia de caracteres Opcional. Nome do domínio do objeto de solução. Consultar Separação de domínios e Inteligência preditiva.
    opções.escopo Cadeia de caracteres Opcional. Nome de um escopo da aplicação para o objeto de solução.
    Tabela 8. Retornos
    Tipo Descrição
    Matriz Lista de cadeias de caracteres que representam nomes de objeto do codificador no armazenamento.

    No exemplo a seguir, o método getAllNames() retorna uma lista de todos os nomes no armazenamento.

    gs.print(JSON.stringify(JSON.parse(sn_ml.EncoderStore.getAllNames()), null, 2));

    Saída:

    [
      "ml_x_snc_global_global_classification_word_corpus",
      "ml_x_snc_global_global_predictability_estimate",
      "GloVe",
      "ml_x_snc_global_global_encoder",
      "ml_x_snc_global_global_predictability_estimate_1"
    ]

    No exemplo a seguir, o método getAllNames() retorna somente nomes associados a valores definidos no parâmetro options.

    var options = {
      'label' : 'my encoder definition',
      'domainName' : 'global',
      'scope' : 'global'
    };
    var solNames = sn_ml.EncoderStore.getAllNames(options);
    gs.print(JSON.stringify(JSON.parse(solNames), null, 2));

    Saída:

    [
      "ml_x_snc_global_global_my_encoder_definition"
    ]

    EncoderStore - update (nome da cadeia de caracteres, objeto mlEncoder)

    Atualiza um objeto de codificador em um armazenamento.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome do codificador a ser atualizado.
    mlEncoder Codificador Codificador () propriedades do objeto a serem atualizadas.
    Tabela 10. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como atualizar um objeto codificador no armazenamento.

    var encoderUpdate = new sn_ml.Encoder({
      'label': 'my encoder definition',
      'dataset' : myData,
      'predictedFieldName' : 'assignment_group',
      'inputFieldNames': ['short_description']
    });
    
    sn_ml.EncoderStore.update('ml_sn_global_global_incident_service', encoderUpdate);