--- sourceDocument: Australia IT Service Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Reusable ITSM Virtual Agent pre-built topic blocks # Reusable ITSM Virtual Agent pre-built topic blocks {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes to read Reuse topic blocks to perform common functions in ITSM Virtual Agent conversations, such as creating an incident or performing a search. Use the Type list on the Topics page in Virtual Agent Designer to sort by Topic Blocks. For detailed information about topic blocks, see [Maximizing code reuse with topic blocks](https://www.servicenow.com/docs/access?context=topic-blocks-overview&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US). ITSM Virtual Agent provides the following pre-built topic blocks and templates. Note: Many of these topic blocks are available with the Service Management Virtual Agent Topic Blocks plugin (com.glideapp.cs.sm_topic_blocks). For more information about plugins, see [ServiceNow Plugins](https://www.servicenow.com/docs/access?context=c_ServiceNowPlugins&version=australia&pubname=australia-platform-administration&ft:locale=en-US) ## Contextual Search {#itsm-va-topic-blocks__section_mfx_jyp_tvb} {#itsm-va-topic-blocks__table_ih3_w5f_hmb__entry__2} | Name | Description | |-|-| | Input parameters || | context | The sys_id of a Search Context (cxs_context_config) record. Defines what sources are included in the search. For example, sources can include the knowledge base or community. | | query | The search keyword entered by a user during a virtual agent conversation. | | portal | The portal from which the conversation initiated, such as a service portal or human resources portal. This portal is the URL suffix, such as sp, esc, csm, and hr, from which the search results open. | | kb_knowledge_base | The sys_id of a Knowledge Base (kb_knowledge_base) record. Within context, search only these knowledge base articles. | | Output parameters || | results_returned | True if search results are found, otherwise false​. | | results_helpful | True if user responds that search results are helpful, otherwise false​. | [Table 1. Contextual Search topic block input and output parameters] {#itsm-va-topic-blocks__table_ih3_w5f_hmb} ## Create Incident {#itsm-va-topic-blocks__section_x5g_5yp_tvb} This topic block initiates the Open IT Ticket conversation topic. {#itsm-va-topic-blocks__table_bfz_tyf_hmb__entry__2} | Name | Description | |-|-| | Input parameters || | caller | The name of the user creating an Incident (incident) record. | | short_description | The short description entered in the Incident (incident) record. | | urgency | The urgency level indicated in the Incident (incident) record. | | description | The description entered in the Incident (incident) record. | | cmdb_ci | CMDB configuration item. | | Output parameters || | created_incident_sys_id | The return sys_id of a newly created incident​. | [Table 2. Create Incident topic block input and output parameters] {#itsm-va-topic-blocks__table_bfz_tyf_hmb} ## Create MS Teams Meeting Link (deprecated) {#itsm-va-topic-blocks__section_fcf_krp_tvb} This topic block is deprecated. Use [Get MS Teams Meeting Link](https://servicenow-prod.fluidtopics.net/YwgSPWPkDoFzppg6VKLM1A "ITSM Virtual Agent helps you manage meetings in Microsoft Exchange Online. Using the Manage Meetings EXO v1.0 topic, you can schedule, reschedule, and cancel a meeting.") instead. Users can request a Microsoft Teams meeting link using Virtual Agent. This topic block can be included in other topics. By default, this topic block runs in silent mode, and the output messages are not displayed. Requirement: [Microsoft Teams Communication spoke](https://www.servicenow.com/docs/access?context=msteams-comm&version=australia&pubname=australia-integrate-applications&ft:locale=en-US) (sn_msteams_com_spk) plugin ## Create Zoom Meeting Link {#itsm-va-topic-blocks__section_rrw_m1q_tvb} For more actions, the [Zoom Meeting Actions](https://servicenow-prod.fluidtopics.net/YwgSPWPkDoFzppg6VKLM1A "ITSM Virtual Agent helps you manage meetings in Microsoft Exchange Online. Using the Manage Meetings EXO v1.0 topic, you can schedule, reschedule, and cancel a meeting.") topic block is also available. Users can request a Zoom meeting link using Virtual Agent. This topic block can be included in other topics. By default, this topic block runs in silent mode, and the output messages are not displayed. Requirement: [Zoom spoke](https://www.servicenow.com/docs/access?context=zoom-spoke&version=australia&pubname=australia-integrate-applications&ft:locale=en-US)(com.sn.zoom.spoke) plugin ## Describe Virtual Machine {#itsm-va-topic-blocks__section_mdt_khh_vvb} Users can get details on any assigned virtual machine (VM) instance using the [Manage Virtual Machine topic](https://servicenow-prod.fluidtopics.net/bPgq5DLSQlLhGnsO1eT3ew "ITSM Virtual Agent helps you manage a virtual machine (VM) using conversation flows. With this conversation flow, you can start, stop, terminate, describe, and provision a virtual machine.") in Virtual Agent. Details include Provider, Region, Instance ID, and so forth. Basic flow: 1. User specifies which VM to describe, or Virtual Agent provides a list of available VM instances for the user to choose from. 2. Virtual Agent provides the requested virtual machine details. 3. To get additional details, users can select the link provided, which redirects them to the [Cloud User Portal](https://www.servicenow.com/docs/access?context=cloudmgt-cloud-user-portal&version=australia&pubname=australia-it-operations-management&ft:locale=en-US). {#itsm-va-topic-blocks__ol_zb2_wl4_vvb} {#itsm-va-topic-blocks__table_eqd_jz3_vvb__entry__2} | Name | Description | |-|-| | Input parameter: vm_name | Name of the virtual machine instance. | | Input parameter: vm_sys_id | Sys ID of the virtual machine instance in the cmdb_ci_vm_instance table. | | Output parameter: incident_short_description | Short description for the Incident record, if one is recorded. | [Table 3. Describe Virtual Machine topic block input and output parameters] {#itsm-va-topic-blocks__table_eqd_jz3_vvb} ## Display Password Reset URLs {#itsm-va-topic-blocks__section_pxr_hmb_vvb} If Password Reset is enabled on Virtual Agent, and the user has been authenticated, this topic block returns a password reset link. If Password Reset is not enabled, the user is directed to the service desk. This topic block as one input parameter: unlock_account. If the user has been authenticated, the value is true. Otherwise, the value is false. For more information, see [Password Reset for Virtual Agent](https://www.servicenow.com/docs/access?context=password-reset-for-virtual-agent&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). This topic block has one input parameter: unlock_account. If the user has been authenticated, the value is true. Otherwise, the value is false. ## Request Catalog Item {#itsm-va-topic-blocks__section_r3m_jq1_vvb} For information about this topic block, see [Service Catalog topic blocks in Virtual Agent](https://www.servicenow.com/docs/access?context=request-topic-blocks-va&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). ## Search Catalog Item {#itsm-va-topic-blocks__section_dnt_qs1_vvb} For information about this topic block, see [Service Catalog topic blocks in Virtual Agent](https://www.servicenow.com/docs/access?context=request-topic-blocks-va&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). ## Start Virtual Machine {#itsm-va-topic-blocks__section_spr_lhh_vvb} Users can start any assigned VM instance using the [Manage Virtual Machine topic](https://servicenow-prod.fluidtopics.net/bPgq5DLSQlLhGnsO1eT3ew "ITSM Virtual Agent helps you manage a virtual machine (VM) using conversation flows. With this conversation flow, you can start, stop, terminate, describe, and provision a virtual machine."). If the VM is already on or in a state where it cannot be started, Virtual Agent notifies the user. Basic flow: 1. User specifies which VM to start, or Virtual Agent provides a list of available VM instances for the user to choose from. 2. Virtual Agent sends the user an actionable notification when the requested VM starts. Virtual Agent also notifies the user if the operation was unsuccessful. 3. User can choose to see details, request additional instructions to log in to the virtual machine, or skip the notification. 4. If the user requests additional login instructions, Virtual Agent provides these instructions and the user can confirm if the login was successful. {#itsm-va-topic-blocks__ol_krz_gq4_vvb} {#itsm-va-topic-blocks__table_xxg_rtn_vvb__entry__2} | Name | Description | |-|-| | Input parameter: vm_name | Name of the virtual machine instance. | | Output parameter: incident_short_description | Short description for the Incident record, if one is recorded. | [Table 4. Start Virtual Machine topic block input and output parameters] {#itsm-va-topic-blocks__table_xxg_rtn_vvb} ## Stop Virtual Machine {#itsm-va-topic-blocks__section_l3g_mhh_vvb} Users can stop any assigned VM instance using the [Manage Virtual Machine topic](https://servicenow-prod.fluidtopics.net/bPgq5DLSQlLhGnsO1eT3ew "ITSM Virtual Agent helps you manage a virtual machine (VM) using conversation flows. With this conversation flow, you can start, stop, terminate, describe, and provision a virtual machine."). If the VM is already off or is in a state where it cannot be stopped, Virtual Agent notifies the user. Basic flow: 1. User specifies which VM to stop, or Virtual Agent provides a list of available VM instances for the user to choose from. 2. Virtual Agent sends the user an actionable notification when the requested VM has stopped. Virtual Agent also notifies the user if the operation was unsuccessful. 3. User can choose to see details or skip the notification. {#itsm-va-topic-blocks__ol_gg3_qq4_vvb} {#itsm-va-topic-blocks__table_sfv_stn_vvb__entry__2} | Name | Description | |-|-| | Input parameter: vm_name | Name of the virtual machine instance. | | Output parameter: incident_short_description | Short description for the Incident record, if one is recorded. | [Table 5. Stop Virtual Machine topic block input and output parameters] {#itsm-va-topic-blocks__table_sfv_stn_vvb} ## Terminate Virtual Machine {#itsm-va-topic-blocks__section_ftt_mhh_vvb} Users can terminate any assigned virtual machine (VM) instance using the [Manage Virtual Machine topic](https://servicenow-prod.fluidtopics.net/bPgq5DLSQlLhGnsO1eT3ew "ITSM Virtual Agent helps you manage a virtual machine (VM) using conversation flows. With this conversation flow, you can start, stop, terminate, describe, and provision a virtual machine."). If the VM is already terminated or is in a state where it cannot be terminated, Virtual Agent notifies the user. Basic flow: 1. User specifies which VM to terminate, or Virtual Agent provides a list of available VM instances for the user to choose from. 2. Virtual Agent provides the details of the requested VM to terminate. 3. Terminating a virtual machine is a permanent action, so the user must confirm the operation to continue. 4. Virtual Agent sends the user an actionable notification when the requested virtual machine has been terminated. {#itsm-va-topic-blocks__ol_zd5_xq4_vvb} {#itsm-va-topic-blocks__table_jw4_ttn_vvb__entry__2} | Name | Description | |-|-| | Input parameter: vm_name | Name of the virtual machine instance. | | Output parameter: incident_short_description | Short description for the Incident record, if one is recorded. | [Table 6. Terminate Virtual Machine topic block input and output parameters] {#itsm-va-topic-blocks__table_jw4_ttn_vvb} ## Troubleshoot Cisco Webex {#itsm-va-topic-blocks__section_wxj_1bq_tvb} Users can find a solution for common Webex issues. This topic block is used in the [Collaboration Applications](https://servicenow-prod.fluidtopics.net/g47jtBmHJujaYdYy_VEixQ "IT Issues topic conversations are designed to automate common IT-related issues, such as email setup, VPN connectivity, and conference room problems.") topic. If the user is not satisfied with the static help content for the issue, the fallback is AI search or contextual search. The type of search is dictated by the system property sn_itsm_va.fallback_search_option.​ {#itsm-va-topic-blocks__table_owt_vzn_vvb__entry__2} | Name | Description | |-|-| | Input parameter || | issue | The user application issue. | | Output parameter || | user_query | Problem string used for search fallback. | [Table 7. Troubleshoot Cisco Webex topic block input and output parameters] {#itsm-va-topic-blocks__table_owt_vzn_vvb} ## Troubleshoot Microsoft Teams {#itsm-va-topic-blocks__section_cjj_bbq_tvb} Users can find a solution for common Microsoft Teams issues. This topic block is used in the [Collaboration Applications](https://servicenow-prod.fluidtopics.net/g47jtBmHJujaYdYy_VEixQ "IT Issues topic conversations are designed to automate common IT-related issues, such as email setup, VPN connectivity, and conference room problems.") topic. If the user is not satisfied with the static help content for the issue, the fallback is AI search or contextual search. The type of search is dictated by the system property sn_itsm_va.fallback_search_option.​ {#itsm-va-topic-blocks__table_ajg_hvw_fwb_xdcks__entry__2} | Name | Description | |-|-| | Input parameter || | issue | The user application issue. | | Output parameter || | user_query | Problem string used for search fallback. | [Table 8. Troubleshoot Microsoft Teams topic block input and output parameters] {#itsm-va-topic-blocks__table_ajg_hvw_fwb_xdcks} ## Troubleshoot Zoom {#itsm-va-topic-blocks__section_nzb_dbq_tvb} Users can find a solution for common Zoom issues. This topic block is used in the [Collaboration Applications](https://servicenow-prod.fluidtopics.net/g47jtBmHJujaYdYy_VEixQ "IT Issues topic conversations are designed to automate common IT-related issues, such as email setup, VPN connectivity, and conference room problems.") topic. If the user is not satisfied with the static help content for the issue, the fallback is AI search or contextual search. The type of search is dictated by the system property sn_itsm_va.fallback_search_option.​ {#itsm-va-topic-blocks__table_bg3_214_vvb__entry__2} | Name | Description | |-|-| | Input parameter || | issue | The user application issue. | | Output parameters || | user_query | Problem string used for search fallback. | | ticket_description | Problem string used to create an IT ticket. | [Table 9. Troubleshoot Zoom topic block input and output parameters] {#itsm-va-topic-blocks__table_bg3_214_vvb} ## Virtual Machine Operation AWS {#itsm-va-topic-blocks__section_ixl_twn_vvb} Users can use the Cloud Access Interface to take action on virtual machines provisioned on Amazon AWS. The user must have the sn_managevm_va.cai_vm_user role. This topic block is used in the [virtual machine management CAI](https://servicenow-prod.fluidtopics.net/bPgq5DLSQlLhGnsO1eT3ew "ITSM Virtual Agent helps you manage a virtual machine (VM) using conversation flows. With this conversation flow, you can start, stop, terminate, describe, and provision a virtual machine.") pre-built topics. Available actions include Stop, Start, Terminate, or Describe the virtual machine. ## Virtual Machine Operation Azure {#itsm-va-topic-blocks__section_jzs_x1q_tvb} Users can use the Cloud Access Interface to take action on virtual machines provisioned on Microsoft Azure. The user must have the sn_managevm_va.cai_vm_user role. This topic block is used in the [virtual machine management CAI](https://servicenow-prod.fluidtopics.net/bPgq5DLSQlLhGnsO1eT3ew "ITSM Virtual Agent helps you manage a virtual machine (VM) using conversation flows. With this conversation flow, you can start, stop, terminate, describe, and provision a virtual machine.") pre-built topics. Available actions include Stop, Start, Terminate, or Describe the virtual machine. * **[Employee Experience topic blocks](https://servicenow-prod.fluidtopics.net/YwgSPWPkDoFzppg6VKLM1A)** ITSM Virtual Agent helps you manage meetings in Microsoft Exchange Online. Using the Manage Meetings EXO v1.0 topic, you can schedule, reschedule, and cancel a meeting.