--- sourceDocument: Australia Enable AI sourceDocumentLink: https://www.servicenow.com/docs/r/australia/intelligent-experiences Release : - australia ft:locale : - en-US ft:publication_title : - Australia Enable AI ft:clusterId : - platai bundleId : - platai workflow : - Platform --- # Trigger ServiceNow AI Lens from the desktop app # Trigger ServiceNow AI Lens from the desktop app {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read Trigger ServiceNow AI Lens from the desktop app by using a Lens action to preview the extracted data and initiate post processing or auto-fill a form. ## Before you begin To access the ServiceNow AI Lens functionality, perform the following steps: * Install ServiceNow AI Lens on your ServiceNow instance. For more information, see [Install the ServiceNow Lens in the ServiceNow instance](https://www.servicenow.com/docs/hsUx9Gnce8BHUGjlLOjyFA "If you have the admin role, you can enable the ServiceNow AI Lens application (sn_ai_lens) to extract and comprehend data for various workflows."). * Turn on the ServiceNow AI Lens skill to add the generative AI capability. For more information, see [Activate the ServiceNow AI Lens skill](https://www.servicenow.com/docs/UeGVMSFuC2iNUXfXo4368w "Activate the ServiceNow AI Lens skill to start using generative AI to scan and analyze visual data such as scan artifacts such as images, scanned handwritten notes, Excel sheets, web pages and optimize your workflows."). * Download the ServiceNow AI Lens installer to scan your desktop screen. For more information, see [Download and set how you want to launch ServiceNow AI Lens](https://www.servicenow.com/docs/Xs5BK91oVE8ri8mlyv~ZxQ "Download the ServiceNow AI Lens installer for your operating system and set your preferred way to launch ServiceNow AI Lens — from your browser or the desktop application."). {#preview-desktop-others-lens__ul_urn_w5j_y2c} Verify that you've defined the Lens action for this purpose. For more information, see [Define a Lens action.](https://www.servicenow.com/docs/2PLaSe9SC9lrZ3sZ0SYPGg#create-sn-lens-recipe "Create a Lens action to define custom context, trigger options, and default instructions for the ServiceNow AI Lens execution.") Verify that ServiceNow AI Lens has access to record the screen on your system. For more information, see [Providing permission to ServiceNow AI Lens](https://www.servicenow.com/docs/Xs5BK91oVE8ri8mlyv~ZxQ#download-sn-lens-msi__lens-permission). You must have create and update access privileges for creating or updating a record using ServiceNow AI Lens. Don't scan any personally identifiable information, such as medical reports, financial reports, or other sensitive data, when using ServiceNow AI Lens as you don't want to expose the large language model (LLM) to any sensitive information. Role required: lens_user ## About this task By using Lens actions, you can perform one of the following tasks: Fill a form : In the Lens action configuration, when Trigger From is Desktop and Trigger For is Form, and a table is selected, ServiceNow AI Lens can be triggered from the desktop to auto-fill a form. It first shows a preview of the data, and if the preview is editable, you can edit the fields before saving. After you select Submit in the preview window, it saves the form with the updated data on the ServiceNow instance. Preview the extracted data : In the Lens action configuration, when Trigger From is Desktop and Trigger For is Others, ServiceNow AI Lens can be triggered from the desktop to show preview of the extracted data. If the preview is editable, you can edit the fields before saving. After you select Submit and close preview in the preview window, it saves the data and initiates post processing. ## Procedure 1. From your system, launch the ServiceNow AI Lens desktop application. 2. On the login page, in the Instance URL field, enter the ServiceNow instance URL. For example, https://\.service-now.com. 3. Select Proceed. 4. Log in to your ServiceNow account by entering your username and password. Your account must have the lens_user role. Note: * If your administrator has enabled auto-login, you can skip signing in every time you launch ServiceNow AI Lens. After your first login, ServiceNow AI Lens automatically takes you to the home page on subsequent launches as long as your session is active. If your session expires or you sign out, ServiceNow AI Lens shows the login screen again. For more information, see [Set up auto-login for ServiceNow AI Lens](https://www.servicenow.com/docs/aWPFIlJO~GNrLwhYTJ829g "Pre-configure your organization's ServiceNow instance URL so that it appears ready-filled when users launch the ServiceNow AI Lens desktop application, and enable auto-login so that users can skip signing in on subsequent launches."). * On macOS, when you launch ServiceNow AI Lens desktop app for the first time, your Mac asks whether ServiceNow AI Lens can store your login credentials. Select Always Allow to avoid entering your credentials every time you open the application. {#preview-desktop-others-lens__ul_onx_1f5_z3c} 5. **Optional:** On the onboarding journey widget, complete the onboarding and select Got it. If you launch the ServiceNow AI Lens for the first time, the onboarding journey widget appears. You can select Don't show me again to hide the widget the next time you launch ServiceNow AI Lens. 6. Select a Lens action. 7. Select Proceed with Lens. Lens scanner opens in a separate window. 8. Perform one of the following methods to enable ServiceNow AI Lens to extract data from documents. * Extract data from a single screen. 1. On your system, open an artifact that you want to scan.An artifact can be an image, scanned or handwritten note, website, or application. 2. Place the ServiceNow AI Lens scanner window on the top of the artifact. You can resize the ServiceNow AI Lens scanner window by dragging its borders. {#preview-desktop-others-lens__ol_b2p_1wb_fkc} * Extract data from multiple screenshots. 1. Select the Multi-capture button ![](). 2. Select the Capture icon ![](). 3. Place the ServiceNow AI Lens scanner window over another document or page and then select the Capture icon ![](). 4. Repeat the step to capture more screenshots, if required. Figure 1. Display of the number of screenshots captured Note: * You can capture a total of 10 screenshots with the combined size of all captured screenshots not exceeding 10 MB. * To enable the desktop app to send large screenshot data to the server, confirm that the following system properties are set exactly as shown below: {#preview-desktop-others-lens__table_f42_crm_g3c__entry__3} | Property name | Type | Recommended value | |-|-|-| | glide.rest.max_content_length | Integer | 15 | | glide.rest.scripted.max_inbound_content_length_mb | Integer | 15 | [Table 1. System property] {#preview-desktop-others-lens__table_f42_crm_g3c} For more information, see [Configure system property](https://www.servicenow.com/docs/access?context=r_ControllingMaxRequestSize&version=australia&pubname=australia-api-reference&ft:locale=en-US) Note: You must have the admin role to set the system properties. {#preview-desktop-others-lens__ul_rft_fwl_g3c} 5. To complete the capture, select the Done icon ![](). {#preview-desktop-others-lens__ol_y1m_pwb_fkc} * Extract data from uploaded documents. 1. Select the Upload files icon ![]().s 2. Perform any one of the following file upload methods. * Upload one or more files by selecting the +Add file option. * Upload one or more files by dragging the selected files to the Drag and drop files section and then select Upload all. {#preview-desktop-others-lens__ul_cqz_lmt_dkc} Note: * You can upload up to 10 unprotected files, with the combined size of the uploaded files not exceeding 10 MB. * To enable the desktop app to send large data of the uploaded files to the server, confirm that the following system properties are set exactly as shown below: {#preview-desktop-others-lens__table_wf3_ghw_2kc__entry__3} | Property name | Type | Recommended value | |-|-|-| | glide.rest.max_content_length | Integer | 15 | | glide.rest.scripted.max_inbound_content_length_mb | Integer | 15 | [Table 2. System property] {#preview-desktop-others-lens__table_wf3_ghw_2kc} For more information, see [Configure system property](https://www.servicenow.com/docs/access?context=r_ControllingMaxRequestSize&version=australia&pubname=australia-api-reference&ft:locale=en-US) Note: You must have the admin role to set the system properties. * To remove a file that you attached, select the Remove file icon ![](). * To rename the file that you attached, select the More options icon ![](), and then select Rename. {#preview-desktop-others-lens__ul_agf_25t_g3c} 3. Select Next. The ServiceNow AI Lens preview window displays the files that you have uploaded {#preview-desktop-others-lens__ol_lqj_yls_wjc} {#preview-desktop-others-lens__choices_rtf_xvb_fkc} 9. To provide instructions to analyze the data in screenshots in a specific way, select the Edit icon ![](), and enter the instructions. The default character limit is 500. Users with the admin role can increase this limit to up to 5000 characters by navigating to the sn_lens_user_prompt_max_length system property. 10. To analyze the data in the screenshots that you captured, select Analyze. The ServiceNow AI Lens preview window displays the extracted output in an editable form. Figure 2. Preview of extracted output displayed in an editable form 11. Depending on the type of Lens action selected, perform the following steps. | Task | Steps | | Filling form | 1. (Optional) In case of editable preview, if necessary, edit the auto-filled field values before saving. 2. On the form header in the Preview window, select Submit to save the filled form on the instance. {#preview-desktop-others-lens__ol_ln2_m2d_ngc} | | Previewing extracted data | 1. (Optional) In case of editable preview, if necessary, edit the auto-filled field values before saving or copying the values. 2. (Optional) Copy the previewed data by selecting the Copy icon ![](). {#preview-desktop-others-lens__ol_pdy_qdx_mgc} | |-|-| {#preview-desktop-others-lens__choicetable_vdv_pdx_mgc} 12. End the current session by selecting Start new session. {#preview-desktop-others-lens__steps_ikk_pk1_1gc}