---
sourceDocument: Australia Enable AI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/intelligent-experiences

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Enable AI

ft:clusterId :

    - platai

bundleId :

    - platai

workflow :

    - Platform


---

# Test a similarity solution prediction

# Test a similarity solution prediction {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

Once your machine-learning (ML) solutions are trained, you can call on the Predictive Intelligence API to make a
solution prediction. In this example procedure, we use the REST API Explorer application to
test a similarity solution prediction for resolved incident recommendations.

## Antes de Iniciar

Train your ML solution prior to testing a prediction.

Role required: web_service_admin, rest_api_explorer, or admin or ml_admin

## Por Que e Quando Desempenhar Esta Tarefa

This procedure uses sample data to illustrate what you can do in your instance, and
may not represent data or records that are actually in your instance.

This scenario illustrates a similarity solution prediction for a hypothetical ML
solution that you have previously created and trained. You can also use the REST API
Explorer to test a classification solution prediction.

## Procedimento

1. Navigate to AllPredictive IntelligenceSimilaritySolution Definitions.
2. Locate the ML solution definition whose prediction you want to test, and copy its Name value to your clipboard or a Notepad file.  
   In this case, we use the Name field value in your ML Solution Definition Recommended Resolved Incidents record, as illustrated in the following example.  
3. Copy the Input Fields value(s) used in your ML Solution Definition record that you want the REST API Explorer to use in its call to the Predictive Intelligence API.  
   In this case, we use the Short description field type, as the prediction model has been trained to use this field to learn, pair, and recommend similar records for your review.  
4. Right-click the browser tab you're using to view your instance, and select Duplicate.
5. In the duplicate browser tab, navigate to System Web ServicesRESTREST API Explorer.
6. Click Explore.
7. Set these choice fields as follows.

   | Field | Value |
   | Namespace | now (leave as default) |
   | API Name | Predictive Intelligence |
   | API Version | latest (leave as default) |
   |-|-|

   {#test-similarity-solution-prediction__choicetable_v1w_53m_ycb}  
   The Predictive Intelligence form appears. You use this form to prepare your call request to the Predictive Intelligence API.
8. In the solution-name Value field, enter <kbd class="ph userinput"> ml_x_snc_global_recommended_resolved_incidents</kbd>.  
   Nota:  
   This is the Name value you captured in Step 2 of this procedure.
9. Click Add query parameter.
10. In the Query parameters section, enter the value of one of the Input Fields from the solution you're testing.
    1. In the first field, paste <kbd class="ph userinput">short_description</kbd>.  
       Nota:  
       This is one of the input fields you captured in Step 2 of this procedure.
       You can use other field types, such as Description or Resolution notes to test what the solution is predicting.
    2. In the second field, enter some text that you might find in an incident record.  
       For instance, enter <kbd class="ph userinput">Discovery errors</kbd>.
    {#test-similarity-solution-prediction__substeps_t2r_rfl_4gb}
11. Click the \[+\] button to create a second query condition that defines the number of results you want to query.
    1. In the first field, enter <kbd class="ph userinput">top_n</kbd>.
    2. In the second field, enter <kbd class="ph userinput">3</kbd>.

    {#test-similarity-solution-prediction__substeps_w2c_2hl_4gb}  
    These conditions set the query to retrieve the top three most similar incident records.
12. Click Send.  
    The REST API Explorer sends your request to the Predictive Intelligence API.
13. In the Response body section, copy the three outcome values that your API call returned, as illustrated in the image below.  
14. In your original browser tab, navigate to ServicedeskIncidents.
15. As shown in the image below, set filter conditions for the three REST API outcomes to the Incidents table list view.
    1. Add the Active and Sys ID conditions below to the Incidents list view Filter icon.
    2. Paste the three REST API outcomes into the Input value field of the Sys ID condition that you created.
    3. Click Run.

    {#test-similarity-solution-prediction__substeps_scg_jgr_4gb}  
16. Per the image below, compare the returned list of incidents with the input for the prediction output in the REST API Explorer.
    1. Click the Incident Number to open the Incident record.  
    2. Per the image below, review the Resolution notes text in the Incident record.  
    {#test-similarity-solution-prediction__substeps_qkw_wql_4gb}
**Tópicos relacionados**   

* [Predictive Intelligence API](https://www.servicenow.com/docs/access?context=agent-intelligence-api&version=australia&pubname=australia-api-reference&ft:locale=en-US)
* [MLPredictor - Global](https://www.servicenow.com/docs/access?context=c_MLPredictorAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US)