---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API Intelligence prédictive

# API Intelligence prédictive {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture

L'API Intelligence prédictive fournit des points de terminaison qui prédisent une valeur de champ en fonction d'un ou de plusieurs champs d'entrée et d'une solution formée.
Vous ne pouvez utiliser cette API que lorsque le module d'extension Intelligence prédictive (com.glide.platform_ml) est activé.

## Intelligence prédictive - OBTENIR /agent_intelligence/solution/{solution_name}/prédiction {#ariaid-title2}

Prédit une valeur de champ de sortie à l'aide d'une solution spécifique.

### Format d'URL {#agent_intel-GET-sol-sol_name-pred__section_f2c_vr1_dmb}

URL par défaut : /api/now/agent_intelligence/solution/{solution_name}/prediction

### Paramètres de demande pris en charge

{#agent_intel-GET-sol-sol_name-pred__entry__2}

| Nom | Description |
|-|-|
| solution_name | Nom de la solution à utiliser pour les prédictions. Par exemple, <kbd class="ph userinput">ml_incident_categorization</kbd>. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]

{#agent_intel-GET-sol-sol_name-pred__entry__6}

| Nom | Description |
|-|-|
| Paire clé-valeur de champ d'entrée de définition de la solution | Paire nom-valeur du champ d'entrée de la solution. Par exemple, saisissez le nom : <kbd class="ph userinput">short_description</kbd> et la valeur : <kbd class="ph userinput">Impossible de se connecter au VPN</kbd>. Type de données : chaîne |
[Tableau 2. Paramètres de requête]

{#agent_intel-GET-sol-sol_name-pred__entry__10}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 3. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#agent_intel-GET-sol-sol_name-pred__entry__14}{#agent_intel-GET-sol-sol_name-pred__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 4. En-têtes de demandes]

{#agent_intel-GET-sol-sol_name-pred__entry__18}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 5. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#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}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 6. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#agent_intel-GET-sol-sol_name-pred__entry__30}

| Élément | Description |
|-|-|
| entrée | Paires nom-valeur qui ont été spécifiées comme entrée de l'appel. Type de données : objet |
| sortie | Valeurs de résultat prévues basées sur la solution spécifiée. Type de données : objet "output": { "confidence": Number", "outcome": "String", "threshold": Number" } |
| sortie.confiance | Précision estimée de la prédiction, en pourcentage. Par exemple, 53.84615375762915. Type de données : nombre |
| résultat.résultat | Valeur de champ de sortie de prédiction. Par exemple, une solution de catégorisation d'incident renverrait une catégorie d'incident telle que la demande. Type de données : chaîne |
| seuil.sortie | Valeur du seuil configuré associé à la prédiction. Type de données : nombre |
[ ]

### Exemple de demande 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
        }
      }
    }

## Intelligence prédictive - GET /agent_intelligence/solution/prédiction {#ariaid-title3}

Renvoie des prédictions pour plusieurs solutions.
Remarque :  
Les objets de résultat sont regroupés par nom de solution et par sys_id au format `result.<solutionname>.<sys_id>.[ { <result1> },{ <result2>}]`.

Pour plus d'informations sur la personnalisation, consultez [Objets pouvant contenir des scripts MLSolutionFactory](https://www.servicenow.com/docs/access?context=using-ml-apis-mlsolutionfactory&version=xanadu&pubname=xanadu-intelligent-experiences&ft:locale=en-US).

### Format d'URL {#agent_intel-GET-solution-predition__section_rrf_w51_dmb}

URL versionnée : /now/{api_version}/agent_intelligence/solution/prediction

URL par défaut : /now/agent_intelligence/solution/prediction

### Paramètres de demande pris en charge

