ClusteringSolutionVersion – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 16 Minuten Lesedauer

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

    Diese(s) API erfordert Predictive Intelligence Plugin (com.glide.platform_ml) und wird in bereitgestellt sn_ml Namespace.

    Wird für die Arbeit mit Lösungsversionen basierend auf verwendet ClusteringSolution-API Objekte in ClusteringSolution Store .

    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 wie folgt zugänglich ClusteringSolution Methoden:

    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 Sie einen aktiven Schulungsauftrag abbrechen, der mit übermittelt wurde SubmitTrainingJob() Methode.

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

mlSolutionVersion.cancelUpdateJob();

    ClusteringSolutionVersion – deleteClusterAssignments(Objektoptionen)

    Löscht Clusterzuweisungen aus Zeilen nach Position in 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.
    Optionen.updatedUntil Zeichenfolge Löscht Zeilen für Cluster mit Aktualisiert_seit Werte vor diesem Wert. Format muss als angegeben werden GlideDateTime .
    { "updatedUntil" : "String" }
    options.sequenceUntil Zeichenfolge Löscht Zeilen für Cluster Mit INSERT_Sequence Werte vor diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_Cluster_Detail]. Der Startpunktwert der Sequenzposition ist 1. 
    { "sequenceUntil" : Number }
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Anzahl 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 gelöscht werden Aktualisiert_seit Zeit davor '28.06.2020 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);

    Ausgabe:

    Number of deleted rows: 6417

    Das folgende Beispiel zeigt, wie Zeilen für Cluster mit gelöscht werden Aktualisiert_seit Die sequenziell vor positioniert werden 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);

    Ausgabe:

    Number of deleted rows: 999

    ClusteringSolutionVersion – getClusterAssignments (Objektoptionen)

    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 in einer Clustering-Lösung verwendet werden sollen. 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 „Clusterzusammenfassung“ [ml_Cluster_summary].
    options.group_by Zeichenfolge Optional. Gibt das Segmentierungsfeld an, für das Clustermitgliedschaften abgerufen werden sollen, z. B. „Assignation_Group“.

    Dieses Feld bietet die gleiche Gruppierung wie die im bereitgestellten Optionen Verwenden Sie Gruppieren Nach Kontrollkästchen in Clustering-Definition Formular. Die bereitgestellten Informationen variieren je nach der in ausgewählten Tabelle Tabelle Feld. Weitere Informationen finden Sie unter Erstellen und trainieren Sie eine Clustering-Lösung .
    Optionen.Limit Anzahl Optional. Maximale Anzahl abzurufender Clusterzuweisungen.
    options.sequenceSince Anzahl Startposition in einer Tabellensequenz. Gibt Informationen für Cluster zurück, bei denen „insert_Sequence“ aktiviert und nach diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_Cluster_Detail] positioniert ist. Der Startpunktwert der Sequenzposition ist 1.
    options.sequenceUntil Anzahl Gibt Zuweisungen für Cluster zurück Mit INSERT_Sequence Werte vor diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_Cluster_Detail]. Der Startpunktwert der Sequenzposition ist 1.
    Options.topNPerCluster Anzahl Anzahl der Top-Ergebnisse, die für jeden Cluster empfangen werden sollen.
    Optionen.AktualisiertSeit Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit zurück sys_updated_on Nach dem in angegebenen Wert GlideDateTime .
    Optionen.updatedUntil Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit zurück sys_updated_on Vor dem in angegebenen Wert GlideDateTime .
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Array Liste von Objekten mit Clusterinformationen in steigender 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 Clusterlösung.
    <object>.Group_by Wenn gruppiert, Name des Segmentierungsfelds, das diesem Cluster zugeordnet ist.
    <object>.REC_Display_ID Datensatztyp und -Nummer.
    <object>.REC_sys_ID SYS_ID des Datensatzes

    Das folgende Beispiel zeigt die Verwendung von optionsObjekt zum Filtern von Clustering-Ergebnissen.

    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(Objektoptionen)

    Ruft Informationen für eine angegebene Clustering-Lösung ab Im Store. Die Reinheitsmessung bietet Einblicke als Prozentsatz für die Clustering-Felder, 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: Clustermitgliedschaften für alle Cluster zurückgeben.
    Optionen.clusterId Zeichenfolge Optional. Cluster-ID einer trainierten Lösung in der Tabelle „Clusterzusammenfassung“ [ml_Cluster_summary].
    options.groupBy Zeichenfolge Optional. Gibt das Segmentierungsfeld an, für das Clustermitgliedschaften abgerufen werden sollen, z. B. „Assignation_Group“.

    Dieses Feld bietet die gleiche Gruppierung wie die im bereitgestellten Optionen Verwenden Sie Gruppieren Nach Kontrollkästchen in Clustering-Definition Formular. Die bereitgestellten Informationen variieren je nach der in ausgewählten Tabelle Tabelle Feld. Weitere Informationen finden Sie unter Erstellen und trainieren Sie eine Clustering-Lösung .
    Optionen.Limit Anzahl Optional. Maximale Anzahl abzurufender Clusterzuweisungen.
    Optionen.recSysId Zeichenfolge Optional. SYS_ID eines Datensatzes, anhand dessen Clusterinformationen gefunden werden sollen.
    options.sequenceSince Anzahl Startposition in einer Tabellensequenz. Gibt Informationen für Cluster zurück, bei denen „insert_Sequence“ aktiviert und nach diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_Cluster_Detail] positioniert ist. Der Startpunktwert der Sequenzposition ist 1.
    options.sequenceUntil Anzahl Optional. Endposition in einer Tabellensequenz. Gibt Zuweisungen für Cluster zurück Mit INSERT_Sequence Werte vor diesem Wert in der Tabelle „ML-Clusterdetail“ [ml_Cluster_Detail]. Der Startpunktwert der Sequenzposition ist 1.
    Optionen.AktualisiertSeit Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit zurück sys_updated_on Nach dem in angegebenen Wert GlideDateTime Format.
    Optionen.updatedUntil Zeichenfolge Optional. Datum und Uhrzeit. Gibt Informationen für Cluster mit zurück sys_updated_on Vor dem in angegebenen Wert GlideDateTime .
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Array Liste von Objekten mit Clusterinformationen.
    [
  {   
    "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 Clusterlösung.
    <object>.Cluster_Quality Zahl von 0 bis 100. Höhere Zahlen zeigen eine höhere Clusterdichte an.

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

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

    Datentyp: Zeichenfolge
    <object>.INSERT_Sequence Sequenzielle Positionsnummer des Clusters in der Tabelle „Clusterzusammenfassung“ [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 darstellt.

    Datentyp: Zeichenfolge

    Das folgende Beispiel zeigt, wie Sie den Optionsobjektparameter festlegen und die gefilterten Cluster-Ergebnisse drucken.

    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 Lösungsobjekteigenschaften ab Und Versionsnummer.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Objekt Inhalt des Datensatzes und ClusteringSolution Versionsdetails. Die Ergebnisse variieren je nach Setup der Objekteigenschaft.
    {
  "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 JavaScript-Objekt mit Algorithmuskonfigurationseigenschaften.Eigenschaftenergebnisse variieren je nach Wert, der in festgelegt ist algorithmEigenschaft.

    Datentyp: Objekt

    'algorithmConfig' : {
  "algorithm": "String",  
  // See algorithmConfig.algorithm setting description for property settings based on algorithm
}
    <Object>.AlgorithmConfig.Algorithmus 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. Entfernungsmetrik zum Scannen nach ähnlichen Datenobjekten.

    Datentyp: Zeichenfolge
    <Object>.AlgorithmConfig.epsilon Nur DBSCAN-Algorithmus. Dezimalwert zwischen 0 und 1, der die Größe des Suchradius des Arbeitsbereichs darstellt.

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

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

    Datentyp: Zahl
    <Object>.DatasetEigenschaften

    Listet die Eigenschaften von auf DatatsetDefinition Objekt, das der Lösung zugeordnet ist.

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

    Datentyp: Objekt
    <Object>.DatasetProperties.encodedQuery Codierte Abfragezeichenfolge im Standard-Glide-Format. Siehe Codierte Abfragezeichenfolgen .

    Datentyp: Zeichenfolge
    <Object>.DatenbasisEigenschaften.Felddetails Liste der JavaScript-Objekte, die Feldeigenschaften angeben.

    Datentyp: Array von Objekten

    [
  {
    "name": "String",
    "type": "String"
  }
]
    <Object>.datasetProperties.fieldDetails.name Name des Felds, das den Typ der Informationen definiert, auf die dieser Datensatz beschränkt werden soll.

    Datentyp: Zeichenfolge
    <Object>.DatasetProperties.fieldDetails.type Feldtyp für maschinelles Lernen.

    Datentyp: Zeichenfolge
    <Object>.DatenbasisEigenschaften.Feldnamen Liste der Feldnamen aus der angegebenen Tabelle als Zeichenfolgen. Beispiel: „Feldnamen“: [„short_description“, „Priorität“] .

    Datentyp: Array
    <Object>.DatasetProperties.tableName Name der Tabelle für den Datensatz. Beispiel: „Tabellenname“: „Incident“ .

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

    Datentyp: Zeichenfolge
    Object.encoderEigenschaften Encoderobjekt, das dieser Lösung zugewiesen ist. Siehe Encoder – Encoder (Objektkonfiguration).

    Datentyp: Objekt
    Object.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 diese Felder, um Vorhersagen zu treffen.

    Datentyp: Zeichenfolge
    <Object>.Isaktiv Kennzeichnung, die angibt, ob diese Version aktiv ist.
    Gültige Werte:
    • Wahr: Version ist aktiv.
    • Falsch: Version ist nicht aktiv.

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

    Datentyp: Zeichenfolge
    <Object>.MinRecordsPerCluster Mindestanzahl von Datensätzen, die in einem Cluster zulässig sind.

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

    Datentyp: Zeichenfolge
    <Object>.ProcessingLanguage Sprache wird im zweistelligen ISO 639-1-Sprachcodeformat verarbeitet.

    Datentyp: Zeichenfolge
    <Object>.Umfang Objektbereich. Derzeit ist der einzige gültige Wert Global .

    Datentyp: Zeichenfolge
    <Object>.Stoppwörter Optional. Voreingestellte Liste von Zeichenfolgen, die das System automatisch basierend auf generiert languageEigenschaftseinstellung. Weitere Informationen finden Sie unter Erstellen Sie eine anwenderdefinierte Stoppwortliste .

    Datentyp: Array
    <Object>.TrainingHäufigkeit Die Häufigkeit, mit der das Modell neu trainiert werden soll.
    Mögliche Werte:
    • Every_30_days
    • Every_60_days
    • Every_90_days
    • Every_120_days
    • Every_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
    • Every_1_day
    • Every_1_Hour
    • Every_6_hours
    • Every_12_hours
    • Jede_1_Minute
    • Alle_15_Minuten
    • Alle_30_Minuten
    Standard: Do_Not_Update

    Datentyp: Zeichenfolge
    <Object>.VersionNumber Versionsnummer von ClusteringSolution Objekt.

    Das folgende Beispiel ruft Eigenschaften der aktiven Objektversion im Store ab.

    // 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(boolesche includeDetails)

    Ruft den Abschlussstatus des Trainings ab.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    EinbeziehenDetails Boolean Kennzeichnung, die angibt, ob der Status zurückgegeben werden soll details.
    Gültige Werte:
    • Wahr: Gibt zusätzliche Details zurück.
    • Falsch: Keine zusätzlichen Details zurückgeben.

    Standardwert: False
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Objekt JavaScript-Objekt mit Schulungsstatusinformationen fürA ClusteringSolution Objekt.
    {
  "state": "String",
  "percentComplete": "Number as a String",
  "hasJobEnded": "Boolean value as a String",
  "details": {Object}
}
    <Object>.Status Abschlussstatus des Trainings. Wenn der Schulungsauftrag einen Terminalstatus erreicht, verlässt der Auftrag diesen Status nicht. Wenn der Status Terminal ist, wird die hasJobEndedEigenschaft ist auf festgelegt Wahr .
    Mögliche Werte:
    • Abrufen_Dateien_für_Training
    • Preparing_Data
    • Erneut versuchen
    • Solution_CANCEL (Terminal)
    • Solution_Complete (Terminal)
    • Solution_error (Terminal)
    • Lösung_unvollständig
    • Training_Request_Received
    • Training_Request_Timed_out (Terminal)
    • Training_Solution
    • Uploading_Solution
    • Warten_auf_Training

    Datentyp: Zeichenfolge
    <Object>.HasJobEnded Kennzeichnung, die angibt, ob das Training abgeschlossen ist.
    Gültige Werte:
    • Wahr: Training ist abgeschlossen.
    • Falsch: Training ist unvollständig.

    Datentyp: Boolescher Wert als Zeichenfolge
    <Object>.Prozent abgeschlossen Abschluss des Trainings in Prozent. Wenn der Fertigstellungsprozentsatz kleiner als 100 ist, befindet sich der Auftrag möglicherweise in einem Terminalstatus. Zum Beispiel, wenn das Training eine Zeitüberschreitung hat.

    Datentyp: Zahl als Zeichenfolge

    Bereich: 0 bis 100
    <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(Objektoptionen)

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

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Optionen Objekt Optionen, die die Anzahl und das Format der Reinheit des Top-Clusters bestimmen.
    {
  "clusterIds": [Array],
  "groupBy": [Array],
  "purityFields": [Array],
  "topN": Number,
  "topNFields": Number
}
    Optionen.clusterIds Array Optional. Liste der Cluster-IDs, die als Zeichenfolgen bereitgestellt werden. Eine Cluster-ID wird in der Tabelle „Clusterzusammenfassung“ [ml_Cluster_summary] angegeben. Falls angegeben, gibt diese Methode Reinheit-Cluster-Informationen für jeden angegebenen Cluster zurück.

    Standard: Diese Methode gibt Reinheitsinformationen für alle Cluster zurück.
    options.groupBy Array Optional. Liste Von Feldzeichenfolgen „Group_by“ aus Ihrer Tabelle, damit das System die Klasse identifizieren kann, die im Cluster am häufigsten auftritt. Wenn angegeben, werden Reinheit-Informationen für Clusterlösungen mithilfe von Feldern „Group_by“ zurückgegeben. Die Tabelle „Clusterzusammenfassung“ [ml_Cluster_summary] listet Cluster und alle zugehörigen Werte für „Gruppieren nach“ auf.

    Dieses Feld gilt nur für Cluster, die „Gruppieren nach“ in der Clustering-Definition verwenden. Berechtigte Felder werden in aufgeführt Tabelle Feld. Weitere Informationen zur Funktion „Gruppieren nach“ finden Sie unter Erstellen und trainieren Sie eine Clustering-Lösung .
    Optionen.purityFelder 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 Tabellenlisten „Clusterzusammenfassung“ [ml_Cluster_summary] anzeigen.
    Hinweis:
    Wenn beides purity_fieldsUnd top_n_fieldsWerden angegeben, gibt diese Methode zurück top_n_fieldsWählt zuerst Felder aus aus aus aus purity_fields.

    Standard: Gibt Reinheitsinformationen für alle Reinheitsfelder zurück, die für den Cluster gespeichert sind.
    Optionen.TopN Anzahl Optional. Schränkt die Anzahl der Vorhersagen ein, um für jedes Reinheitsfeld die höchsten Werte wiederherzustellen.

    Höchstwert: 10

    Standard: Gibt alle Reinheitsinformationen für jedes Reinheitsfeld zurück.
    Optionen.topNFelder Anzahl Optional. Beschränkt die Anzahl der Reinheitsfelder, die für jeden Cluster auf Felder mit der höchsten Reinheit zurückgegeben werden.

    Höchstwert: 10

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

    Die folgenden Informationen veranschaulichen, wie Ergebnisse der Cluster-Reinheit sortiert und kategorisiert werden. Die tatsächliche 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 in absteigender Reihenfolge nach Reinheitswert pro Cluster.

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

    Datentyp: Array
    Zeichenfolge.<clusterID>.<field>.<values> Liste von Objekten mit Feldwert und Reinheit. Beispiel: {"Priorität":[{"5":"100"}]} Ist ein Prioritätsfeld mit einer Punktzahl von 5 und einem Reinheitswert von 100 Prozent. Ergebnisliste in absteigender Reihenfolge nach Reinheitsprozentsatz. Die options.top_nDie Eingabeobjektparametereigenschaft bestimmt die Anzahl der zurückgegebenen Ergebnisse.

    Datentyp: Array

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

    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 Reinheit-Einblicke basierend auf den Einstellungen an, die im Optionsparameter bereitgestellt werden.

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

    ClusteringSolutionVersion – getUpdateStatus()

    Ruft den Status des letzten Auftrags zur Aktualisierung der Clustering-Lösung ab.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Status des Updates 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 wurde 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 eine Versionsnummer abgerufen wird.

    // 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 – Predict (Objekteingabe, Objektoptionen)

    Ruft die Eingabedaten für eine Vorhersage ab.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Eingabe Objekt GlideRecord Oder 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 den Ergebnissatz angewendet werden soll.
    Gültige Werte:
    • Wahr: Ergebnisse zurückgeben, bei denen die Konfidenz größer als der Schwellenwert ist.
    • Falsch: Alle Ergebnisse zurückgeben.

    Standardwert: True
    Optionen.Top_n Anzahl Wenn angegeben, werden die Top-Ergebnisse bis zur angegebenen Anzahl von Vorhersagen zurückgegeben.
    Tabelle : 20. Rückgaben
    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.

    Datentyp: Array von Objekten

    <identifier>: [
  {
    "confidence": Number,
    "predictedSysId": "String",
    "predictedValue": "String", 
    "threshold": Number
  }
]
    <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. Ergebnisse können aus jeder Tabelle stammen, für die Informationen vorhergesagt werden.

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

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

    Datentyp: Zahl

    Das folgende Beispiel zeigt, wie Vorhersageergebnisse für angezeigt werden Vorhersagen() Methode, die einen GlideRecord nach sys_ID für die Eingabe verwendet und optionale Parameter enthält, um auf die drei wichtigsten 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 angezeigt werden Vorhersagen() Methode, die ein Array von Feldnamen als Schlüssel-Wert-Paare für die Eingabe verwendet und optionale Parameter enthält, um auf die drei wichtigsten 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(Objektoptionen)

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

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Optionen Objekt JavaScript-Objekt mit Optionen, auf denen ein Update der Clustering-Lösung basieren soll.
    {
        "filter" : "String",
        "table" : "String"
    }
    Optionen.Filter Zeichenfolge Codierte Abfragezeichenfolge im Standard-Glide-Format. Siehe Codierte Abfragezeichenfolgen . Ermöglicht die Ausführung eines Aktualisierungsauftrags basierend auf dem bereitgestellten Filter.
    Optionen.Tabelle Zeichenfolge Name der Tabelle, für die ein Aktualisierungsauftrag ausgeführt werden soll.
    Tabelle : 22. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie einen Aktualisierungsauftrag übermitteln.

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

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

myCluster.getActiveVersion().submitUpdateJob(options);