--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # PredictabilityEstimateVersion :グローバル # PredictabilityEstimateVersion :グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：13分 PredictabilityEstimateVersion API は、予測インテリジェンスストアで使用されるスクリプト可能なオブジェクトです。 この API には 予測インテリジェンス プラグイン (com.glide.platform_ml) が必要で、 `sn_ml` 名前空間内で提供されます。 この API は、[PredictabilityEstimate ストア](https://servicenow-prod.fluidtopics.net/3dLjiDWVBuAXQexJMI0qgQ#PredictabilityEstimateStoreAPI "の保存と取得を可能にします 予測可能性の推定値。")内の [PredictabilityEstimate API](https://servicenow-prod.fluidtopics.net/57paZuJ_FMhuOGsSAEvg0w#PredictabilityEstimateAPI "PredictabilityEstimate API は、予測インテリジェンスストアで使用されるスクリプト可能なオブジェクトです。このオブジェクトは、データセットのフィールドがどの程度予測可能であるか、およびそれらのフィールドの予測に役立つ特徴量を示します。") オブジェクトに基づく予測可能性の推定バージョンを操作するときに使用します。 バージョンのソリューションをアクティブ化 予測可能性の推定 トレーニング完了時に最新バージョンのソリューションをアクティブ化し、一度にアクティブにできるのは 1 つのバージョンのみです。ただし、予測に使用する、以前にトレーニングしたバージョンをアクティブ化することはできます。{#PredictabilityEstimateVersionAPI__mlv-version-activation-e1} この API のメソッドには、次の PredictabiltyEstimate メソッドを使用してアクセスできます。 * [getActiveVersion()](https://servicenow-prod.fluidtopics.net/57paZuJ_FMhuOGsSAEvg0w#PrdctbltE-getActiveVersion "アクティブを取得します PredictabilityEstimateVersion オブジェクト。") * [getAllVersions()](https://servicenow-prod.fluidtopics.net/57paZuJ_FMhuOGsSAEvg0w#PrdctbltE-getAllVersions "のすべてのバージョンを取得します 予測可能性の推定値。") * [getLatestVersion()](https://servicenow-prod.fluidtopics.net/57paZuJ_FMhuOGsSAEvg0w#PrdctbltE-getLatestVersion "の最新バージョンを取得します 予測可能性の推定値。") * [getVersion()](https://servicenow-prod.fluidtopics.net/57paZuJ_FMhuOGsSAEvg0w#PrdctbltE-getVersion_S "予測可能性の推定値を取得します 指定されたバージョン番号で。") {#PredictabilityEstimateVersionAPI__ul_ycl_fzf_tlb} ## PredictabilityEstimateVersion:getProperties() {#ariaid-title2} 予測可能性推定オブジェクトプロパティ およびバージョン番号を取得します。 {#PredictbltyEstV-getProperties__table_d2m_zwz_4lb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 1. パラメーター] {#PredictbltyEstV-getProperties__table_d2m_zwz_4lb} {#PredictbltyEstV-getProperties__table_e2m_zwz_4lb__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | データセットの内容と [PredictabilityEstimate](https://servicenow-prod.fluidtopics.net/57paZuJ_FMhuOGsSAEvg0w#PrdctbltE-PredictabilityEstimate_O "予測可能性の推定値を作成します。") バージョンの詳細。結果は、オブジェクトプロパティの設定によって異なります。 { "datasetProperties": {Object}, "domainName": "String", "inputFieldNames": [Array], "label": "String", "name": "String", "predictedFieldName": "String", "scope": "String", "trainingFrequency": "String", "versionNumber": "Number" } | | \.datasetProperties | 予測可能性の推定に関連付けられた [DatasetDefinition()](https://servicenow-prod.fluidtopics.net/_Y4D37G2Ep8vLiDiwFGIhA#DDef-DatasetDefinition_O "DatasetDefinition クラスのインスタンスを作成し、テーブル名、フィールド、およびクエリでデータセットを定義できるようにします。") オブジェクトのプロパティを一覧表示します。 { "encodedQuery": "String", "fieldDetails": [Array], "fieldNames": [Array], "tableName": "String" } データタイプ:オブジェクト。 | | \.datasetProperties.tableName | データセットのテーブルの名前。たとえば、「 `tableName」:「インシデント」`です。 データタイプ:文字列。 | | \.datasetProperties.fieldNames | 指定されたテーブルのフィールド名を文字列としてリストします。例:"`fieldNames" : ["short_description", "priority"]。` データタイプ:アレイ。 | | \.datasetProperties.fieldNames.fieldDetails | フィールドのプロパティを指定する JavaScript オブジェクトのリスト。 [ { "name": "String", "type": "String" } ] データタイプ:アレイ。 | | \.datasetProperties.fieldNames.fieldDetails.\.名前 | このデータセットを制限する情報のタイプを定義するフィールドの名前。 データタイプ:文字列。 | | \.datasetProperties.fieldDetails.\.タイプ | 機械学習フィールドタイプ。 データタイプ:文字列。 | | \.datasetProperties.fieldDetails.encodedQuery | 標準の Glide 形式でエンコードされたクエリ文字列。「 [エンコードされたクエリ文字列」](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)を参照してください。 データタイプ:文字列。 | | \.domainName | このデータセットに関連付けられたドメイン名。「 [ドメインセパレーション」および 予測インテリジェンス](https://www.servicenow.com/docs/access?context=domain-separation-predictive-intelligence&version=australia&pubname=australia-intelligent-experiences&ft:locale=en-US)を参照してください。 データタイプ:文字列。 | | \.inputFieldNames | 推定対象として考慮される文字列としての候補入力フィールドのリスト。 データタイプ:文字列。 | | \.isActive | このバージョンがアクティブかどうかを示すフラグ。 有効な値： * true:バージョンはアクティブです。 * false:バージョンはアクティブではありません。 {#PredictbltyEstV-getProperties__ul_i5m_lp1_dmb} データタイプ：文字列 | | \.label | 予測タスクを識別します。 { "label": "my first prediction" } データタイプ:文字列。 | | \.name | システムによって割り当てられた名前。 データタイプ:文字列。 | | \.predictedFieldName | 予測可能性のためにトレーニングするフィールドを識別します。 データタイプ:文字列。 | | \.scope | オブジェクトスコープ。現時点で有効な値は `グローバル`値のみです。 データタイプ：文字列 | | \.trainingFrequency | モデルを再トレーニングする頻度。 可能な値： * every_30_days * every_60_days * every_90_days * every_120_days * every_180_days * run_once {#PredictbltyEstV-getProperties__ul_pmw_523_plb}デフォルト:run_once データタイプ:文字列。 | | \.versionNumber | のバージョン番号 PredictabilityEstimate オブジェクト。 データタイプ:文字列。 | [表 : 2. 返される内容] {#PredictbltyEstV-getProperties__table_e2m_zwz_4lb} 次の例では、ストア内のアクティブなオブジェクトバージョンのプロパティを取得します。 // 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() {#ariaid-title3} 出力フィールドの提案された入力フィールドを含む JSON 結果を返します。 {#PredictbltyEstV-getResults__table_ytt_1xz_qlb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 3. パラメーター] {#PredictbltyEstV-getResults__table_ytt_1xz_qlb} {#PredictbltyEstV-getResults__table_ztt_1xz_qlb__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | 出力フィールドの提案された入力フィールドオプションを含む JSON オブジェクトの結果。 | | \。\ | 提案された入力フィールドを含む出力フィールド名 ( カテゴリなど)。 { "": { "nominalInputFields": [Array], "textInputFields": [Array] } } データタイプ: オブジェクト | | \.\。名義入力フィールド | 名義入力フィールドの詳細。 "nominalInputFields": [ { "fieldName": "String", "modelImprovement": "String" } ] データタイプ:アレイ。 | | \.\。nominalInputFields.fieldName | 名目上の入力フィールド名。 データタイプ:文字列。 | | \.\。nominalInputFields.modelImprovement | このフィールドで結果が改善される可能性がどの程度あるかを示す相対的な指標としてのスコア。 データタイプ:文字列としての数値。 | | \.textInputFields | テキスト入力フィールドの詳細。 "textInputFields": [ { "fieldName": "String", "density": "String" } ] データタイプ:アレイ。 | | \.textInputFields.fieldName | テキスト入力フィールド名。 データタイプ:文字列。 | | \.textInputFields.density | フィールドが空でない頻度を表す 0 〜 1.0 の値。値 1.0 はフィールドがすべての行が空ではないことを意味し、値 0 はフィールドがすべての行が空であることを示します。 データタイプ:文字列としての数値。 | [表 : 4. 返される内容] {#PredictbltyEstV-getResults__table_ztt_1xz_qlb} 次の例は、ストアで選択したバージョンの予測可能性の推定結果を取得する方法を示しています。 // 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) {#ariaid-title4} トレーニング完了ステータスを取得します。 {#PredictbltyEstV-getStatus_B__table_xfh_vbw_plb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | includeDetails | ブーリアン | ステータスを details にするかどうかを示すフラグ。 有効な値： * true:追加の詳細を返します。 * false:追加の詳細を返しません。 {#PredictbltyEstV-getStatus_B__ul_n33_ckw_plb} デフォルト値：False | [表 : 5. パラメーター] {#PredictbltyEstV-getStatus_B__table_xfh_vbw_plb} {#PredictbltyEstV-getStatus_B__table_yfh_vbw_plb__entry__2} | タイプ | 説明 | |-|-| | オブジェクト | のトレーニングステータス情報を含む JavaScript オブジェクト[PredictabilityEstimate](https://servicenow-prod.fluidtopics.net/57paZuJ_FMhuOGsSAEvg0w#PredictabilityEstimateAPI "PredictabilityEstimate API は、予測インテリジェンスストアで使用されるスクリプト可能なオブジェクトです。このオブジェクトは、データセットのフィールドがどの程度予測可能であるか、およびそれらのフィールドの予測に役立つ特徴量を示します。") オブジェクト。 { "state": "String", "percentComplete": "Number as a String", "hasJobEnded": "Boolean value as a String", "details": {Object} } | | \.state | トレーニング完了ステータス。トレーニングジョブがターミナルステータスに達しても、ジョブはそのステータスを終了しません。ステータスが \[ターミナル\] の場合、 hasJobEnded プロパティは `true` に設定されます。 可能な値： * fetching_files_for_training * preparing_data * 再試行 * solution_cancelled (端末) * solution_complete (ターミナル) * solution_error (端末) * solution_incomplete * training_request_received * training_request_timed_out (ターミナル) * training_solution * uploading_solution * waiting_for_training {#PredictbltyEstV-getStatus_B__ul_a5q_gh4_vlb} データタイプ：文字列 | | \.hasJobEnded | トレーニングが完了したかどうかを示すフラグ。 有効な値： * true:トレーニングが完了しました。 * false:トレーニングが不完全です。 {#PredictbltyEstV-getStatus_B__ul_icy_zjx_rlb} データタイプ:文字列としてのブール値 | | \.percentComplete | トレーニング完了率。完了率が 100 未満の場合、ジョブはターミナル状態である可能性があります。たとえば、トレーニングがタイムアウトした場合などです。 データタイプ:文字列としての数値 範囲:0〜100 | | \.details | 追加のトレーニング詳細のリストを含むオブジェクト。 データタイプ: オブジェクト | [表 : 6. 返される内容] {#PredictbltyEstV-getStatus_B__table_yfh_vbw_plb} 次の例は、トレーニングが完了した正常な結果を示しています。 // 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() {#ariaid-title5} のバージョン番号を取得します 予測可能性の推定オブジェクト。 {#PredictbltyEstV-getVersionNumber__table_jsz_sbw_plb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 7. パラメーター] {#PredictbltyEstV-getVersionNumber__table_jsz_sbw_plb} {#PredictbltyEstV-getVersionNumber__table_ksz_sbw_plb__entry__2} | タイプ | 説明 | |-|-| | 文字列 | バージョン番号。 | [表 : 8. 返される内容] {#PredictbltyEstV-getVersionNumber__table_ksz_sbw_plb} 次の例は、バージョン番号を取得する方法を示しています。 // 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