VideoCreativeWork Intents
Introduction
A creative work that includes video and possibly audio, such as movies, television shows, and video clips. These intents let users request actions related to video works, such as adding videos to a library or watchlist, controlling playback of videos, and looking up information about video works.
This document provides a quick reference to the VideoCreativeWork
intents and corresponding slots. For details around how these intents are specified, see Understanding the Structure of the Built-in Intent Library.
Intent Signature
Use the intent signature as the intent
name in your intent schema. This example shows a schema with two VideoCreativeWork
intents:
{
"intents": [
{
"name": "AMAZON.ResumeAction<object@VideoCreativeWork>"
},
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[description]>"
}
]
}
For more about the components of this signature, see Understanding the Structure of the Built-in Intent Library.
To see the full JSON format for intents, see Interaction Model Schema. You can also use the developer console user interface to add the intents and then see the JSON code in the JSON Editor.
VideoCreativeWork
intents can be used in English (US) skills. They are not available for English (UK) or German skills.VideoCreativeWork Intents
The following table summarizes the available VideoCreativeWork
intents and the set of slots that may be included. For each intent, the sections below the table show:
- A sample utterance that would invoke the intent.
- The JSON you include in your intent schema if you want to use the intent.
-
An example of the
IntentRequest
sent to your skill for the provided sample utterance, illustrating the slots that may be included. For brevity, these samples leave out the full set of properties that are normally part of a completeIntentRequest
.Note that if your interaction model includes multiple intents with similar utterances, your results may vary from these examples.
For definitions of the slots used in these intents, see VideoCreativeWork Slots.
Intent Signature | Example Utterance | Possible Slots |
---|---|---|
AMAZON.ChooseAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist> |
"pick the second movie on this list" | sourceCollection sourceCollection.type object.name object.select |
AMAZON.ChooseAction<object@VideoCreativeWork> |
"i want to choose the third movie" | object.character.name object.type object.select object.genre object.byArtist.name |
AMAZON.CloseAction<object@VideoCreativeWork> |
"close my videos" | object.owner.name object.type |
AMAZON.DislikeAction<object@VideoCreativeWork> |
"i hate the movie interstellar" | object.type object.name |
AMAZON.LikeAction<object@VideoCreativeWork> |
"like the movie frozen" | object.type object.name |
AMAZON.PlaybackAction<object@VideoCreativeWork> |
"play the final lord of the rings movie" | object.partOfSeries.name object.type object.name object.select |
AMAZON.RateAction<object@VideoCreativeWork> |
"rate the previous movie three stars" | rating.ratingValueUnit object.select object.type object.name rating.ratingValue rating.bestRating |
AMAZON.RestartAction<object@VideoCreativeWork> |
"restart this movie" | object.type object.select |
AMAZON.ResumeAction<object@VideoCreativeWork> |
"continue playing this movie" | object.owner.name object.type object.name |
AMAZON.SearchAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist> |
"search for star trek movies on my favorites list" | object.type object.name sourceCollection.owner.name sourceCollection.name |
AMAZON.SearchAction<object@VideoCreativeWork> |
"find funny monty python clips" | object.name object.startDate object.character.name object.partOfSeries.name object.actor.name object.actor.gender object.contentSource object.type object.personAssociatedWith.name object.contentRating.type object.about.type object.recordedAt.type object.owner.name object.inLanguage.type object.genre object.sentiment.type object.about.name object.director.name object.sort object.audience.type object.aggregatePopularity object.select object.partOfSeries.select object.actor.type sourceCollection.contentSource |
AMAZON.SearchAction<object@VideoCreativeWork[actor]> |
"who is in the movie spectre" | object.type object.name object.actor.type |
AMAZON.SearchAction<object@VideoCreativeWork[audience]> |
"what is the suggested audience for the movie the wedding planner" | object.type object.audience.type object.name |
AMAZON.SearchAction<object@VideoCreativeWork[contentRating]> |
"what is the martian rated" | object.name |
AMAZON.SearchAction<object@VideoCreativeWork[dateReleased]> |
"when did the force awakens come out" | object.name |
AMAZON.SearchAction<object@VideoCreativeWork[description]> |
"show me information about lost in translation" | object.name object.description.type |
AMAZON.SearchAction<object@VideoCreativeWork[director]> |
"who directed the movie titanic" | object.type object.name |
AMAZON.SearchAction<object@VideoCreativeWork[genre]> |
"what is the genre of this movie" | object.genre.type object.type |
AMAZON.SearchAction<object@VideoCreativeWork[musicBy]> |
"who sings the song in titanic" | object.contains.type object.name |
AMAZON.SearchAction<object@VideoCreativeWork[name]> |
"what show is this" | object.type |
AMAZON.StopAction<object@VideoCreativeWork> |
"cancel playing the movie" | object.quantity object.type |
AMAZON.SuspendAction<object@VideoCreativeWork> |
"pause this movie" | object.type duration.name |
AMAZON.WatchAction<object@VideoCreativeWork> |
"watch the previous movie in this series" | object.partOfSeries.type object.type object.select |
ChooseAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist>
User: pick the second movie on this list
Intent Schema:
{
"intents": [
{
"name": "AMAZON.ChooseAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.ChooseAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist>",
"slots": {
"object.select": {
"name": "object.select",
"value": "second"
},
"sourceCollection": {
"name": "sourceCollection",
"value": "list"
}
}
}
}
}
ChooseAction<object@VideoCreativeWork>
User: i want to choose the third movie
Intent Schema:
{
"intents": [
{
"name": "AMAZON.ChooseAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.ChooseAction<object@VideoCreativeWork>",
"slots": {
"object.select": {
"name": "object.select",
"value": "third"
},
"object.type": {
"name": "object.type",
"value": "movie"
}
}
}
}
}
CloseAction<object@VideoCreativeWork>
User: close my videos
Intent Schema:
{
"intents": [
{
"name": "AMAZON.CloseAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.CloseAction<object@VideoCreativeWork>",
"slots": {
"object.owner.name": {
"name": "object.owner.name",
"value": "my"
},
"object.type": {
"name": "object.type",
"value": "videos"
}
}
}
}
}
DislikeAction<object@VideoCreativeWork>
User: i hate the movie interstellar
Intent Schema:
{
"intents": [
{
"name": "AMAZON.DislikeAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.DislikeAction<object@VideoCreativeWork>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
},
"object.name": {
"name": "object.name",
"value": "interstellar"
}
}
}
}
}
LikeAction<object@VideoCreativeWork>
User: like the movie frozen
Intent Schema:
{
"intents": [
{
"name": "AMAZON.LikeAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.LikeAction<object@VideoCreativeWork>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
},
"object.name": {
"name": "object.name",
"value": "frozen"
}
}
}
}
}
PlaybackAction<object@VideoCreativeWork>
User: play the final lord of the rings movie
Intent Schema:
{
"intents": [
{
"name": "AMAZON.PlaybackAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.PlaybackAction<object@VideoCreativeWork>",
"slots": {
"object.select": {
"name": "object.select",
"value": "final"
},
"object.partOfSeries.name": {
"name": "object.partOfSeries.name",
"value": "lord of the rings"
},
"object.type": {
"name": "object.type",
"value": "movie"
}
}
}
}
}
RateAction<object@VideoCreativeWork>
User: rate the previous movie three stars
Intent Schema:
{
"intents": [
{
"name": "AMAZON.RateAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.RateAction<object@VideoCreativeWork>",
"slots": {
"object.select": {
"name": "object.select",
"value": "previous"
},
"object.type": {
"name": "object.type",
"value": "movie"
},
"rating.ratingValue": {
"name": "rating.ratingValue",
"value": "3"
},
"rating.ratingValueUnit": {
"name": "rating.ratingValueUnit",
"value": "stars"
}
}
}
}
}
RestartAction<object@VideoCreativeWork>
User: restart this movie
Intent Schema:
{
"intents": [
{
"name": "AMAZON.RestartAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.RestartAction<object@VideoCreativeWork>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
}
}
}
}
}
ResumeAction<object@VideoCreativeWork>
User: continue playing this movie
Intent Schema:
{
"intents": [
{
"name": "AMAZON.ResumeAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.ResumeAction<object@VideoCreativeWork>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
}
}
}
}
}
SearchAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist>
User: search for star trek movies on my favorites list
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork,sourceCollection@VideoPlaylist>",
"slots": {
"object.name": {
"name": "object.name",
"value": "star trek"
},
"object.type": {
"name": "object.type",
"value": "movies"
},
"sourceCollection.owner.name": {
"name": "sourceCollection.owner.name",
"value": "my"
},
"sourceCollection.name": {
"name": "sourceCollection.name",
"value": "favorites list"
}
}
}
}
}
SearchAction<object@VideoCreativeWork>
User: find funny monty python clips
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork>",
"slots": {
"object.sentiment.type": {
"name": "object.sentiment.type",
"value": "funny"
},
"object.partOfSeries.name": {
"name": "object.partOfSeries.name",
"value": "monty python"
},
"object.type": {
"name": "object.type",
"value": "clips"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[actor]>
User: who is in the movie spectre
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[actor]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[actor]>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
},
"object.name": {
"name": "object.name",
"value": "spectre"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[audience]>
User: what is the suggested audience for the movie the wedding planner
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[audience]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[audience]>",
"slots": {
"object.audience.type": {
"name": "object.audience.type",
"value": "audience"
},
"object.type": {
"name": "object.type",
"value": "movie"
},
"object.name": {
"name": "object.name",
"value": "the wedding planner"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[contentRating]>
User: what is the martian rated
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[contentRating]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[contentRating]>",
"slots": {
"object.name": {
"name": "object.name",
"value": "the martian"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[dateReleased]>
User: when did the force awakens come out
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[dateReleased]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[dateReleased]>",
"slots": {
"object.name": {
"name": "object.name",
"value": "the force awakens"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[description]>
User: show me information about lost in translation
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[description]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[description]>",
"slots": {
"object.description.type": {
"name": "object.description.type",
"value": "information"
},
"object.name": {
"name": "object.name",
"value": "lost in translation"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[director]>
User: who directed the movie titanic
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[director]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[director]>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
},
"object.name": {
"name": "object.name",
"value": "titanic"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[genre]>
User: what is the genre of this movie
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[genre]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[genre]>",
"slots": {
"object.genre.type": {
"name": "object.genre.type",
"value": "genre"
},
"object.type": {
"name": "object.type",
"value": "movie"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[musicBy]>
User: who sings the song in titanic
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[musicBy]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[musicBy]>",
"slots": {
"object.contains.type": {
"name": "object.contains.type",
"value": "song"
},
"object.name": {
"name": "object.name",
"value": "titanic"
}
}
}
}
}
SearchAction<object@VideoCreativeWork[name]>
User: what show is this
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SearchAction<object@VideoCreativeWork[name]>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SearchAction<object@VideoCreativeWork[name]>",
"slots": {
"object.type": {
"name": "object.type",
"value": "show"
}
}
}
}
}
StopAction<object@VideoCreativeWork>
User: cancel playing the movie
Intent Schema:
{
"intents": [
{
"name": "AMAZON.StopAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.StopAction<object@VideoCreativeWork>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
}
}
}
}
}
SuspendAction<object@VideoCreativeWork>
User: pause this movie
Intent Schema:
{
"intents": [
{
"name": "AMAZON.SuspendAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.SuspendAction<object@VideoCreativeWork>",
"slots": {
"object.type": {
"name": "object.type",
"value": "movie"
}
}
}
}
}
WatchAction<object@VideoCreativeWork>
User: watch the previous movie in this series
Intent Schema:
{
"intents": [
{
"name": "AMAZON.WatchAction<object@VideoCreativeWork>"
}
]
}
Request:
{
"request": {
"type": "IntentRequest",
"locale": "en-US",
"intent": {
"name": "AMAZON.WatchAction<object@VideoCreativeWork>",
"slots": {
"object.select": {
"name": "object.select",
"value": "previous"
},
"object.type": {
"name": "object.type",
"value": "movie"
},
"object.partOfSeries.type": {
"name": "object.partOfSeries.type",
"value": "series"
}
}
}
}
}
VideoCreativeWork Slots
The VideoCreativeWork
intents can return slot values to your skill. You do not include these slots in your intent schema – they are generated automatically from the intent signature.
Note that not all available slots are returned from every intent. See the table in VideoCreativeWork Intents to see which slots are applicable to each intent.
The following table shows the slots the VideoCreativeWork
intents can return. For each slot, the table includes:
- The slot name.
- An example utterance for the slot.
- The JSON that would be sent to your skill for the sample utterance.
- If applicable, the name of the slot type used by the slot. You can see details about slot types in the Slot Type Reference.
Slot Name | Utterance | Slot Values |
---|---|---|
|
"… for one hour" |
|
|
"… about justin bieber" |
|
|
"…search for animal" |
|
|
"… with a female" |
|
|
"… featuring rachel mcadams" |
|
|
"… by monty python" |
|
|
"…who is the actress" |
|
|
"… protagonist" |
|
|
"…what's the best" |
|
|
"…what is the suggested audience" |
|
|
"… by red hot chili peppers" |
|
|
"… with batman" |
|
|
"…who sings the song" |
|
|
"…find p. g. thirteen" |
|
|
"… on audible" |
|
|
"…give me a recap" |
|
|
"…search for spielberg" |
|
|
"…what is the genre" |
|
|
"…search for romance" |
|
|
"… in french" |
|
|
"…stop playing the videos" |
|
|
"…when is my" |
|
|
"… monty python" |
|
|
"… star trek" |
|
|
"… star wars" |
|
|
"…look up the second" |
|
|
"… in this series" |
|
|
"…search for clint eastwood" |
|
|
"… of the drake" |
|
|
"…turn off everything" |
|
|
"… concert" |
|
|
"… next" |
|
|
"…find funny" |
|
|
"… i just added" |
|
|
"…what's on may first" |
|
|
"… movie" |
|
|
"… out of five" |
|
|
"… three" |
|
|
"… stars" |
|
|
"… audible" |
|
|
"… favorites list" |
|
|
"…take my" |
|
|
"… from the shows i watch" |
|
|
"… movie on this list" |
|
Built-in Intent Library Documentation
VideoCreativeWork
is used in the following built-in intent library category:
Navigate to all built-in intents in the Built-in Intent Library.
See all available slot types in the Slot Type Reference.
Learn more about using the built-in intent library:
- Understanding the Structure of the Built-in Intent Library
- Implementing the Built-in Intents
- Standard Built-in Intents
Learn more about building your voice interface:
- Choose the Invocation Name for a Custom Skill
- Create the Interaction Model for Your Skill
- Best Practices for Sample Utterances and Custom Slot Type Values
- Interaction Model Schema
- Alexa Design Guide
The built-in intent library incorporates material from Schema.org, which is licensed under the Creative Commons Attribution-ShareAlike License (version 3.0) (the "License"). You may not use this file except in compliance with the License. You may obtain a copy of the License at http://creativecommons.org/licenses/by-sa/3.0/. For questions, please contact us.
Last updated: Nov 28, 2023