---
sourceDocument: Australia Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/conversational-interfaces
Release :
- australia
ft:locale :
- pt-BR
ft:publication_title :
- Australia Conversational Interfaces
ft:clusterId :
- convint
bundleId :
- convint
workflow :
- Platform
---
# Virtual Agent pre-built topic blocks
# Virtual Agent pre-built topic blocks {#ariaid-title1}
* Versão de lançamento: Australia
*
* Atualizado 12 de mar. de 2026
*
*  10 min. de leitura
Virtual Agent provides pre-built topic blocks that topic authors or
admins can use to perform specific platform-related functions or tasks in bot conversations.
For example, certain topic blocks enable you to check agent availability or generate AI Search results.
## Overview of pre-built topic blocks {#va-platform-topicblocks__section_qvl_5nx_nnb}
Certain pre-built topic blocks are included automatically with the Glide Virtual Agent (com.glide.cs.chatbot) plugin and Virtual Agent Lite. If you're using Virtual Agent Lite, you have read access to the topic blocks but you can't create topic blocks or add them to calling topics.
You can duplicate pre-built topic blocks and modify the duplicates by using Virtual Agent Designer. For information about working with topic blocks and how to add them to calling topics, see [Maximizing code reuse with topic blocks](https://servicenow-prod.fluidtopics.net/LFM13XCCkrrHsi3iGAUp7Q "Topic blocks are reusable components that you can create to run common tasks and conversational elements in Virtual Agent conversations. Topic blocks simplify the topic authoring and maintenance process by enabling you to reuse standard procedures or actions across conversation topics.") and [Add a reusable topic block to a calling topic or topic block](https://servicenow-prod.fluidtopics.net/XNAcdGUqJH7Lvmk5NFqWSA "Add a reusable topic block to a calling (parent) topic or topic block to run a specific function or task in the calling topic. You specify input parameters used in the topic block, and you specify output parameters that are used by the calling topic.").
The following sections describe the input and output parameters for calling different types of platform topic blocks. The topic block input parameters are passed from the calling topic, and the output parameters are returned from the topic block to the calling topic.
Nota:
Upgrades to the default topic blocks are not applied to the duplicated topic blocks.
## Agent Availability topic block {#va-platform-topicblocks__section_sp4_c5h_rnb}
Use this topic block to get relevant live agent information for use in agent handoff conversations. This information includes agent availability, wait time (how long before an agent is available), and queue information. You can
use the information returned, such as a long wait time for an agent, to initiate a case or customer callback.
This topic block requires the Agent Chat (com.glide.interaction.awa) plugin, which includes Advanced Work Assignment.
The following table lists the output parameters for this topic block.
{#va-platform-topicblocks__table_owp_3hn_wnb__entry__2}
| Parameter | Description |
|-|-|
| agentAvailable | Agent availability. The value is true if an agent is available for this queue. Otherwise, the value is false. |
| supportQueue | sys_id of the queue that is associated with the conversation. The value is null if an agent is not available or if there is no associated queue. |
| waitingTime | Average numeric wait time for the queue. The value is null if an agent is not available. |
[Tabela 1. Agent Availability output parameters]
{#va-platform-topicblocks__table_owp_3hn_wnb}
## Deflection topic block {#va-platform-topicblocks__section_srk_1lb_lpb}
Use the deflection topic block in Virtual Agent conversation topics to track the issues that Virtual Agent helped to resolve or actually resolved for a user.
For example, the pre-built Auto Resolution Virtual Agent topic uses a deflection topic block to track deflections. For more information, see [Using the deflection topic block to track deflections in Virtual Agent](https://servicenow-prod.fluidtopics.net/eoPTo9wKB6VxKBYjHKQ9KQ "Use the pre-built deflection topic block in ServiceNow Virtual Agent to track the issues that Virtual Agent helped to resolve or actually resolved for a user. Incident deflection patterns and metrics can help you optimize and analyze the effectiveness of Virtual Agent.").
The following table lists the input parameters for this topic block.
{#va-platform-topicblocks__table_pzw_vlb_lpb__entry__2}
| Parameter | Description |
|-|-|
| Deflection Configuration | Group of deflection patterns. |
| Deflection Pattern | Deflection pattern in the deflection configuration that you have chosen. |
| Activity Table | Table where the deflection activity occurs. This table is associated with the primary activity table. For more information, see [Create deflection configurations and patterns](https://servicenow-prod.fluidtopics.net/zD21rb~Z8RkpPlIGpygpoQ "Set up deflection settings to create deflection configurations and deflection patterns that you can map to deflection topic blocks in Virtual Agent conversation topics. These deflections help you to track the issues that Virtual Agent helped to resolve or actually resolved for a user."). |
| Activity Ids | List of comma-separated activity system IDs. For example, incident ID or task ID. You can also add output from the AI Search or Contextual Search topic block to create a link between a deflection occurrence and the content that contributed to the same deflection. |
[Tabela 2. Deflection input parameters]
{#va-platform-topicblocks__table_pzw_vlb_lpb}
## FAQ Conversation Builder topic block {#va-platform-topicblocks__section_z21_rr3_rnb}
Use this topic block to build bot conversations that use your existing FAQ content. With this topic block, you can enable topic authors to build simple conversations by using existing [knowledge articles](https://www.servicenow.com/docs/access?context=knowledge-article-templates&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) that are published in the FAQ template or by
using Q\&A data that was imported from sources such as [spreadsheets](https://www.servicenow.com/docs/access?context=t_TranslateTheInterface&version=australia&pubname=australia-platform-administration§ion=t_ImportATranslationFromExcel&ft:locale=en-US).
The FAQ Conversation Builder topic block uses [contextual search](https://www.servicenow.com/docs/access?context=configuring-contextual-search&version=australia&pubname=australia-platform-administration&ft:locale=en-US) to find an appropriate match in the FAQ
content. FAQ content is access-controlled based on requester role, access rights, and context.
Activate the [Knowledge Management Advanced](https://www.servicenow.com/docs/access?context=activate-knowledge-advanced-plugin&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) plugin to use the FAQ
Knowledge template.
Nota:
The default length of an FAQ snippet that is returned in the conversation is 400 characters. The snippet length includes the HTML tags and links that are used in the snippet. To change the snippet length, change the value in the com.glide.cs.faq.display_size system property. In addition to applying the specified length, the system applies word-wrap logic to prevent words and links in the snippet from being truncated arbitrarily.
The following tables list the input and output parameters for this topic block.
{#va-platform-topicblocks__table_w2b_vpq_wnb__entry__2}
| Parameter | Description |
|-|-|
| query | Search term or phrase that is passed to the topic block. Select Input Variables or Script Variables. |
| portal | Context for the search. Select Input Variables or Script Variables. |
| kb_knowledge | Knowledge base for the search. Select Input Variables or Script Variables. |
[Tabela 3. FAQ Conversation Builder input parameters]
{#va-platform-topicblocks__table_w2b_vpq_wnb}
{#va-platform-topicblocks__table_pwq_5rq_wnb__entry__2}
| Parameter | Description |
|-|-|
| Results_Returned | Boolean value that indicates whether any results were returned from the query. |
| Results_Helpful | Boolean value that indicates whether the user found the results helpful. |
[Tabela 4. FAQ Conversation Builder output parameters]
{#va-platform-topicblocks__table_pwq_5rq_wnb}
## Form Content Popup topic block {#va-platform-topicblocks__section_wkv_gjv_cxb}
Use this topic block to open a form in a popup window from the chat widget. Once the user submits the required information, the record appears as a card in the Virtual Agent chat window. If a new record is created, the sys ID for that record is sent to the server so that the Virtual Agent topic has that information. For information about creating a pop-up window from a link, see [Create a smart link preference](https://servicenow-prod.fluidtopics.net/anLEsE2mpGw0kHMqZpY1Gg "Create smart links to specify where a URL should open. For example, the URL could open in a new browser window, in a new browser tab, in the chat window, or in a pop-up window.").
{#va-platform-topicblocks__table_qcj_5pv_cxb__entry__2}
| Parameter | Description |
|-|-|
| sysId | Sys ID of the record you want to display from the table specified in the table parameter. If you don't want a specific record, enter -1to create a new record. |
| table | Name of the table you want to query or create a record in. |
| view | Name of a view that you created for the table. If not specified, the default view is used. |
[Tabela 5. Form Content Popup topic block input parameters]
{#va-platform-topicblocks__table_qcj_5pv_cxb}
## Geolocation topic block {#va-platform-topicblocks__geolocation-topic-block-properties}
Use this topic block to retrieve information about the location of users, if the users agree to that. Before the topic block is called in a conversation, the users are asked if they want their location to be known. For example, the users see a prompt similar to the following:Figura 1. User permission prompt
Users can choose to block the request or allow their location to be known. If the users click Allow, they are later asked if they would like to share their location, as shown in the following example:Figura 2. Use of Geolocation in a chat
The following tables list the input and output parameters for this topic block.
{#va-platform-topicblocks__table_mtq_dsk_x4b__entry__2}
| Parameter | Description |
|-|-|
| permissionPrompt (String) | Text asking permission to use the user's location. This text is shown to the user. |
| isGeoPermissionGrantedForNextUse | Boolean value that determines if users have granted permission to retrieve their location coordinates if this request is asked more than once during the conversation. The variable can be set as follows: * True: Don't display permission prompt again because the user has granted permission on this device. * False: Display the permission prompt because the user has either denied permission or has allowed the coordinates to be retrieved one time only. {#va-platform-topicblocks__ul_gpc_nks_x4b} |
[Tabela 6. Geolocation input parameters]
{#va-platform-topicblocks__table_mtq_dsk_x4b}
{#va-platform-topicblocks__table_ycq_ksk_x4b__entry__2}
| Parameter | Description |
|-|-|
| Latitude | Latitude coordinates. |
| Longitude | Longitude coordinates. |
| errormessage | Message that is associated with the error if there are any errors. |
| errortype | Variable that is returned from the topic block. Types of errors include: * PERMISSION_DENIED * POSITION_UNAVAILABLE * TIMED_OUT * UNKNOWN_ERROR {#va-platform-topicblocks__ul_uxg_tms_x4b} |
| status | Variable that is returned from the topic block. The status can be: * OK: Location coordinates were retrieved successfully. * ERROR: Retrieval was unsuccessful. {#va-platform-topicblocks__ul_omx_cns_x4b} |
[Tabela 7. Geolocation output parameters]
{#va-platform-topicblocks__table_ycq_ksk_x4b}
## Pause topic block {#va-platform-topicblocks__section_byv_5th_dpb}
Use this topic block to create a pause to control the pacing of a conversation. To end users, this feedback is seamless and is displayed as a typing indicator.
For example, if the chat generated a list of knowledge base links, you may want to add a delay before continuing the conversation to give your end user time to read the information.
The Pause topic block appears on the Utilities section of the palette for easier access.
The following table lists the input parameter for this topic block.
{#va-platform-topicblocks__table_f5k_c5h_dpb__entry__2}
| Parameter | Description |
|-|-|
| Seconds | Number of seconds to wait before continuing the chat. The maximum value allowed is 60 seconds. If the value entered is 30 seconds (the default value) or less, the block should unpause in near real time. If the value entered is greater than 30 seconds, expect the unpause to occur with a maximum latency of +30 seconds. For example, if you set the value to 31 seconds, it could take up to 61 seconds to unpause (at most). |
[Tabela 8. Pause input parameter]
{#va-platform-topicblocks__table_f5k_c5h_dpb}
## Run AI Search topic block {#va-platform-topicblocks__section_vdm_ryb_dxb}
Nota:
If you're upgrading from Rome or a prior release, you must replace the legacy AI Search topic block with the Run AI Search topic block in order for it to work.
Use this topic block to generate AI Search results in a conversation. This block doesn't require specific input parameters from a calling topic because it is controlled by the AI Search application in Virtual Agent. The default Virtual Agent Search Application and EVAM configuration set in the [chat experience](https://servicenow-prod.fluidtopics.net/~wfDp8iiVJ6rI45SqC9VZQ "Create different chat experiences for your end users based on the context in which they initiate a conversation with Virtual Agent.") control how AI Search results are displayed in conversations.
For information about how Virtual Agent uses AI Search, see [Improving the user experience with AI Search](https://servicenow-prod.fluidtopics.net/xzvNLztEpkZwdMxdGQhkzg "Virtual Agent uses the ServiceNow AI Platform AI Search application to return search results in bot conversations as a fallback when there are no relevant topics to display to end users. Virtual Agent also provides a Run AI Search topic block that topic authors can use to generate search results in a topic."). To learn more about Virtual Agent chat experiences and how to configure them, see [Customizing a Virtual Agent chat experience](https://servicenow-prod.fluidtopics.net/~wfDp8iiVJ6rI45SqC9VZQ "Create different chat experiences for your end users based on the context in which they initiate a conversation with Virtual Agent.").
You can control certain aspects of the Run AI Search topic block:
* Optionally customize the AI Search experience - You can customize the search experience by creating a custom Search Application Configuration to be used by the topic block, rather than the default Virtual Agent Search Application Configuration. The Search Application Configuration defines the search results returned in the conversation. For details on using a custom Search Application
Configuration in the topic block, see [Create a custom AI Search experience for Virtual Agent conversations](https://servicenow-prod.fluidtopics.net/CME8fJ9AkktprEq~ZmSe~g "Define a custom AI Search experience in a conversation using the AI Search topic block. You create a Search Application Configuration used by the topic block to control the AI Search results returned in the conversation. Or you can use the Search Application Configuration to control AI Search results in a custom chat experience.").
To use the default Virtual Agent configuration for AI Search, leave the Search Application Configuration field empty in the Topic Block Properties sheet when you're adding the Run AI Search topic block to a topic.
* Specify an AI Search flow action timeout value - The AI Search flow action in the topic block automatically times out at 10 seconds. You can change the length of time before this flow action times out by [adding the system property](https://www.servicenow.com/docs/access?context=t_AddAPropertyUsingSysPropsList&version=australia&pubname=australia-platform-administration&ft:locale=en-US) com.glide.cs.fdih.atlassearch.timeout and setting these fields to change the timeout value: {#va-platform-topicblocks__table_xdm_ryb_dxb__entry__2}
| Field | Value |
|-|-|
| Name | Enter the system property name: com.glide.cs.fdih.atlassearch.timeout |
| Description | Enter an explanation for this property: AI Search action timeout (in seconds) |
| Type | Select integer. |
| Value | Enter the number of seconds before the AI Search action times out. The default value is 10 seconds. |
[Tabela 9. System property fields for com.glide.cs.fdih.atlassearch.timeout]
{#va-platform-topicblocks__table_xdm_ryb_dxb}
{#va-platform-topicblocks__ul_wdm_ryb_dxb}
The following tables list the input and output parameters for this topic block. For the output parameters, you have the option to deactivate any of the variables returned by the topic block.
{#va-platform-topicblocks__table_ydm_ryb_dxb__entry__2}
| Parameter | Description |
|-|-|
| search_term | Phrase entered by a user during the conversation. |
[Tabela 10. Run AI Search input parameters]
{#va-platform-topicblocks__table_ydm_ryb_dxb}
{#va-platform-topicblocks__table_zdm_ryb_dxb__entry__2}
| Parameter | Description |
|-|-|
| genius_results | Variable that identifies the Genius Results returned. |
| search_results | Variable that identifies the regular search results (multi-list output) returned. |
| search_metadata | Variable that identifies the search result metadata used for click metrics in Conversational Analytics, such as the search term used, query language, and more. |
[Tabela 11. Run AI Search output parameters]
{#va-platform-topicblocks__table_zdm_ryb_dxb}
## Runtime Language Detection topic block {#va-platform-topicblocks__section_hvr_wnw_dsb}
Use this topic block to detect the user's language during a conversation and switch to that language mid-conversation if the language is supported in the ServiceNow AI Platform.
For example, in conversations where guest users are interacting with the bot in a language different from the current conversation language, you can use this topic block to change the language accordingly. This topic block enables your bot to:
* Detect the language in conversations across all supported Virtual Agent channels.
* Determine if the language is supported in the ServiceNow AI Platform, and if so, ask the user whether to switch to the detected language.
* Switch to the detected language during the conversation if the user agrees to the switch.
{#va-platform-topicblocks__ul_lk5_c4w_dsb}
Activate the Virtual Agent Language Detection and Translation plugin \[com.glide.cs.runtime_language_detection_translation\] to use this topic block.
The following table lists the input parameters for this topic block.
{#va-platform-topicblocks__table_gbz_hpw_dsb__entry__2}
| Parameter | Description |
|-|-|
| utterance (String) | Text entered by the user. |
| Change language (Boolean) | Option that displays a message to the user that does the following: * Indicates the bot has detected that the user is typing in a different language. * Asks whether to continue the conversation in the supported language. If the user responds yes, the conversation changes to the supported language. {#va-platform-topicblocks__ul_uyk_5pw_dsb} |
[Tabela 12. Runtime Language Detection input parameters]
{#va-platform-topicblocks__table_gbz_hpw_dsb}