MLSolutionResult - グローバル (使用廃止)

MLSolutionResult API は、クラスター情報とクラスタリング ソリューションのメンバーを管理するためのメソッドを提供します。結果をビジネスロジックに埋め込むことができます。

注:

この API は廃止され、将来のリリースで削除される予定です。最新のガイドラインについては、「 ML API の使用 」を参照してください。

MLSolutionResult:MLSolutionResult()

新しい MLSolutionResult オブジェクトをインスタンス化します。

表 : 1. パラメーター

名前	タイプ	説明
なし

MLSolutionResult:findActiveSolution(文字列 solutionName)

ソリューションオブジェクトを返します。

このメソッドは、ml_solution定義とソリューションがアクティブ (つまりトレーニング済み) の場合にのみソリューションを返します。詳細については、「 クラスタリングソリューションの作成とトレーニング 」を参照してください。

表 : 2. パラメーター

名前	タイプ	説明
solutionName	文字列	クラスタリングml_solutionレコードの名前。

表 : 3. 戻り値

タイプ	説明
オブジェクト	ml_solution定義とソリューションがアクティブな場合は、指定された solutionName のクラスターリングソリューションオブジェクト。それ以外の場合は null。

var solutionName = 'ml_incident_assignment';
  var MLS = new MLSolutionResult();
  var solution = MLS.findActiveSolution(solutionName);
  gs.print(solution);
        

MLSolutionResult - getClusterAssignments(文字列 solutionName, オブジェクトオプション)

クラスタリングソリューションのすべてのメンバーを返します。

表 : 4. パラメーター

名前	タイプ	説明
solutionName	文字列	アクティブなクラスターソリューションの名前。
オプション	オブジェクト	オプション。クラスタリングソリューション内のグループとレベル別に返される結果を絞り込みます。 デフォルト:すべてのクラスターのクラスターメンバーシップを返します。
options.segmentation_field	文字列	オプション。クラスターメンバーシップを取得するセグメンテーションフィールド (アサイン先グループなど) を識別します。 このフィールドは、[クラスターリングソリューション定義] テーブルの [グループ化基準を使用] チェックボックスで提供されるオプションと同じグループ化を行います。提供される情報は、[ テーブル] フィールドで選択したテーブルによって異なります。詳細については、「 クラスタリングソリューションの作成とトレーニング 」を参照してください。
options.cluster_id	文字列	オプション。ml_cluster_summaryテーブルからのsys_id。
options.rec_sys_id	文字列	オプション。クラスターソリューションの基になるテーブルレコードのsys_id。

表 : 5. 戻り値

タイプ	説明
アレイ	次を含む結果オブジェクトのアレイ: セグメンテーション:データをグループ化する基準となるフィールド名 cluster_num:クラスターのソリューション内の一意のクラスター番号 (つまりラベル) rec_sys_id:クラスターソリューションの基になっているテーブルレコードのsys_id rec_display_id:レコードsys_idに関連付けられたレコードの名前。

次の例は、options オブジェクトの値を設定せずにソリューションのすべてのクラスターメンバーを返す方法を示しています。

var solutionName = "<Name_of_Active_Cluster_Solution>";
var solutionResult = new MLSolutionResult();
var outcome_array = solutionResult.getClusterAssignments(solutionName);
for (var i = 0; i < outcome_array.length; i++) {
   gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
}

次の例は、options.rec_sys_idを使用して 1 つのレコードのすべてのクラスターメンバーを返す方法を示しています。

var now_GR = new GlideRecord('incident');
now_GR.get('sys_id');

var solutionName = "solution_example";
var solutionResult = new MLSolutionResult();
var options = { "rec_sys_id": now_GR.getUniqueValue() };
var outcome_array = solutionResult.getClusterAssignments(solutionName, options);
for (var i = 0; i < outcome_array.length; i++) {
   gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
}

MLSolutionResult - getClusterInfo(文字列 solutionName, オブジェクトオプション)

クラスタリングソリューションのすべての結果情報を返します。

表 : 6. パラメーター

名前	タイプ	説明
solutionName	文字列	アクティブなクラスターソリューションの名前。
オプション	オブジェクト	オプション。クラスタリングソリューション内のグループとレベル別に返される結果を絞り込みます。 デフォルト:すべてのクラスターのクラスターメンバーシップを返します。
options.segmentation_field	文字列	オプション。クラスターメンバーシップを取得するセグメンテーションフィールド (アサイン先グループなど) を識別します。 このフィールドは、[クラスターリングソリューション定義] テーブルの [グループ化基準を使用] チェックボックスで提供されるオプションと同じグループ化を行います。提供される情報は、[ テーブル] フィールドで選択したテーブルによって異なります。詳細については、「 クラスタリングソリューションの作成とトレーニング」を参照してください。
options.cluster_id	文字列	オプション。ml_cluster_summaryテーブルからのsys_id。

表 : 7. 戻り値

タイプ	説明
アレイ	次を含む結果オブジェクトのアレイ: セグメンテーション:データをグループ化する基準となるフィールド名 cluster_num:クラスターのソリューション内の一意のクラスター番号 (つまりラベル) total_members:クラスター内のレコード数 (つまり、サイズ) cluster_quality:クラスター品質のパーセンタイル値

var solutionName = "solution_example";
var solutionResult = new MLSolutionResult();
var outcome_array = solutionResult.getClusterInfo(solutionName);
for (var i = 0; i < outcome_array.length; i++) {
gs.print(outcome_array[i].segmentation + ' ' + outcome_array[i].cluster_num + ' ' + outcome_array[i].total_members + ' ' + outcome_array[i].cluster_quality);
}