Query Patterns

A query pattern defines an example phrase a user might say. The Assistant Platform can match user spoken phrases that are semantically similar using natural language processing.

Query patterns can contain a literal string, conditionals, and arguments using Schema.org types.

Literal string

A query pattern can contain a literal string.

Example: "Start the guess the number game."


Portions of a query pattern can be considered optional. To indicate conditional query patterns, wrap the portion of the phrase in parenthesis and end it with a question mark. The following example defines Start the as optional:

Example: "(Start the)? Guess the number game"


A query pattern can collect a portion of the user’s input through the use of named arguments (this can also be considered variables). Arguments are specified using the syntax: $Type:argument_name.

Example: "$SchemaOrg_number:number" describes a query pattern that expects an input of a Schema.org number, and that the actual number the user says will be captured in an argument named “number”.

Schema.org types

Following is the list of supported Schema.org types used for query patterns:

Type Example Query Pattern Example User Query
$SchemaOrg_Date read my sms from $SchemaOrg_Date:my_date on sms pro read my sms from april 1st on sms pro
$SchemaOrg_Number blink the flashlight $SchemaOrg_Number:number times blink the flashlight five times
$SchemaOrg_Time read my sms from $SchemaOrg_Time:my_time on sms pro read my sms from 5 pm on sms pro
$SchemaOrg_DayOfWeek show me my meetings on$SchemaOrg_DayOfWeek:day_of_week show me my meetings on Tuesday
$SchemaOrg_Color turn on the $SchemaOrg_Color:my_color strobe light turn on the red strobe light
$SchemaOrg_priceCurrency show conversion rate for $SchemaOrg_priceCurrency:cur on currency app show conversion rate for yen on currency app
$SchemaOrg_Distance show conversion chart for $SchemaOrg_Distance:dist show conversion chart for kilometer
$SchemaOrg_Temperature set temperature to $SchemaOrg_Number:num degrees$SchemaOrg_Temperature:temp set temperature to 70 degrees fahrenheit
$SchemaOrg_Organization watch $SchemaOrg_Organization:organization highlights watch lakers highlights
show me stock price for$SchemaOrg_Organization:organization show me stock price for Google
$SchemaOrg_Person show top 10 $SchemaOrg_Person:musician songs show top 10 bruno mars songs
show me news about $SchemaOrg_Person:person show me news about bill gates
$SchemaOrg_Place write review for $SchemaOrg_Place:place write review for new york
show traffic on $SchemaOrg_Place:location show traffic on mountain view
$SchemaOrg_Product write review for $SchemaOrg_Product:product write review for google glass
$SchemaOrg_Book read $SchemaOrg_Book:my_book read great expectations
$SchemaOrg_Movie play the $SchemaOrg_Movie:my_movie movie review the casablanca movie
$SchemaOrg_TVSeries play next episode of $SchemaOrg_TVSeries:tv_series play next episode of friends
$SchemaOrg_servesCuisine show $SchemaOrg_servesCuisine:my_cuisine restaurants show italian restaurants
$SchemaOrg_MusicAlbum add $SchemaOrg_MusicAlbum:album to my queue. add abbey road to my queue
$SchemaOrg_MusicRecording add $SchemaOrg_MusicRecording:song to my favorites. add with or without you to my favorites.
$SchemaOrg_YesNo $SchemaOrg_YesNo Yes
$SchemaOrg_URL Add $SchemaOrg_URL Add google.com
$SchemaOrg_Email Add $SchemaOrg_Email Add john@google.com
$SchemaOrg_PhoneNumber Add $SchemaOrg_PhoneNumber Add (777) 777-7777
$SchemaOrg_Text What's that song where they say $SchemaOrg_Text What's that song where they say you are my sunshine?

Custom types

Custom types allow you to define your own types, which are a collection of items, the possible ways that user might say an item (synonyms), and the corresponding argument value (key). This lets you define custom

The following example defines a custom type for the different ways a person might say "6am".

"customTypes": [
      "name": "$MorningOptions",
      "items": [
          "key": "6am",
          "synonyms": [
            "6 am",
            "6 o clock",
            "oh six hundred",
            "6 in the morning"