Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience

  • Release version: Yokohama
  • Updated January 30, 2025
  • 3 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience

    This guide explains how to optimize Virtual Agent settings and conversation topics using Virtual Agent Designer to deliver an enhanced voice chat experience on Alexa devices. Virtual Agent Designer enables you to create and manage conversational blueprints (topics) tailored for Alexa. Specifying Alexa as an applicable channel ensures your topics are compatible with voice interactions on Alexa.

    Show full answer Show less

    Configuring Bot Messages for Alexa

    Bot messages are critical for interacting with users via Alexa. You can customize greeting and other interaction messages specifically for voice channels:

    • Access bot messages through syscsproviderapplication.list and select your Alexa application profile.
    • Use the Custom Greeting and Setup page to create or edit custom topics and greetings for voice channels.
    • System-generated messages relevant to voice channels can be managed via sysproperties.list filtering on com.glide.cs. Key messages include topic picker, no topic found, linking account prompts, and topic confirmations.

    Most voice-channel-specific messages are centralized in the Provider Channel Identity record under Bot Messages.

    Compatibility and User Input Controls

    Virtual Agent components mostly support both screen-based and screen-less Alexa devices, though some limitations apply, especially for screen-less devices and the presentation of cards/images on screen-based devices due to Alexa skill kit constraints.

    The supported user input controls in Virtual Agent Designer for Alexa include:

    • Text input/output: Validated text entries (supported on all devices).
    • Static and Dynamic Choice: Selection from predefined or dynamic lists, with voice pagination on voice-only devices.
    • Boolean input: Yes/No style responses.
    • Date Time: Date and time selection (natural language understanding recommended).
    • Carousel and Card types: Supported with touch on screen devices and voice label reading on voice-only devices.
    • Video and Table: Video cards supported with limitations; tables are read aloud with prompts to proceed.

    Unsupported inputs on Alexa include file uploads and pause breaks.

    Customization and Contextual Actions

    To edit bot messages, navigate to syscsproviderapplication.list and adjust the Alexa > Bot Messages entries. You can add Boolean confirmation messages where needed.

    Conversational Integration with Alexa also supports contextual actions, enabling tailored responses based on user input mapping in custom chat integrations, further enhancing the conversational experience.

    Fine-tune your Virtual Agent settings and topics provided by the Virtual Agent Designer for the best voice chat experience with Alexa.

    • Virtual Agent Designer is a diagram tool for creating and managing topics, which are blueprints for conversation between a Virtual Agent and a user. For more information, see Getting started with Virtual Agent Designer.
      Note:
      Be sure that you specify Alexa as the applicable channel in the Additional channel support field if you want the topics that you designed using the Virtual Agent Designer to work on Alexa. For more information about the channel selection, see Deploying Virtual Agent topics in other channels.
    • Bot messages help you to interact with Alexa. You can change the bot messages for interaction in a voice chat conversation. To access the bot messages, enter sys_cs_provider_application.list in the navigation filter and navigate to your Alexa application profile to find the bot messages.
      Figure 1. Bot messages for Alexa
      Provider Channel Identity settings window for Alexa, next to Alexa Provider Channel Identity window with Bot Messages highlighted.
    • You can change the greeting message and other messages only for the voice channels using the Custom Greeting and Setup page. For example, you can create a custom topic, edit it, and assign it to be used if the end user is on a voice channel. For more information about accessing the Custom Chat and to change the greeting section of the message, see Configure a Virtual Agent chat experience.

    • You can also change the system-generated messages by entering sys_properties.list in the navigation filter, and filter them by the criteria com.glide.cs to confirm that these messages work for voice channels. You can review the following key messages:
      • com.glide.cs.topic_picker_msg
      • com.glide.cs.no_topic_found_message
      • com.glide.cs.no_topic_sorry_message
      • com.glide.cs.link_account_msg
      • com.glide.cs.topic_choice_list_message
      • com.glide.cs.topic_confirmation_message
      Note:
      Most of the messages unique to the voice channels are listed in the Bot Messages section of the Provider Channel Identity record.
      For more information, see Change the Virtual Agent greeting messages in the Greeting setup topic.
    • Most components work for screen-based and screen-less devices accessed in Alexa. However, some components are not compatible especially for the screen-less devices.

      Note:
      On the screen-based Alexa enabled devices, the presentation of cards and images has limitations as per the Alexa skill kit specification.

      The Conversational Integration with Alexa application supports the following user input controls in Virtual Agent Designer.

      Note:
      Conversational Integration with Alexa also supports touch input for screen-based devices.
      Table 1. User input controls
      User input control Description Screen No screen
      Text input/output Text format that is validated when a user enters certain text items. Yes. Yes.
      Static Choice User selects an item from a predefined list. Yes, touch scroll. Yes, voice pagination.
      Dynamic Choice User selects a choice from the list of dynamically created choices. Yes, no clicking links. Yes, voice pagination.
      Boolean User enters a Boolean response to the bot. For example, the user can reply Yes or No in a chat conversation. Yes. Yes.
      Date Time User selects a calendar date, time (hours and minutes), or both. Yes (NLU recommended at the node). Yes (NLU recommended at the node).
      File Picker User sends a file to the bot. No. No.
      Pause Breaks the conversation with Alexa. No. No.
      Carousel User selects a single item from the carousel. Yes, touch scroll. Yes, reading labels.
      Image/Link/HTML output Bot sends an image, a link, or an HTML to the user. Yes, no clicking links. error_msg
      Video User can choose a video card from the header card. video_screen_device_msg video_audio_device_msg
      Card Type of header card. Choose the contents:
      • Large image with text
      • Small image with text
      • YouTube Video Card
      The fields in the dialog box change based on your choice.
      Yes, no clicking. Yes, reading labels.
      Table If you selected Record as the Reference Type, select the table to be searched. Yes

      Shows the table headers, followed by rows with column header: value pair, Speak (Table header). Please say Done to continue.

      No, reading labels

      Unfortunately, I cannot show you the content on this device. Please say Done to continue.

      Note:
      To edit or change any of the following bot messages, enter sys_cs_provider_application.list in the navigation filter of your ServiceNow instance, select Alexa > Bot Messages, and click the name of the bot message that you want to edit.
      • error_msg
      • video_screen_device_msg
      • video_audio_device_msg
      • table_msg
      If you find the message name <EMPTY> and want to add a Boolean confirmation message to the end users, you can configure the bot message with the value [0] or [1].
    • Conversational Integration with Alexa supports contextual actions that serve an appropriate response from custom chat integrations when user input is mapped to them. For more information, see Contextual actions for Alexa.