{#agent_intel-GET-solution-predition__entry__2}{#agent_intel-GET-solution-predition__version-RESTAPI}

| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Exemple : <kbd class="ph userinput">v1</kbd> ou <kbd class="ph userinput">v2</kbd>. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
[Tableau 7. Paramètres de chemin d'accès]

{#agent_intel-GET-solution-predition__entry__6}

| Paramètre | Description |
|-|-|
| input_filter | Paramètre requis si input_table est utilisé, n'utilisez pas ce paramètre avec input_maps le paramètre. Filtrez pour sélectionner des enregistrements sur lesquels exécuter des prédictions. Par exemple : sys_id 0ef47232db801300864adfea5e961912 Type de données : chaîne |
| input_maps | Requis sauf si vous utilisez un input_table paramètre. Tableau des paires nom-valeur d'entrée. Par exemple : [{"short_description":"my email is not working"}, {"short_description":"need help with password"}] Type de données : tableau d'objets |
| input_table | Requis sauf si vous utilisez un input_maps paramètre. Nom de la table sur laquelle vous souhaitez exécuter des prédictions. Par exemple : incident Type de données : chaîne |
| options | Objet JSON avec arguments facultatifs. Par exemple : {"top_n" : 5, "apply_threshold":false} Options valides : * top_n : Nombre. Si elle est fournie, renvoie les meilleurs résultats, jusqu'au nombre spécifié de prédictions.{#agent_intel-GET-solution-predition__solution-prediction-topn} * apply_threshold : booléen. Vérifie la valeur de seuil de la solution et l'applique à l'ensemble de résultats. La valeur de seuil est le seuil de la solution pour la similarité ou le seuil de niveau classe pour la classification. La valeur par défaut est vrai.{#agent_intel-GET-solution-predition__solution-prediction-thresh} * custom_results_filter : chaîne de caractères. Solutions de similarité uniquement. Spécifie l'ensemble autorisé à partir duquel les résultats sont renvoyés à l'aide d'une requête codée.{#agent_intel-GET-solution-predition__solution-prediction-custom} {#agent_intel-GET-solution-predition__ul_unc_4bs_ckb} Type de données : objet |
| solution_names | Requis. Liste séparée par des virgules de noms de solutions pour lesquels vous souhaitez exécuter des prédictions. Par exemple : ml_incident_categorization,ml_incident_assignment Type de données : chaîne |
[Tableau 8. Paramètres de requête]

{#agent_intel-GET-solution-predition__entry__18}

| Nom | Description |
|-|-|
| Aucun |   |
[Tableau 9. Paramètres de corps de demande (XML ou JSON)]

### En-têtes

Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#agent_intel-GET-solution-predition__entry__22}{#agent_intel-GET-solution-predition__accept-RESTAPI}

| En-tête | Description |
|-|-|
| Accepter | Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json |
[Tableau 10. En-têtes de demandes]

{#agent_intel-GET-solution-predition__entry__26}

| En-tête | Description |
|-|-|
| Aucun |   |
[Tableau 11. En-têtes de réponses]

### Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#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}

| Code d'état | Description |
|-|-|
| 200 | Réussi. La demande a été correctement traitée. |
| 401 | Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises. |
| 404 | Introuvable. L'élément demandé est introuvable. |
| 500 | Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur. |
[Tableau 12. Codes d'état]

### Paramètres du corps de réponse (JSON ou XML)

{#agent_intel-GET-solution-predition__entry__40}

| Élément | Description |
|-|-|
| fiabilité | Valeur de confiance associée à la prédiction. Par exemple, 53.84. Type de données : nombre |
| Résultats détaillés | Solutions de similarité uniquement. Paire clé-valeur JSON contenant des détails sur les index de texte correspondants. Type de données : chaîne |
| predictedSysId | sys_id de la valeur prévue. Les résultats peuvent provenir de n'importe quelle table sur laquelle des informations sont prévues. Type de données : chaîne |
| valeur prédictée | Valeur représentant le résultat de prédiction. Type de données : chaîne |
| seuil | Valeur du seuil configuré associé à la prédiction. Type de données : nombre |
[ ]

### Exemple de demande 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"
            }
          ]
        }
      }
    }