PredictabilityEstimateVersion - グローバル

PredictabilityEstimateVersion API は、ストアで使用されるスクリプト可能なオブジェクトです予測インテリジェンス。

この API には 予測インテリジェンス プラグイン (com.glide.platform_ml) が必要です。この API は sn_ml 名前空間内で提供されます。

この API は、PredictabilityEstimate ストア内の PredictabilityEstimate API オブジェクトに基づいて予測可能性推定バージョンを操作するために使用されます。

トレーニングを完了すると、最新バージョンの予測可能性推定がアクティブ化され、一度に 1 つのバージョンのみがアクティブになります。ただし、予測を行うために使用したい以前にトレーニングされたバージョンをアクティブ化することができます。

この API のメソッドは、次の PredictabiltyEstimate メソッドを使用してアクセスできます。

• getActiveVersion()
• getAllVersions()
• getLatestVersion()
• getVersion()

PredictabilityEstimateVersion - getProperties()

予測可能性推定オブジェクトのプロパティバージョン番号を取得します。

表 : 1. パラメーター

名前	タイプ	説明
なし

表 : 2. 返される内容

タイプ	説明
オブジェクト	データセットと PredictabilityEstimate バージョンの詳細の内容。結果はオブジェクトプロパティのセットアップによって異なります。 { "datasetProperties": {Object}, "domainName": "String", "inputFieldNames": [Array], "label": "String", "name": "String", "predictedFieldName": "String", "scope": "String", "trainingFrequency": "String", "versionNumber": "Number" }
<Object>.datasetProperties	予測可能性推定に関連付けられた DatasetDefinition() オブジェクトのプロパティを一覧表示します。 { "encodedQuery": "String", "fieldDetails": [Array], "fieldNames": [Array], "tableName": "String" } データタイプ：オブジェクト。
<Object>.datasetProperties.tableName	データセットのテーブルの名前。例："tableName" : "Incident" データタイプ：文字列。
<Object>.datasetProperties.fieldNames	指定されたテーブルからの文字列としてのフィールド名のリスト。例："fieldNames" : ["short_description", "priority"] データタイプ：アレイ。
<Object>.datasetProperties.fieldNames.fieldDetails	フィールドプロパティを指定する JavaScript オブジェクトのリスト。 [ { "name": "String", "type": "String" } ] データタイプ：アレイ。
<Object>.datasetProperties.fieldNames.fieldDetails.<object>.name	このデータセットを制限する情報のタイプを定義するフィールドの名前。 データタイプ：文字列。
<Object>.datasetProperties.fieldDetails.<object>.type	機械学習フィールドタイプ。 データタイプ：文字列。
<Object>.datasetProperties.fieldDetails.encodedQuery	標準の Glide 形式のエンコードされたクエリ文字列。「 エンコードされたクエリ文字列」を参照してください。 データタイプ：文字列。
<Object>.domainName	このデータセットに関連付けられたドメイン名。「 ドメイン分離」および 予測インテリジェンス「」を参照してください。 データタイプ：文字列。
<Object>.inputFieldNames	推定の際に考慮される入力フィールド候補 (文字列) のリスト。 データタイプ：文字列。
<Object>.isActive	このバージョンがアクティブかどうかを示すフラグ。 有効な値： true：バージョンはアクティブです。 false：バージョンはアクティブではありません。 データタイプ：文字列
<Object>.label	予測タスクを識別します。 { "label": "my first prediction" } データタイプ：文字列。
<Object>.name	システムによって割り当てられた名前。 データタイプ：文字列。
<Object>.predictedFieldName	予測可能性についてトレーニングするフィールドを識別します。 データタイプ：文字列。
<Object>.scope	オブジェクトスコープ。現在、有効な値は global のみです。 データタイプ：文字列
<Object>.trainingFrequency	モデルを再トレーニングする頻度。 可能な値： every_30_days every_60_days every_90_days every_120_days every_180_days run_once デフォルト：run_once データタイプ：文字列。
<Object>.versionNumber	のバージョン番号 PredictabilityEstimate オブジェクト。 データタイプ：文字列。

次の例では、ストア内のアクティブなオブジェクトバージョンのプロパティを取得します。

// Get properties
var mlEstimate = sn_ml.PredictabilityEstimateStore.get('ml_incident_categorization');

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

出力：

"datasetProperties": {
    "encodedQuery": "activeANYTHING^EQ",
    "fieldNames": [
      "short_description",
      "category"
    ],
    "tableName": "incident"
  },
  "domainName": "global",
  "inputFieldNames": [
    "short_description"
  ],
  "isActive": "true",
  "label": "Incident Categorization_Trainer",
  "name": "ml_incident_categorization",
  "predictedFieldName": "category",
  "processingLanguage": "en",
  "stopwords": [
    "Default English Stopwords"
  ],
  "versionNumber": "1"
}

PredictabilityEstimateVersion - getResults()

