Intro
AI acknowledgment message box on new SAP CX AI toolkit capabilities
When to Use
Use the AI acknowledgment pattern to:
- Inform the user about a present AI service or function.
- Educate the user on important properties of the AI system.
Don’t use the AI acknowledgment pattern to:
- Notify the user about failed or successful AI processes.
- Send marketing or advertisement information about the AI service.
- Display any other system-related information.
High-stakes situations
AI acknowledgment is highly recommended in situations where educated user decisions on AI-created results are critical. In other words, the risks associated with such an action are usually high.
Examples of high-stake scenarios include:
- Financial forecasting
- Contract recommendations
- Human resources insights
- Customer communications
Low-stakes situations
AI acknowledgment may be optionally used in situations where the risks associated with applied actions are usually low and can be easily reverted at any time. Other patterns, such as AI explainability and AI notice, may already provide enough visual cues to inform the user of possible AI involvement in the provided content.
Examples of low-stake scenarios include:
- Entertainment
- Recipe/lifestyle suggestions
- Generic communication responses and greetings
Anatomy
The AI acknowledgment pattern extends the dialog (message box) component to enable new AI-specific interactions.
Structure of the AI acknowledgment message
- Container: Dialog component (message box type).
- Intro/primary message: Describe what the message is about. Tailor it to the given context.
- Details/link: Link to relevant documentation defined by the product.
- Title: Disclaimer headline.
- Disclaimer text: Standard AI notice message text.
- Checkbox (optional): Don’t show me again.
Types
The AI acknowledgment provides a standard message text. We advise adhering to the suggested wording to maintain consistency and ensure user familiarity. Modify the text only if necessary[internal_only] and make sure it’s aligned with your user assistance colleagues [/internal_only].
Recommended message text
Purpose
Message Text
Onboarding/welcome message
Show this message when a user opens an AI-enabled application for the first time.
<Application> now provides embedded AI services. For more information, see <link>.
Disclaimer
Artificial Intelligence (AI) generates results based on multiple sources. Outputs may contain errors and inaccuracies. Consider reviewing all generated results and adjust as necessary.
☑ Don’t show me again
Footer actions
Footer actions should align with the purpose of the message.
Informational only (no action required):
Message with Close (tertiary) button.
Informational only
Informational with Don’t show me again option:
Message with OK (primary) button and a checkbox to hide future messages.
Informational with “Don’t show me again” option
Acknowledgment required with Don’t show me again option:
Message with Accept (primary) and Dismiss (tertiary) buttons, with a checkbox to hide future messages.
Acknowledgment required with “Don’t show me again” option
Behavior and Interaction
Trigger and events
The AI acknowledgment dialog is displayed when the user opens a screen that provides AI-enabled features.
“Don’t show me again” option
You can provide a Don’t show me again option in the acknowledgment popover to avoid the repetition of identical messages. If this option is activated, the message is no longer displayed in future sessions in the same application locally, or for the same AI service globally. It does not prevent other messages from showing up.
We recommend providing a dedicated location where users can retrieve this information again at any time.
[internal_only]
Proposed locations:
- SAP Help Portal
- My Home Settings (User Profile)
[/internal_only]
Checkbox with “Don’t show me again” label
When to show again
The message box can be displayed again if the status or properties of the AI service have changed significantly, even if the user has selected Don’t show me again. We recommend displaying the AI acknowledgment again when:
- An application that previously had no AI features is now enhanced with AI capabilities.
- An application with existing AI features has been upgraded with a new AI capability.
Responsive Behavior
The AI acknowledgment builds on the foundation of the message box. To learn more about the responsive behavior of the AI acknowledgment, refer to the dialog (message box) guidance.
Localization
To learn more about the support for left-to-right (LTR) and right-to-left (RTL) languages in the AI acknowledgment, refer to the dialog (message box) guidance.
Responsible AI
[internal_only]Provide easy access to information
Clearly indicate links within the AI acknowledgment so that users can access and review the product documentation (SAP Help Portal) and relevant AI information like Data Privacy Statements and AI Terms. For more information, refer to the guidance for links. [/internal_only]
Communicate clearly
Use clear, simple language to ensure users understand the meaning of the message and linked information. Avoid technical jargon or legal language that may confuse users.
Related Links
Guidelines
Implementation
- AI Acknowledgment (UI5 Web Components documentation)
Guidelines
Implementation
- AI Acknowledgment (UI5 Web Components documentation)