CUI design

Usage

DatePicker component allows users to input or select a date using natural language in conversational interactions. It can recognize various ways of describing a date, such as the day of the week, day of the month, and date of the year, and will interact with the user to finalize a specific date. It is suitable for the context in which it appears.

Common use cases include:

• Making a restaurant reservation.
• Scheduling a meeting.

Common interaction logics include:

• Ask for a date.
• Provide date options and help to shrink candidate dates.
• Pass business logic verification.
• Inform or double check with end-user the date value.

Schema representation

When the bot is making value recommendations, the auxiliary slots below can help the user to finalize a specific date through interaction.

Main slot

Slot Label	Type	Description	Expression Input
date	java.time.LocalDate	Always ask. Matches a certain calendar date.	"today", "this monday", "the 14th of February", "April 14, 2023", "2023-01-18", "the last Tuesday of October 2022"

Auxiliary slots

Slot Label	Type	Description	Expression Input
dayOfWeek	java.time.DayOfWeek	The 7 days of the week, from 1 (Monday) to 7 (Sunday).	"monday"
month	java.time.Month	Month of a year, from 1 (January) to 12 (December).	"January"
monthDay	java.time.MonthDay	A month-day in the ISO-8601 calendar system, the combination of a month and day-of-month.	"15th February", "15 of February", "the 15th of February"
year	java.time.Year	A year in the ISO-8601 calendar system.	2023
yearMonth	java.time.YearMonth	A year-month in the ISO-8601 calendar system, the combination of a year and month.	"October 2023"
period	java.time.Period	The quantity or amount of time in terms of years, months and days.	"4 days", "coming week", "next month", "this quarter"

Contextual snippet

1. Happy path

Snippet 1	Happy Path
Description	Defines what happens if everything goes well.
Precondition	complete = false
Annotated Conversation	🤖 : Which date would you like？   - 2023-01-19   - 2023-01-20   - 2023-01-21 😊 : Jan 19. 🤖 : Get, your date is 2023-01-19.
End State	date = 2023-01-19 complete = true

2. Date value can NOT pass verification

Snippet 2	Date Value Can NOT Pass Verification
Description	After the user specifies a date, the date does not pass validation. Bot prompts the verification failure message and asks the user again.
Precondition	complete = false
Annotated Conversation	😊 : Jan 19. 🤖 : The date is not available. Which date would you like?   - 2023-01-20   - 2023-01-21   - 2023-01-22
End State	complete = false

3. User provides partial inform

Snippet 3	User Provides Partial Inform
Description	After the bot provides candidates, the user proposes some conditions to narrow down the available options.
Precondition	complete = false
Annotated Conversation	🤖 : Which date would you like？   - 2023-01-19   - 2023-01-20   - 2023-01-21 😊 : mon or tues. 🤖 : Here are some optins for you:   - 2023-01-23   - 2023-01-24   - 2023-01-30   - 2023-01-31
End State	complete = false

4. User change mind

Snippet 4	User Change Mind
Description	After the date determined by the user, the user changes his mind.
Precondition	date = 2023-01-19 complete = true
Annotated Conversation	😊 : Wait, I think Jan 30 is better. 🤖 : Get, your date is changed to 2023-01-30.
End State	date = 2023-01-30 complete = true