<h2>Intent Discovery</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2025" /><meta name="DC.rights.owner" content="(C) Copyright 2025" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="concept" /><meta name="DC.title" content="Intent Discovery" /><meta name="abstract" content="Use the Intent Discovery application to help identify opportunities for incident deflection. For example, you can use it to identify which Virtual Agent conversations to activate next." /><meta name="description" content="Use the Intent Discovery application to help identify opportunities for incident deflection. For example, you can use it to identify which Virtual Agent conversations to activate next." /><meta name="DC.relation" scheme="URI" content="../../../administer/natural-language-understanding/concept/nlu-workbench-advanced-features.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/general/reference/ai-products.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/natural-language-understanding/concept/nlu-landing.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/natural-language-understanding/task/install-intent-discovery.html" /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2023-08-03" /><meta name="DC.date.modified" content="2024-10-04" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="intent-discovery" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>Intent Discovery</title></head><body id="intent-discovery"> <div class="breadcrumb"><a class="link" href="../../../administer/general/reference/ai-products.html" title="Take advantage of artificial intelligence-based tools to prioritize and automate routine tasks, detect major incidents, and surface insights.">Enable AI experiences</a> > <a class="link" href="../../../administer/natural-language-understanding/concept/nlu-landing.html" title="ServiceNow Natural Language Understanding (NLU) provides an NLU Workbench and an NLU inference service that you can use to enable the system to learn and respond to human-expressed intent. By entering natural language examples into the system, you help it understand word meanings and contexts so it can infer user or system actions.">Natural Language Understanding</a> > </div> <h1 class="title topictitle1" id="ariaid-title1"><span class="ph">Intent Discovery</span></h1> <div class="body conbody"><p class="shortdesc">Use the <span class="ph">Intent Discovery</span> application to help identify opportunities for incident deflection. For example, you can use it to identify which <span class="ph">Virtual Agent</span> conversations to activate next.</p> <div class="section" id="intent-discovery__section_nhl_155_vnb"><h2 class="title sectiontitle">Summary usage</h2> <p class="p">For applications that consume <span class="ph">NLU</span>, such as <span class="ph">Virtual Agent</span> and <span class="ph">AI Search</span>, <span class="ph">Intent Discovery</span> helps you to better understand which prebuilt intents you can benefit from, and which custom intents would be useful to create.</p> <p class="p"><span class="ph">Intent Discovery</span> provides an analysis that you run on historic incident data or other task data. You can also group the run’s remaining records into different clusters so you can manually add utterances to <span class="ph">NLU</span> intents. In addition, you can use specific clusters to create new intents in a model.</p> <p class="p">In this example scenario, you're using <span class="ph">Intent Discovery</span> to identify the top intents in your instance, and how much coverage they can provide across your historic incident records.</p> </div> <div class="section" id="intent-discovery__section_pch_q2l_2qb"><h2 class="title sectiontitle">Installation</h2> <p class="p"><span class="ph">Intent Discovery</span> is available from the <span class="ph">ServiceNow Store</span>. For more information, see <a class="xref" href="../task/install-intent-discovery.html" title="You can install the Intent Discovery application (sn_nlu_discovery) if you have the admin role.">Install Intent Discovery</a>.</p> <div class="p">After <span class="ph">Intent Discovery</span> is installed and activated, it appears under <span class="ph menucascade"><span class="ph uicontrol">All</span> > <span class="ph uicontrol">NLU Workbench</span> > <span class="ph uicontrol">NLU Advanced Features</span></span>.<div class="note"><span class="notetitle">Note:</span> Although organized under <span class="ph">NLU</span> Advanced Features in the navigation pane, <span class="ph">Intent Discovery</span> is a separate application that is not included when installing <span class="ph">NLU Workbench</span> - Advanced Features.</div> </div> </div> <div class="section" id="intent-discovery__section_y5b_mbz_5sb"><h2 class="title sectiontitle"><span class="ph">Intent Discovery</span> report details</h2> <div class="p"><ul class="ul" id="intent-discovery__ul_ztg_nbz_5sb"><li class="li">When <span class="ph uicontrol">Taxonomy</span> is selected, the generated report contains intent recommendations against the selected taxonomy. A taxonomy is a prebuilt library of intents in a specific domain. While you don't have access to the underlying intents, when you run <span class="ph">Intent Discovery</span> against a specific taxonomy, data that maps to any intent in the taxonomy will be identified.</li><li class="li"><span class="ph uicontrol">Unmatched records</span> are the utterances which couldn't match to any intent in the taxonomy.</li><li class="li"><span class="ph uicontrol">Recommended intents</span> are the intents which are found from utterances that data was run on.</li><li class="li">The percentage of <span class="ph uicontrol">Unmatched records (clustered)</span> are the records that aren't classified (records that don't belong to any of the recommended intents).</li><li class="li">The percentage of unmatched records and the number of recommended intents don't need to match. It's a coincidence if they match.</li></ul> </div> </div> <div class="section" id="intent-discovery__section_fyy_155_vnb"><h2 class="title sectiontitle">Creating an <span class="ph">Intent Discovery</span> report</h2> <p class="p">1. Using the admin or nlu_admin role, navigate to <span class="ph menucascade"><span class="ph uicontrol">All</span> > <span class="ph uicontrol">NLU Workbench</span> > <span class="ph uicontrol">NLU Advanced Features</span> > <span class="ph uicontrol">Intent Discovery</span></span>.</p> <div class="p">2. Select either <span class="ph uicontrol">Run analysis</span> or <span class="ph uicontrol">Find recommendations</span>.<div class="fig fignone" id="intent-discovery__fig_nyq_lyx_xcc"><span class="figcap"><span class="fig--title-label">Figure 1. </span><span class="ph">Intent Discovery</span> landing page</span> <img class="image" id="intent-discovery__image_tyq_lyx_xcc" src="../images/intent-discovery1w.png" alt="On the Intent Discovery landing page, buttons for Run analysis and Find recommendations are highlighted." /> </div> </div> </div> <div class="section" id="intent-discovery__section_l2s_ssd_wnb"><h2 class="title sectiontitle">Running an analysis on the report</h2> <div class="p">1. For this example report, you configure the following fields on the <span class="ph">Intent Discovery</span> > Create new screen.<ul class="ul" id="intent-discovery__ul_qjk_m33_wnb"><li class="li">Data Source: Select the <span class="ph uicontrol">Incident (incident)</span> table.</li><li class="li">Filter by: <span class="ph uicontrol">[Created] [on] [This quarter]</span></li><li class="li">Field to analyze: <span class="ph uicontrol">Short description (short_description)</span>. You choose Short description because it's a highly used string field that references words that can help the system identify an intent.</li><li class="li">Taxonomy: Select <span class="ph uicontrol">ITSM</span>. This field tells the system to run classification processing on your ITSM incident records. It has 3 options: Classification, ITSM, or blank, which defaults as Classification.</li><li class="li">Cluster unmapped utterances by keywords... : Select the <span class="ph uicontrol">check box</span>. When you check this box, the system groups your incident records that weren't classified into clusters.</li><li class="li">Report name: The field automatically defaults to <span class="ph uicontrol">Incident <month/day/year></span>. You can edit the name if you prefer. In this example scenario, you enter Incident 12/16/2020 - SF Test.</li></ul> </div> <p class="p">2. Select <span class="ph uicontrol">Run analysis</span>.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_xgr_cg3_wnb"><span class="figcap"><span class="fig--title-label">Figure 2. </span>Selecting data sources in <span class="ph">Intent Discovery</span> for a run analysis</span> <img class="image" id="intent-discovery__image_fnz_gg3_wnb" src="../images/intent-discovery2.png" alt="The Intent Discovery > Create New screen and the fields you need to configure before you select Run Analysis" /> </div> </div> <p class="p"><span class="ph uicontrol">Result</span>: Your report appears on the <span class="ph">Intent Discovery</span> screen, showing its status as the analysis begins. The subsequent status values appear in the following order during the analysis: Preparing to run, Work in progress, Clustering, and Done. This can take from 5 minutes to 30 minutes to complete. The fewer the records you have in a cluster, the less time it takes. Turning clustering off can also speed up the process.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_ic5_s43_wnb"><span class="figcap"><span class="fig--title-label">Figure 3. </span>An ongoing run analysis</span> <img class="image" id="intent-discovery__image_l4n_y43_wnb" src="../images/intent-discovery3.png" alt="Your report appears on the Intent Discovery screen where the analysis shows its ongoing status as its job begins and ends" /> </div> </div> <div class="p">When the analysis is complete, the column values on the screen appear, with the <span class="ph uicontrol">Status</span> column value set to <span class="ph uicontrol">Done</span>, as shown in the image below.<div class="note"><span class="notetitle">Note:</span> If you want to delete the report and start over, point to the right of the Status column to invoke the <span class="ph uicontrol">Delete report</span> icon.</div> </div> <p class="p">3. Select the <span class="ph uicontrol">Name</span> of your report.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_l1p_m53_wnb"><span class="figcap"><span class="fig--title-label">Figure 4. </span>A completed run analysis</span> <img class="image" id="intent-discovery__image_qqf_p53_wnb" src="../images/intent-discovery4.png" alt="The report column values have appeared, as the analysis is complete and its status value is set to Done" /> </div> </div> <p class="p"><span class="ph uicontrol">Result</span>: The screen refreshes, showing the analyzed incident records and the remaining incident records that were not classified.</p> </div> <div class="section" id="intent-discovery__section_xrn_pqd_wnb"><h2 class="title sectiontitle">Importing recommended intents to new or existing custom models</h2> <p class="p">Before importing intents to an <span class="ph">NLU</span> model, ensure that you are in the same application scope as the model. For more information, see <a class="xref" href="../build/applications/task/t_SelectAnAppFromTheAppPicker.dita/t_SelectAnAppFromTheAppPicker.html" target="_blank" rel="noopener noreferrer">Select an application from the application picker</a>.</p> <p class="p">1. On the Records covered by recommendations section of the screen, select the caret icon on a recommended intent you want to add to a custom model.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_xvy_xw3_wnb"><span class="figcap"><span class="fig--title-label">Figure 5. </span>Reviewing a recommended intent</span> <img class="image" id="intent-discovery__image_mj3_zw3_wnb" src="../images/intent-discovery5.png" alt="Instructions to click the caret button which opens to reveal the details of the recommended intent" /> </div> </div> <p class="p"><span class="ph uicontrol">Result</span>: The details of the recommended intent appear so you can review them, as shown in the image below.</p> <p class="p">2. Select <span class="ph uicontrol">Add to Model</span>.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_nxb_hy3_wnb"><span class="figcap"><span class="fig--title-label">Figure 6. </span>Adding a recommended intent to a model</span> <img class="image" id="intent-discovery__image_pls_jy3_wnb" src="../images/intent-discovery6.png" alt="The recommended intent details are shown with an instruction to add them to a model" /> </div> </div> <div class="p">3. On the Select a destination model screen that appears, choose a model you want to add the recommended intent to. If you can't find an appropriate model, create a new one, return to the report, and add the new model. <div class="note"><span class="notetitle">Note:</span> The model you choose must have the same application scope as your current scope.</div> </div> <p class="p">4. Select <span class="ph uicontrol">Save</span>.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_ljr_v2j_wnb"><span class="figcap"><span class="fig--title-label">Figure 7. </span>Saving a recommended intent to a model</span> <img class="image" id="intent-discovery__image_yj2_x2j_wnb" src="../images/intent-discovery7.png" alt="The model you choose to associate to the recommended intent is followed by an instruction to select the Save button" /> </div> </div> <p class="p"><span class="ph uicontrol">Result</span>: A banner appears on the screen, confirming the intent is added to the target model.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_kvr_jgj_wnb"><span class="figcap"><span class="fig--title-label">Figure 8. </span>Confirmation of adding a recommended intent to a target model</span> <img class="image" id="intent-discovery__image_cht_qgj_wnb" src="../images/intent-discovery8.png" alt="A banner that confirms the recommended intent you chose has been successfully added to the target model" /> </div> </div> <p class="p">The recommended intent also appears on the Model screen of the target model, as shown in the image below.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_zpv_bhj_wnb"><span class="figcap"><span class="fig--title-label">Figure 9. </span>View a recommended intent in the target model</span> <img class="image" id="intent-discovery__image_pf4_dhj_wnb" src="../images/intent-discovery9.png" alt="The recommended intent is now visible in the Model screen of the target model" /> </div> </div> </div> <div class="section" id="intent-discovery__section_fmv_pqd_wnb"><h2 class="title sectiontitle">Adding clustered utterances to an intent and its model</h2> <p class="p">1. On the Remaining records section of the intent discovery records screen, select and open a cluster of utterance and short description data that you want to add to an intent and its associated model.</p> <p class="p">As you continue to build out new intents from these clusters, you can click the <span class="ph uicontrol">Ignore</span> icon to remove any unwanted intents from the report.</p> <p class="p">There's also a <span class="ph uicontrol">Show Additional</span> filter you can use to show or hide the added intents, and the ignored intents as well.</p> <p class="p">2. Select <span class="ph uicontrol">Add to intent</span>.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_dlt_q1q_wnb"><span class="figcap"><span class="fig--title-label">Figure 10. </span>Adding a cluster to an intent</span> <img class="image" id="intent-discovery__image_qwx_r1q_wnb" src="../images/intent-discovery10.png" alt="The cluster you chose to add to an intent. Select the Add to Intent button or choose the Ignore button if you want to remove the cluster from the report" /> </div> </div> <p class="p">3. In the Add this cluster to an intent and model screen, select an intent and model pair you want to associate to this cluster.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_djf_fcq_wnb"><span class="figcap"><span class="fig--title-label">Figure 11. </span>Adding a cluster to an intent and model</span> <img class="image" id="intent-discovery__image_vbw_gcq_wnb" src="../images/intent-discovery11.png" alt="How to add an a cluster to an intent and its model" /> </div> </div> <p class="p">4. Enter a few utterance examples into the open text field. Select <span class="ph uicontrol">Add</span> each time you complete your entry to save it in the system. Use the pencil icon or the trash can icon respectively to edit or delete your entry.</p> <p class="p">5. Select <span class="ph uicontrol">Save</span>.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_ncn_rgq_wnb"><span class="figcap"><span class="fig--title-label">Figure 12. </span>Adding paraphrased utterances to an intent</span> <img class="image" id="intent-discovery__image_j4x_sgq_wnb" src="../images/intent-discovery12.png" alt="Instruction to add and save paraphrased utterances to an intent" /> </div> </div> <p class="p"><span class="ph uicontrol">Result</span>: The records screen appears, showing a banner confirming you added two new utterances to the target intent and its associated model. The model and intent pair appears in the <span class="ph uicontrol">Added To</span> column, as shown in the image below.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_oyd_ymr_wnb"><span class="figcap"><span class="fig--title-label">Figure 13. </span>Confirmation of adding paraphrased utterances to an intent</span> <img class="image" id="intent-discovery__image_t2l_zmr_wnb" src="../images/intent-discovery13.png" alt="A banner that confirms the utterances you added to the intent are successfully added" /> </div> </div> <p class="p">Use the <span class="ph uicontrol">Show Additional</span> filter if you want to show or hide the clusters that have added intents, and the clusters that are ignored.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_ez2_dn3_f4b"><span class="figcap"><span class="fig--title-label">Figure 14. </span>Viewing or hiding clusters and ignored clusters</span> <img class="image" id="intent-discovery__image_pqh_hn3_f4b" src="../images/intent-discovery13a.png" alt="How to show or hide clusters that have added intents, and those that you have marked as ignored" /> </div> </div> </div> <div class="section" id="intent-discovery__section_gwv_sqd_wnb"><h2 class="title sectiontitle">Running another analysis on your <span class="ph">Intent Discovery</span> report</h2> <p class="p">1. Select <span class="ph uicontrol">Run Again</span>.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_xbd_2gs_wnb"><span class="figcap"><span class="fig--title-label">Figure 15. </span>Selecting the version of the analysis to run</span> <img class="image" id="intent-discovery__image_on2_3gs_wnb" src="../images/intent-discovery14.png" alt="Instruction to choose the version of the analysis you want to run" /> </div> </div> <p class="p"><span class="ph uicontrol">Result</span>: The new run begins. When it's in progress, the option to cancel the run appears, as shown in the image below.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_nhk_hfs_wnb"><span class="figcap"><span class="fig--title-label">Figure 16. </span>The Cancel Run option</span> <img class="image" id="intent-discovery__image_gxx_jfs_wnb" src="../images/intent-discovery15.png" alt="An image that shows the Cancel Run option is available during the first few minutes of the In Progress phase of the run" /> </div> </div> <p class="p">When the run is complete, a new banner appears that states you have a new version of the report.</p> <p class="p">2. Select the new version, then select <span class="ph uicontrol">Run Again</span>.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_r4n_x5c_14b"><span class="figcap"><span class="fig--title-label">Figure 17. </span>Selecting the new version of the report</span> <img class="image" id="intent-discovery__image_q3r_z5c_14b" src="../images/intent-discovery16.png" alt="How to select the new version of the report." /> </div> </div> <p class="p"><span class="ph uicontrol">Result</span>: The time stamp you selected for the most recent run appears in the <span class="ph uicontrol">Run date</span> column of the <span class="ph">Intent Discovery</span> screen.</p> <div class="p"><div class="fig fignone" id="intent-discovery__fig_dvr_2vc_14b"><span class="figcap"><span class="fig--title-label">Figure 18. </span>View the new time stamp of the <span class="ph">Intent Discovery</span> report</span> <img class="image" id="intent-discovery__image_jl4_gvc_14b" src="../images/intent-discovery17.png" alt="The new time stamp of the Intent Discovery report" /> </div> </div> </div> </div> <div class="related-links"> <ul class="ullinks"><li class="link ulchildlink"><strong><a href="../../../administer/natural-language-understanding/task/install-intent-discovery.html">Install Intent Discovery</a></strong><br /> You can install the <span class="ph">Intent Discovery</span> application (<span class="ph">sn_nlu_discovery</span>) if you have the admin role.</li></ul> <div class="familylinks"> <div class="parentlink"><strong>Parent Topic:</strong> <a class="link" href="../../../administer/natural-language-understanding/concept/nlu-workbench-advanced-features.html" title="NLU Workbench - Advanced Features expands the functionality of NLU Workbench to help you manage and improve your models.">NLU Workbench - Advanced Features</a></div> </div> </div></body></html></div>