Guidelines

Intro

Suggested prompts provide several proposed options to facilitate conversational tasks. These are shown either at the start of a Joule conversation or immediately after an action has been completed. There are 2 types of suggested prompts: predictive responses and contextual next steps.

When to Use

Use the Suggested Prompts:

Alongside user inputs to guide interaction with AI interfaces.
To provide logical and distinct follow-up actions related to the user’s current context.
When a prompt is vague and requires clarification or narrowing down.

Don't

Don’t use Suggested Prompts if:

It is not required for the user to provide any input.
It is unrelated to the user’s prompt and context.
It would take longer to read and select the correct prompt than to simply type a new prompt.
The possibilities exceed 5 quick replies. Instead, ask user to elaborate or clarify in the input field.

Types

Predictive Response

If a user is entering text into an input field, a popover may be used to provide auto-fill suggestions based on the user's role, past conversation history, and most used actions.

Joule panel showing predictive text suggestions as a user types "How do I" in the message input, offering three autocomplete options: create a new story, view all my live data models, and upload a data set from a CSV

Predictive response after accessing Joule panel from SAP Analytics Cloud

Contextual Next Step

Contextual next steps are relevant pre-filled options shown after Joule completes a response or task. The user can select one of these options as their response to continue the conversation without having to type. Only the chosen option will appear in the conversation history once it is selected.

This document explains when quick replies should be used. For specific guidelines regarding the content, see Quick Reply.

Follow-up

Follow-up responses offer multiple different paths for the user to take. These options must not result in the same outcomes. If there is only one option for moving forward, simply do the action instead of presenting a single option. See Action, Confirmation, or Conversation Continuation in Quick Replies for guidance on content.

Do/Don't comparison showing Joule responses to "I want to check alerts for today." The Do example offers three relevant Quick Reply chips (Go to Alert, Resolve Alert, Tell Me More About Alerts); the Don't example shows only one vague chip (See Alert)

Do and Don’t examples of follow-up interactions for Joule Contextual Panel in HANA Cloud Central

Clarifying Responses

Clarifying responses provide options to narrow down the scope of the user’s initial query instead of overloading the user with information. If the number of options exceeds 5, consider asking a follow up question instead so the user can provide more context in their own words.

Clarifying responses may include categories to narrow down a large set of data or options confirm or deny an action. For more information about content for clarifying quick replies, see Quick Reply - Selection and Joule Guidelines for Disambiguation.

Do/Don't comparison showing Joule responses to "Show me available suppliers." The Do example offers four focused Quick Reply chips for browsing; the Don't example overwhelms the user with over a dozen chips covering every possible filter option