ClusteringSolutionVersion – Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 16 Minuten Lesedauer

    • Die ClusteringSolutionVersion- API ist ein skriptfähiges Objekt, das in Predictive Intelligence -Speichern verwendet wird.

    Diese(s) Die API erfordert das Plugin Predictive Intelligence (com.glide.platform_ml) und wird im sn_ml- Namespace bereitgestellt.

    Diese API wird zum Arbeiten mit Lösungsversionen verwendet, die auf ClusteringSolution-API -Objekten im ClusteringSolution-Speicherbasieren.

    Das System erstellt bei jedem Training einer Lösungsdefinition eine Lösungsversion. Die meisten Versionen werden während des geplanten Lösungstrainings erstellt.

    Methoden in dieser API sind mit den folgenden ClusteringSolution- Methoden zugänglich:

    ClusteringSolutionVersion – cancelUpdateJob()

    Bricht einen Aktualisierungsauftrag für einen Trainer ab.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein aktiver Trainingsauftrag abgebrochen wird, der mit der Methode „submitTrainingJob() “ übermittelt wurde.

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

mlSolutionVersion.cancelUpdateJob();

    ClusteringSolutionVersion – deleteClusterAssignments(Object options)

    Löscht Clusterzuweisungen aus Zeilen nach Position in der Tabellensequenz oder GlideDateTime.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Optionen Objekt Objekt, das eine Option zum Löschen von Clusterzuweisungen definiert.
    Hinweis:
    Nur eine Löschoption ist gültig.
    options.updatedBis Zeichenfolge Löscht Zeilen für Cluster mit „updated_since“ -Werten, die vor diesem Wert auftreten. Das Format muss als GlideDateTime angegebenwerden.
    { "updatedUntil" : "String" }
    Optionen.SequenzBis Zeichenfolge Löscht Zeilen für Cluster mit insert_sequence- Werten, die vor diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_cluster_detail] auftreten. Der Startpunktwert der Sequenzposition ist 1. 
    { "sequenceUntil" : Number }
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Nummer Anzahl der Zeilen, die aus der Tabelle „ML-Clusterdetail“ [ml_cluster_detail] gelöscht wurden.

    Das folgende Beispiel zeigt, wie Zeilen für Cluster mit der Zeit „ updated_since “ vor „2020-06-28 02:50:53“ gelöscht werden.

    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);

    Ausgabe:

    Number of deleted rows: 6417

    Das folgende Beispiel zeigt, wie Zeilen für Cluster mit „updated_since“ gelöscht werden, die sequenziell vor 1000positioniert sind.

    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);

    Ausgabe:

    Number of deleted rows: 999

    ClusteringSolutionVersion – getClusterAssignments(Object options)

    Ruft Zuweisungen für eine Clustering-Lösung ab.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Optionen Objekt Werte, die zum Eingrenzen der zurückgegebenen Ergebnisse nach Gruppe, Ebene, Systemaktualisierungszeiten und Tabellenzeilennummer innerhalb einer Clusterlösung verwendet werden. Mindestens ein Argument muss angegeben werden.
    {
     "cluster_id": "String",
     "group_by": "String",
     "limit": Number,
     "sequenceSince": Number,
     "sequenceUntil": Number,
     "topNPerCluster": Number,
     "updatedSince": "String",
     "updatedUntil": "String"
}
    options.cluster_id Zeichenfolge Optional. Cluster-ID einer trainierten Lösung in der Tabelle „Cluster-Zusammenfassung“ [ml_cluster_summary].
    options.group_by Zeichenfolge Optional. Gibt das Segmentierungsfeld an, für das Clustermitgliedschaften abgerufen werden sollen, z. B. „assignment_group“.

    Dieses Feld bietet die gleiche Gruppierung wie Optionen im Kontrollkästchen Gruppieren nach im Formular „ Clustering - Definition “. Die bereitgestellten Informationen variieren je nach der im Feld Tabelle ausgewählten Tabelle. Weitere Informationen finden Sie unter Clusterlösungen erstellen und trainieren .
    options.limit Nummer Optional. Maximale Anzahl der abzurufenden Clusterzuweisungen.
    options.sequenzSeit Nummer Startposition in einer Tabellensequenz. Gibt Informationen für Cluster zurück, für die insert_sequence aktiviert und nach diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_cluster_detail] positioniert ist. Der Startpunktwert der Sequenzposition ist 1.
    Optionen.SequenzBis Nummer Gibt Zuweisungen für Cluster zurück mit insert_sequence- Werten, die vor diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_cluster_detail] auftreten. Der Startpunktwert der Sequenzposition ist 1.
    options.topNPerCluster Nummer Anzahl der besten Ergebnisse, die für jedes Cluster empfangen werden sollen.
    options.updatedSince Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit sys_updated_on nach dem in GlideDateTime.
    options.updatedBis Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit sys_updated_on vor dem in GlideDateTime.
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Array Liste der Objekte, die Clusterinformationen enthalten, in aufsteigender Reihenfolge nach cluster_id.
    [
    {
       "cluster_id": "String",
       "group_by": "String",
       "rec_display_id": "String",
       "rec_sys_id": "String"
     }
]
    <object>.cluster_id Eindeutige Clusternummer innerhalb einer Lösung von Clustern.
    <object>.group_by Name des Segmentierungsfelds, das diesem Cluster zugeordnet ist, wenn gruppiert.
    <object>.rec_display_id Datensatztyp und -nummer.
    <object>.rec_sys_id Datensatz-sys_id.

    Das folgende Beispiel zeigt, wie das Objekt options zum Filtern von Clustering-Ergebnissen verwendet wird.

    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);

    Ausgabe:

    [{"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(Object options)

    Ruft Informationen für eine angegebene Clustering-Lösung ab im Store. Die Reinheitsmessung bietet Einblicke als Prozentsatz für die Clusterfelder, auf denen die Reinheit basiert.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Optionen Objekt Optional. Objekt mit Eigenschaften, die das Filtern von Ergebnissen innerhalb einer Clustering-Lösung ermöglichen.
    {
  "clusterId": "String",     
  "groupBy": "String",
  "limit": "String",
  "recSysId": "String",
  "sequenceSince": Number,
  "sequenceUntil": Number,
  "updatedSince": "String",
  "updatedUntil": "String"
}

    Standard: Gibt Clustermitgliedschaften für alle Cluster zurück.
    options.clusterId Zeichenfolge Optional. Cluster-ID einer trainierten Lösung in der Tabelle „Cluster-Zusammenfassung“ [ml_cluster_summary].
    options.groupBy Zeichenfolge Optional. Gibt das Segmentierungsfeld an, für das Clustermitgliedschaften abgerufen werden sollen, z. B. „assignment_group“.

    Dieses Feld bietet die gleiche Gruppierung wie Optionen im Kontrollkästchen Gruppieren nach im Formular „ Clustering - Definition “. Die bereitgestellten Informationen variieren je nach der im Feld Tabelle ausgewählten Tabelle. Weitere Informationen finden Sie unter Clusterlösungen erstellen und trainieren .
    options.limit Nummer Optional. Maximale Anzahl der abzurufenden Clusterzuweisungen.
    Optionen.recSysId Zeichenfolge Optional. Sys_id eines Datensatzes, anhand dessen Cluster-Informationen gefunden werden sollen.
    options.sequenzSeit Nummer Startposition in einer Tabellensequenz. Gibt Informationen für Cluster zurück, für die insert_sequence aktiviert und nach diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_cluster_detail] positioniert ist. Der Startpunktwert der Sequenzposition ist 1.
    Optionen.SequenzBis Nummer Optional. Endposition in einer Tabellensequenz. Gibt Zuweisungen für Cluster zurück mit insert_sequence- Werten, die vor diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_cluster_detail] auftreten. Der Startpunktwert der Sequenzposition ist 1.
    options.updatedSince Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit sys_updated_on nach dem in GlideDateTime -Format.
    options.updatedBis Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit sys_updated_on vor dem in GlideDateTime.
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Array Liste der Objekte, die Clusterinformationen enthalten.
    [
  {   
    "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 Satz von Wörtern, die den Cluster in absteigender Reihenfolge der Häufigkeit beschreiben.

    Datentyp: Zeichenfolge
    <object>.cluster_id Eindeutige Clusternummer innerhalb einer Lösung von Clustern.
    <object>.cluster_quality Zahl zwischen 0 und 100. Höhere Zahlen weisen auf eine höhere Cluster-Dichte hin.

    Datentyp: Zeichenfolge
    <object>.cluster_size Anzahl der Datensätze in einem Cluster.

    Datentyp: Zeichenfolge
    <object>.group_by Name des Segmentierungsfelds, das diesem Cluster zugeordnet ist, wenn gruppiert.

    Datentyp: Zeichenfolge
    <object>.insert_sequenz Sequenzielle Positionsnummer des Clusters in der Tabelle „Cluster-Zusammenfassung“ [ml_cluster_summary].

    Datentyp: Zeichenfolge
    <object>.Reinheit Prozentwert, der die Reinheit der Clusterqualität darstellt.
    <object>.sys_updated_on System -GlideDateTime- Wert, der das Datum und die Uhrzeit der letzten Aktualisierung dieses Clusters angibt.

    Datentyp: Zeichenfolge

    Das folgende Beispiel zeigt, wie der Optionsobjektparameter festgelegt und die gefilterten Clusterergebnisse gedruckt werden.

    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));

    Ausgabe:

    [
  {
    "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()

    Ruft Eigenschaften des Lösungsobjekts ab und Versionsnummer.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Objekt Inhalt der Datensatz- und ClusteringSolution- Versionsdetails. Die Ergebnisse variieren je nach Setup der Objekteigenschaften.
    {
  "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 Die Ergebnisse der EigenschaftJavaScript-Objekt, das Eigenschaften der Algorithmuskonfiguration enthält. variieren je nach dem Wert, der in der Eigenschaft algorithm festgelegt ist.
    'algorithmConfig' : {
  "algorithm": "String",  
  // See algorithmConfig.algorithm setting description for property settings based on algorithm
}

    Datentyp: Objekt.
    <Object>.algorithmConfig.algorithm Methode zum Codieren Ihrer Lösung.
    Eigenschaften für dbscan:
    'algorithmConfig': {
  "algorithm": "dbscan",
  "distanceMetric": "String",
  "epsilon": Number,
  "minimumNeighbours": Number
}
    Eigenschaften für kmeans:
    'algorithmConfig': {
  "algorithm": "kmeans",
  "targetCoverage": Number
}

    Datentyp: Zeichenfolge.
    <Object>.algorithmConfig.distanceMetric Nur DBSCAN-Algorithmus. Abstandsmetrik zum Scannen nach ähnlichen Datenobjekten.

    Datentyp: Zeichenfolge.
    <Object>.algorithmConfig.epslon Nur DBSCAN-Algorithmus. Dezimalwert zwischen 0 und 1, der die Größe des Suchradius für Arbeitsbereiche angibt.

    Datentyp: Zahl.
    <Object>.algorithmConfig.minimumNachbarn Nur DBSCAN-Algorithmus. Mindestanzahl von Nachbarn, die in einem Punkt erforderlich ist, um Teil eines Clusters zu sein. Für levenshteinDistance muss der Wert 1 sein, damit keine Punkte aus dem Datensatz ausgeschlossen werden.

    Datentyp: Zahl.
    <Object>.algorithmConfig.targetCoverage Nur K-Means-Algorithmus. Perzentilenfeld zum Herausfiltern von Datensätzen, die einander weniger ähnlich sind.

    Datentyp: Zahl.
    <Object>.datasetEigenschaften

    Listet die Eigenschaften des DatatsetDefinition- Objekts auf, das der Lösung zugeordnet ist.

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

    Datentyp: Objekt.
    <Object>.datasetProperties.tableName Name der Tabelle für den Datensatz. Beispiel: "tableName" : "Incident".

    Datentyp: Zeichenfolge.
    <Object>.datasetProperties.fieldNames Liste der Feldnamen aus der angegebenen Tabelle als Zeichenfolgen. Beispiel: „fieldNames“ : ["short_description", "priority"].

    Datentyp: Array.
    <Object>.datasetProperties.fieldNames.fieldDetails Liste der JavaScript-Objekte, die Feldeigenschaften angeben. 
    [
  {
    "name": "String",
    "type": "String"
  }
]

    Datentyp: Array.
    <Object>.datasetProperties.fieldNames.fieldDetails.<object>.name Name des Felds, das den Typ der Informationen definiert, auf die dieser Datensatz beschränkt werden soll.

    Datentyp: Zeichenfolge.
    <Object>.datasetProperties.fieldDetails.<object>.type ML-Feldtyp (maschinelles Lernen).

    Datentyp: Zeichenfolge.
    <Object>.datasetProperties.fieldDetails.encodedQuery Codierte Abfragezeichenfolge im Standard-Glide-Format. Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen.

    Datentyp: Zeichenfolge.
    <Object>.domainName Domänenname, der diesem Datensatz zugeordnet ist. Siehe Domänentrennung und Predictive Intelligence.

    Datentyp: Zeichenfolge.
    Objekt.encoderEigenschaften Encoder-Objekt, das dieser Lösung zugewiesen ist. Siehe Encoder: Encoder(Object config).

    Datentyp: Objekt.
    Objekt.groupByFieldName Feldname, nach dem das System Datensätze in einem oder mehreren Clustern gruppiert.

    Datentyp: Zeichenfolge
    Object.inputFieldNames Liste der Eingabefeldnamen als Zeichenfolgen. Das Modell verwendet die folgenden Felder, um Vorhersagen zu treffen.

    Datentyp: Zeichenfolge.
    <Object>.ist Aktiv Kennzeichnung, die angibt, ob diese Version aktiv ist.
    Gültige Werte:
    • true: Version ist aktiv.
    • false: Version ist nicht aktiv.

    Datentyp: Zeichenfolge
    <Object>.Bezeichnung Identifiziert die Vorhersageaufgabe. 
    {
  "label": "my first prediction"
}

    Datentyp: Zeichenfolge.
    <Object>.minDatensätzeProCluster Mindestanzahl von Datensätzen, die in einem Cluster zulässig ist.

    Datentyp: Zahl.
    <Object>.name Vom System zugewiesener Name.

    Datentyp: Zeichenfolge.
    <Object>.processingLanguage Verarbeitungssprache im aus zwei Buchstaben bestehenden ISO 639-1-Sprachcodeformat.

    Datentyp: Zeichenfolge.
    <Object>.Bereich Objektumfang. Derzeit ist der einzige gültige Wert global.

    Datentyp: Zeichenfolge
    <Object>.Stoppwörter Optional. Voreingestellte Liste von Zeichenfolgen, die das System basierend auf der Eigenschaftseinstellung language automatisch generiert. Weitere Informationen finden Sie unter Benutzerdefinierte Stoppwortlisten erstellen.

    Datentyp: Array.
    <Object>.trainingHäufigkeit Die Häufigkeit, mit der das Modell neu trainiert werden soll.
    Mögliche Werte:
    • jeden_30_Tage
    • alle_60_Tage
    • all_90_days
    • all_120_days
    • all_180_days
    • run_once
    Standard: run_once

    Datentyp: Zeichenfolge.
    <Object>.UpdateHäufigkeit Die Häufigkeit, mit der das Modell für die Lösungsdefinition neu erstellt werden muss.
    Mögliche Werte:
    • do_not_update
    • jeden_1_Tag
    • jede_1_Stunde
    • jede_6_Stunden
    • all_12_hours
    • jede_1_Minute
    • alle_15_Minuten
    • jede_30_Minuten
    Standard: do_not_update

    Datentyp: Zeichenfolge
    <Object>.Versionsnummer Versionsnummer des ClusteringSolution- Objekt.

    Im folgenden Beispiel werden Eigenschaften der aktiven Objektversion im Store abgerufen.

    // 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));

    Ausgabe:

    *** 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(Boolean includeDetails)

    Ruft den Abschlussstatus des Trainings ab.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    includeDetails Boolean

    Kennzeichnung, die angibt, ob der Status detailszurückgegeben werden soll.

    Gültige Werte:
    • true: Zusätzliche Details zurückgeben.
    • false: Keine zusätzlichen Details zurückgeben.

    Standardwert: False
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Objekt JavaScript-Objekt, das Informationen zum Trainingsstatus für enthält ein ClusteringSolution- Objekt.
    {
  "state": "String",
  "percentComplete": "Number as a String",
  "hasJobEnded": "Boolean value as a String",
  "details": {Object}
}
    <Object>.Status Abschlussstatus des Trainings. Wenn der Trainingsauftrag einen Endstatus erreicht, verlässt der Auftrag diesen Status nicht. Wenn der Status abgeschlossen ist, wird die Eigenschaft hasJobEnded auf truefestgelegt.
    Mögliche Werte:
    • fetching_files_for_training
    • vorbereiten_daten
    • Erneut versuchen
    • solution_cancelled (Terminal)
    • solution_complete (Terminal)
    • solution_error (Terminal)
    • solution_incomplete
    • „training_request_received“
    • „training_request_timed_out “ (Terminal)
    • „training_solution“
    • wird hochgeladen
    • wait_for_training

    Datentyp: Zeichenfolge
    <Object>.hasJobEnded

    Kennzeichnung, die angibt, ob das Training abgeschlossen ist.

    Gültige Werte:
    • true: Training ist abgeschlossen.
    • false: Training ist unvollständig.

    Datentyp: Boolescher Wert als Zeichenfolge
    <Object>.percentComplete Zahl zwischen null und 100, die den Abschluss des Trainings in Prozent angibt. Wenn der Prozentsatz der Fertigstellung weniger als 100 beträgt, befindet sich die Aufgabe möglicherweise in einem Endstatus. Zum Beispiel, wenn beim Training eine Zeitüberschreitung auftritt.

    Datentyp: Zahl als Zeichenfolge
    <Object>.Details Objekt mit einer Liste zusätzlicher Schulungsdetails.

    Datentyp: Objekt

    Das folgende Beispiel zeigt ein erfolgreiches Ergebnis mit abgeschlossenem Training.

    // 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)));

    Ausgabe:

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

    Das folgende Beispiel zeigt ein nicht erfolgreiches Ergebnis mit abgeschlossenem Training.

    // 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));

    Ausgabe:

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

    ClusteringSolutionVersion – getTopNPurityInfo(Object options)

    Ruft die besten Reinheitsergebnisse für eine Clustering-Lösung ab. Die Reinheitsmessung bietet Einblicke als Prozentsatz für die Clusterfelder, auf denen die Reinheit basiert.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Optionen Objekt Optionen, die die Anzahl und das Format der Reinheitsergebnisse des obersten Clusters bestimmen.
    {
  "clusterIds": [Array],
  "groupBy": [Array],
  "purityFields": [Array],
  "topN": Number,
  "topNFields": Number
}
    options.clusterIds Array Optional. Liste der als Zeichenfolgen bereitgestellten Cluster-IDs. Eine Cluster-ID wird in der Tabelle „Cluster-Zusammenfassung“ [ml_cluster_summary] bereitgestellt. Wenn angegeben, gibt diese Methode Reinheitsclusterinformationen für jedes angegebene Cluster zurück.

    Standard: Diese Methode gibt Reinheitsinformationen für alle Cluster zurück.
    options.groupBy Array Optional. Listen Sie von group_by-Feldzeichenfolgen aus Ihrer Tabelle auf, damit das System die Klasse identifizieren kann, die im Cluster am häufigsten vorkommt. Wenn angegeben, werden Reinheitsinformationen für Clusterlösungen mithilfe von group_by-Feldern zurückgegeben. In der Tabelle „Clusterzusammenfassung“ [ml_cluster_summary] werden Cluster und alle zugehörigen Werte für Gruppieren nach aufgelistet.

    Dieses Feld gilt nur für Cluster, die Gruppieren nach in der Clustering-Definition verwenden. Berechtigte Felder werden im Feld Tabelle aufgelistet. Weitere Informationen zur Funktion „Gruppieren nach“ finden Sie unter Erstellen und Trainieren einer Clustering-Lösung.
    options.purityFields Array Optional. Liste der Reinheitsfeldzeichenfolgen. Wenn angegeben, gibt diese Methode nur Informationen für diese Reinheitsfelder zurück. Sie können Reinheitswerte für einen Cluster in den Listen der Tabelle „Cluster-Zusammenfassung“ [ml_cluster_summary] anzeigen.
    Hinweis:
    Wenn sowohl purity_fields als auch top_n_fields angegeben werden, gibt diese Methode zuerst top_n_fields zurück und wählt dann Felder aus purity_fieldsaus.

    Standard: Gibt Reinheitsinformationen für alle für den Cluster gespeicherten Reinheitsfelder zurück.
    options.topN Nummer Optional. Schränkt die Anzahl der Vorhersagen so ein, dass für jedes Reinheitsfeld die höchsten Werte zurückgegeben werden.

    Maximalwert: 10

    Standard: Gibt alle Reinheitsinformationen für jedes Reinheitsfeld zurück.
    options.topNFields Nummer Optional. Schränkt die Anzahl der zurückgegebenen Reinheitsfelder auf Felder mit der höchsten Reinheit für jedes Cluster ein.

    Maximalwert: 10

    Standard: Gibt alle Felder im Cluster zurück.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge JSON-formatierte Zeichenfolge, die eine Liste von Clustern mit Reinheitsfeldern und Details enthält.
    Hinweis:
    Die Ergebnisse variieren je nach Einstellungen im Eingabeparameter options.

    Die folgenden Informationen zeigen, wie die Ergebnisse der Clusterreinheit sortiert und kategorisiert werden. Informationen zur tatsächlichen Ausgabe finden Sie im Beispiel.

    {
  "<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
}
    Zeichenfolge.<clusterID> Liste der Cluster, die in absteigender Reihenfolge nach Reinheitswert pro Cluster sortiert sind.

    Datentyp: Array
    Zeichenfolge.<clusterID> .<field> Liste von Objekten, die Reinheitsfelder darstellen, in absteigender Reihenfolge nach Reinheitswert pro Feld angeordnet. Die Parametereigenschaft des Eingabeobjekts options.top_n_fields bestimmt die Anzahl der zurückgegebenen Felder.
    "<field>":[{"<field_val>":"<purity>"}]}

    Datentyp: Array
    Zeichenfolge.<clusterID> .<field> .<values> Liste der Objekte, die den Feldwert und die Reinheit enthalten. Beispiel: {"priority":[{"5":"100"}]} ist ein Prioritätsfeld mit einer Punktzahl von 5 und einem Reinheitswert von 100 Prozent. Ergebnisliste in absteigender Reihenfolge nach Reinheitsprozentsatz. Die Parametereigenschaft des Eingabeobjekts options.top_n bestimmt die Anzahl der zurückgegebenen Ergebnisse.

    Datentyp: Array

    Das folgende Beispiel zeigt, wie Sie die beiden besten Reinheitsergebnisse für das Kategoriefeld in bestimmten Clusterlösungen erhalten.

    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);
}

    Die Ausgabe zeigt Reinheitseinblicke basierend auf den Einstellungen im Optionsparameter an.

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

    ClusteringSolutionVersion – getUpdateStatus()

    Ruft den Status des letzten Aktualisierungsauftrags der Clustering-Lösung ab.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Status der Aktualisierung der Clustering-Lösung.
    Status:
    • Konfigurations- oder Netzwerkfehler
    • Fehler beim Aktualisieren der Lösung
    • Dateien zum Aktualisieren werden abgerufen
    • Daten werden vorbereitet.
    • Nicht autorisiert
    • Update abgeschlossen
    • Aktualisierung wird abgebrochen
    • Aktualisierungsanforderung erhalten
    • Zeitüberschreitung bei Aktualisierungsanforderung
    • Lösung wird aktualisiert
    • Lädt hoch
    • Warten

    Das folgende Beispiel zeigt, wie Sie den Aktualisierungsstatus einer Clustering-Lösung abrufen.

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

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

    Ausgabe:

    "Update Complete"

    ClusteringSolutionVersion – getVersionNumber()

    Ruft die Versionsnummer von ab ein Lösungsobjekt.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Versionsnummer.

    Das folgende Beispiel zeigt, wie Sie eine Versionsnummer erhalten.

    // 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));

    Ausgabe:

    Version number: 1

    ClusteringSolutionVersion – prediction(Object input, Object options)

    Ruft die Eingabedaten für eine Vorhersage ab.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Eingabe Objekt GlideRecord oder ein Array von JSON-Objekten, die Feldnamen und Werte als Schlüssel-Wert-Paare enthalten.
    Optionen Objekt Optionale Werte zum Filtern von Vorhersageergebnissen.
    {
  "apply_threshold": Boolean,
  "top_n": Number
}
    options.apply_threshold Boolean Kennzeichnung, die angibt, ob der Schwellenwert für die Lösung überprüft und auf die Ergebnismenge angewendet werden soll.
    Gültige Werte:
    • true: Ergebnisse zurückgeben, bei denen die Konfidenz größer als der Schwellenwert ist.
    • false: Alle Ergebnisse zurückgeben.

    Standardwert: True
    options.top_n Nummer Wenn angegeben, werden die besten Ergebnisse bis zur angegebenen Anzahl von Vorhersagen zurückgegeben.
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Objekt JSON-Objekt, das die Vorhersageergebnisse enthält, sortiert nach sys_id oder record_number. 
    {
    <identifier>: [Array]
}
    <Object>.<identifier> Liste von Objekten mit Details für jedes Vorhersageergebnis.
    <identifier>: [
  {
    "confidence": Number,
    "predictedSysId": "String",
    "predictedValue": "String", 
    "threshold": Number
  }
]

    Datentyp: Array
    <Object><identifier> .<object>.Konfidenz Wert der Konfidenz, die der Vorhersage zugeordnet ist. Beispiel: 53,84.

    Datentyp: Zahl
    <Object><identifier> .<object>.predictedSysId Die sys_id des vorhergesagten Werts. Die Ergebnisse können aus jeder Tabelle stammen, in der Informationen vorhergesagt werden.

    Datentyp: Zeichenfolge
    <Object><identifier> .<object>.predictedValue Wert, der das Vorhersageergebnis darstellt.

    Datentyp: Zeichenfolge
    <Object><identifier> .<object>.threshold Wert des konfigurierten Schwellenwerts, der der Vorhersage zugeordnet ist.

    Datentyp: Zahl

    Das folgende Beispiel zeigt, wie Vorhersageergebnisse für eine prediction ()- Methode angezeigt werden, die einen GlideRecord nach sys_id als Eingabe akzeptiert und optionale Parameter enthält, um die ersten drei Ergebnisse zu beschränken und den Schwellenwert auszuschließen.

    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": ""
    }
  ]
}

    Das folgende Beispiel zeigt, wie Vorhersageergebnisse für eine prediction ()- Methode angezeigt werden, die ein Array von Feldnamen als Schlüssel-Wert-Paare für die Eingabe verwendet und optionale Parameter enthält, um die ersten drei Ergebnisse zu beschränken und den Schwellenwert auszuschließen.

    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(Object options)

    Übermittelt Clustering-Aktualisierungsaufträge mit Optionen, um die Ergebnisse auf eine bestimmte Tabelle einzugrenzen und nach übereinstimmenden Datensätzen zu filtern.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Optionen Objekt JavaScript-Objekt, das Optionen enthält, auf denen eine Clustering-Lösungsaktualisierung basieren soll.
    {
        "filter" : "String",
        "table" : "String"
    }
    options.filter Zeichenfolge Codierte Abfragezeichenfolge im Standard-Glide-Format. Weitere Informationen finden Sie unter Codierte Abfragezeichenfolgen. Ermöglicht die Ausführung eines Aktualisierungsauftrags basierend auf dem angegebenen Filter.
    options.table Zeichenfolge Name der Tabelle, für die ein Aktualisierungsauftrag ausgeführt werden soll.
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Aktualisierungsauftrag gesendet wird.

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

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

myCluster.getActiveVersion().submitUpdateJob(options);