出力フィールドに対して提案された入力フィールドを含む JSON の結果を返します。

表 : 3. パラメーター

名前	タイプ	説明
なし

表 : 4. 返される内容

タイプ	説明
オブジェクト	出力フィールドに対して提案された入力フィールドオプションを含む JSON オブジェクトの結果。
<Object>.<output field name>	提案された入力フィールドを含む出力フィールド名 (例：category)。 { "<output field name>": { "nominalInputFields": [Array], "textInputFields": [Array] } } データタイプ：オブジェクト
<Object>.<output field name>.nominalInputFields	標準的な入力フィールドの詳細。 "nominalInputFields": [ { "fieldName": "String", "modelImprovement": "String" } ] データタイプ：アレイ。
<Object>.<output field name>.nominalInputFields.fieldName	標準的な入力フィールド名。 データタイプ：文字列。
<Object>.<output field name>.nominalInputFields.modelImprovement	このフィールドが結果を改善する可能性を相対的に示すスコア。 データタイプ：文字列としての数字。
<Object>.textInputFields	テキスト入力フィールドの詳細。 "textInputFields": [ { "fieldName": "String",     "density": "String" } ] データタイプ：アレイ。
<Object>.textInputFields.fieldName	テキスト入力フィールドの名前。 データタイプ：文字列。
<Object>.textInputFields.density	フィールドが空でない頻度を表す 0 〜 1.0 の値。1.0 の値はフィールドがすべての行で空でないことを意味し、0 の値はフィールドがすべての行で空であることを示します。 データタイプ：文字列としての数字。

次の例は、ストア内にある選択したバージョンの予測可能性推定に対する結果を取得する方法を示しています。

// Get results
var estimateName = "ml_x_snc_global_global_predictability_estimate;"
var mlEstimate = sn_ml.PredictabilityEstimateStore.get(estimateName);

var results = mlEstimate.getActiveVersion().getResults();

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

出力：

{
  "category": {
    "nominalInputFields": [
      {
        "fieldName": "number",
        "modelImprovement": "0.167052396325189"
      },
      {
        "fieldName": "task_effective_number",
        "modelImprovement": "0.167052396325189"
      }
    ],
    "textInputFields": [
      {
        "fieldName": "short_description",
        "density": "1.0"
      }
    ]
  }
}

PredictabilityEstimateVersion - getStatus(ブーリアン includeDetails)

トレーニング完了ステータスを取得します。

表 : 5. パラメーター

名前	タイプ	説明
includeDetails	ブーリアン	ステータス details を返すかどうかを示すフラグ。 有効な値： true：追加の詳細を返します。 false：追加の詳細を返しません。 デフォルト値：False

表 : 6. 返される内容

タイプ	説明
オブジェクト	PredictabilityEstimate オブジェクト のトレーニングステータス情報を含む JavaScript オブジェクト。 { "state": "String", "percentComplete": "Number as a String", "hasJobEnded": "Boolean value as a String", "details": {Object} }
<Object>.state	トレーニング完了ステータス。トレーニングジョブがターミナルステータスに達した場合、ジョブはそのステータスを終了しません。ステータスがターミナルの場合、hasJobEnded プロパティは true に設定されます。 可能な値： fetching_files_for_training preparing_data 再試行 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 データタイプ：文字列
<Object>.hasJobEnded	トレーニングが完了したかどうかを示すフラグ。 有効な値： true：トレーニングは完了しました。 false：トレーニングは完了していません。 データタイプ：文字列としてのブール値
<Object>.percentComplete	トレーニングの完了率を表す 0 〜 100 の数値。完了率が 100 未満の場合、ジョブはターミナルステータスである可能性があります。たとえば、トレーニングがタイムアウトした場合などです。 データタイプ：文字列としての数値
<Object>.details	追加のトレーニングの詳細のリストを含むオブジェクト。 データタイプ：オブジェクト

次の例は、トレーニングが完了して成功した結果を示しています。

// Get status
var mlEstimate = sn_ml.PredictabilityEstimateStore.get('ml_incident_categorization');

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

出力：

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

次の例は、トレーニングが完了して失敗した結果を示しています。

// Get status
var mlEstimate = sn_ml.PredictabilityEstimateStore.get('ml_x_snc_global_global_my_estimate_definition');
var trainingStatus = mlEstimate.getLatestVersion().getStatus();

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

出力：

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

PredictabilityEstimateVersion - getVersionNumber()

予測可能性推定オブジェクトのバージョン番号を取得します。。

表 : 7. パラメーター

名前	タイプ	説明
なし

表 : 8. 返される内容

タイプ	説明
文字列	バージョン番号。

次の例は、バージョン番号を取得する方法を示しています。

// Get version number
var mlEstimate = sn_ml.PredictabilityEstimateStore.get('ml_x_snc_global_global_predictability_estimate');

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

出力：

Version number: 1