--- 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 --- # 予測インテリジェンス API # 予測インテリジェンス API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：9分予測インテリジェンス API は、1 つ以上の入力フィールドとトレーニング済みソリューションに基づいてフィールド値を予測するエンドポイントを提供します。この API は、予測インテリジェンス (com.glide.platform_ml) プラグインがアクティブ化されている場合にのみ使用できます。 ## 予測インテリジェンス - GET /agent_intelligence/solution/{solution_name}/prediction {#ariaid-title2} 特定のソリューションを使用して出力フィールド値を予測します。 ### URL 形式 {#agent_intel-GET-sol-sol_name-pred__section_f2c_vr1_dmb} デフォルト URL: /api/now/agent_intelligence/solution/{solution_name}/prediction ### サポートされている要求パラメーター {#agent_intel-GET-sol-sol_name-pred__entry__2} | 名前 | 説明 | |-|-| | solution_name | 予測に使用するソリューションの名前。たとえば、 ml_incident_categorization などです。データタイプ：文字列 | [表 : 1. パスパラメーター] {#agent_intel-GET-sol-sol_name-pred__entry__6} | 名前 | 説明 | |-|-| | ソリューション定義入力フィールドのキーと値のペア | ソリューション入力フィールドの名前と値のペア。たとえば、名前 short_description と値 Unable to connect to VPN を入力します。データタイプ：文字列 | [表 : 2. クエリパラメーター] {#agent_intel-GET-sol-sol_name-pred__entry__10} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#agent_intel-GET-sol-sol_name-pred__entry__14}{#agent_intel-GET-sol-sol_name-pred__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 4. 要求ヘッダー] {#agent_intel-GET-sol-sol_name-pred__entry__18} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#agent_intel-GET-sol-sol_name-pred__entry__22}{#agent_intel-GET-sol-sol_name-pred__entry-200-status-code}{#agent_intel-GET-sol-sol_name-pred__entry-401-status-code}{#agent_intel-GET-sol-sol_name-pred__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#agent_intel-GET-sol-sol_name-pred__entry__30} | 要素 | 説明 | |-|-| | input | 呼び出しへの入力として指定された名前と値のペア。データタイプ: オブジェクト | | output | 指定されたソリューションに基づいて予測される結果値。データタイプ: オブジェクト "output": { "confidence": Number", "outcome": "String", "threshold": Number" } | | output.confidence | 予測の推定精度 (%) 例: 53.84615375762915。データタイプ：数値 | | output.outcome | 予測出力フィールド値。たとえば、インシデント分類ソリューションは、照会などのインシデントカテゴリを返します。データタイプ：文字列 | | output.threshold | 予測に関連付けられた構成済みのしきい値の値。データタイプ：数値 | [ ] ### cURL 要求のサンプル curl "https://instance.service-now.com/api/now/predictive_intelligence/solution/ml_incident_categorization/prediction?short_description=unable%20to%20connect%20to%20VPN" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "input": { "short_description": "unable to connect to VPN", "api": "api" }, "output": { "outcome": "inquiry", "confidence": 53.84615375762915, "threshold": 5 } } } ## 予測インテリジェンス - GET /agent_intelligence/solution/prediction {#ariaid-title3} 複数のソリューションの予測を返します。注: 結果結果オブジェクトは、ソリューション名別にグループ化され、`sys_id result...[ という形式でグループ化されます。{ },{ }]。` カスタマイズの詳細については、「 [MLSolutionFactory スクリプト可能オブジェクト](https://www.servicenow.com/docs/access?context=using-ml-apis-mlsolutionfactory&version=australia&pubname=australia-intelligent-experiences&ft:locale=en-US)」を参照してください。 ### URL 形式 {#agent_intel-GET-solution-predition__section_rrf_w51_dmb} バージョニングされた URL: /now/{api_version}/agent_intelligence/solution/prediction デフォルト URL: /now/agent_intelligence/solution/prediction 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#agent_intel-GET-solution-predition__entry__2}{#agent_intel-GET-solution-predition__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | [表 : 7. パスパラメーター] {#agent_intel-GET-solution-predition__entry__6} | パラメーター | 説明 | |-|-| | input_filter | 必須パラメーター input_table を使用する場合は、このパラメーターを input_maps パラメーターとともに使用しないでください。予測を実行するレコードを選択するためのフィルター。例： sys_id 0ef47232db801300864adfea5e961912 データタイプ：文字列 | | input_maps | input_tableパラメーターを使用しない限り必須です。入力の名前と値のペアのアレイ。例： [{"short_description":"my email is not working"}, {"short_description":"need help with password"}] データタイプ：オブジェクトのアレイ | | input_table | input_mapsパラメーターを使用しない限り必須です。予測を実行するテーブル名。例： incident データタイプ：文字列 | | オプション | オプションの引数を持つ JSON オブジェクト。例： {"top_n" : 5, "apply_threshold":false} 有効なオプション: * top_n:番号。指定した場合、指定された数の予測まで、上位の結果を返します。{#agent_intel-GET-solution-predition__solution-prediction-topn} * apply_threshold:ブーリアン。ソリューションのしきい値をチェックし、結果セットに適用します。しきい値は、類似性のソリューションしきい値または分類のクラスレベルしきい値です。デフォルト値は true です。{#agent_intel-GET-solution-predition__solution-prediction-thresh} * custom_results_filter:文字列。類似性ソリューションのみ。エンコードされたクエリを使用して結果が返される許容セットを指定します。{#agent_intel-GET-solution-predition__solution-prediction-custom} {#agent_intel-GET-solution-predition__ul_unc_4bs_ckb} データタイプ: オブジェクト | | solution_names | 必須です。予測を実行するソリューション名のカンマ区切りリスト。例： ml_incident_categorization,ml_incident_assignment データタイプ：文字列 | [表 : 8. クエリパラメーター] {#agent_intel-GET-solution-predition__entry__18} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (XML または JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#agent_intel-GET-solution-predition__entry__22}{#agent_intel-GET-solution-predition__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 10. 要求ヘッダー] {#agent_intel-GET-solution-predition__entry__26} | ヘッダー | 説明 | |-|-| | なし | | [表 : 11. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#agent_intel-GET-solution-predition__entry__30}{#agent_intel-GET-solution-predition__entry-200-status-code}{#agent_intel-GET-solution-predition__entry-401-status-code}{#agent_intel-GET-solution-predition__entry-404-status-code}{#agent_intel-GET-solution-predition__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#agent_intel-GET-solution-predition__entry__40} | 要素 | 説明 | |-|-| | 信頼性 | 予測に関連付けられた信頼度の値。例:53.84。データタイプ：数値 | | predictedSysId | 予測値のsys_id。結果は、情報が予測されている任意のテーブルから取得できます。データタイプ：文字列 | | 予測値 | 予測結果を表す値。データタイプ：文字列 | | しきい値 | 予測に関連付けられた構成済みのしきい値の値。データタイプ：数値 | [ ] ### cURL 要求のサンプル curl "http://instance.servicenow.com/api/now/agent_intelligence/solution/prediction?input_table=incident&input_filter=sys_id%3D0ef47232db801300864adfea5e961912&solution_names=ml_incident_categorization%2Cml_incident_assignment&options=%7B%22top_n%22%20%3A%202%2C%20%22apply_threshold%22%3Afalse%7D" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "ml_incident_categorization": { "0ef47232db801300864adfea5e961912": [ { "confidence": 29.12211732875455, "threshold": 15, "predictedValue": "Email", "predictedSysId": "" }, { "confidence": 19.08583525847071, "threshold": 14, "predictedValue": "Platform Performance", "predictedSysId": "" } ] }, "ml_incident_assignment": { "0ef47232db801300864adfea5e961912": [ { "confidence": 5.782322543467415, "threshold": 5, "predictedValue": "IT Finance CAB", "predictedSysId": "5f63e48fc0a8010e00eeaad81cd4dd37" }, { "confidence": 5.303589009246953, "threshold": -1, "predictedValue": "NY DB", "predictedSysId": "5f74727dc0a8010e01efe33a251993f9" } ] } } }