- Resource: Intent
- JSON representation
- WebhookState
- TrainingPhrase
- Type
- Part
- Parameter
- Message
- Text
- Image
- QuickReplies
- Card
- Button
- SimpleResponses
- SimpleResponse
- BasicCard
- Button
- OpenUriAction
- Suggestions
- Suggestion
- LinkOutSuggestion
- ListSelect
- Item
- SelectItemInfo
- CarouselSelect
- Item
- BrowseCarouselCard
- BrowseCarouselCardItem
- OpenUrlAction
- UrlTypeHint
- ImageDisplayOptions
- TableCard
- ColumnProperties
- HorizontalAlignment
- TableCardRow
- TableCardCell
- MediaContent
- ResponseMediaType
- ResponseMediaObject
- Platform
- FollowupIntentInfo
- Methods
Resource: Intent
An intent categorizes an end-user's intention for one conversation turn. For each agent, you define many intents, where your combined intents can handle a complete conversation. When an end-user writes or says something, referred to as an end-user expression or end-user input, Dialogflow matches the end-user input to the best intent in your agent. Matching an intent is also known as intent classification.
For more information, see the intent guide.
JSON representation |
---|
{ "name": string, "displayName": string, "webhookState": enum ( |
Fields | |
---|---|
name |
Optional. The unique identifier of this intent. Required for |
display |
Required. The name of this intent. |
webhook |
Optional. Indicates whether webhooks are enabled for the intent. |
priority |
Optional. The priority of this intent. Higher numbers represent higher priorities.
|
is |
Optional. Indicates whether this is a fallback intent. |
ml |
Optional. Indicates whether Machine Learning is disabled for the intent. Note: If |
live |
Optional. Indicates that a live agent should be brought in to handle the interaction with the user. In most cases, when you set this flag to true, you would also want to set endInteraction to true as well. Default is false. |
end |
Optional. Indicates that this intent ends an interaction. Some integrations (e.g., Actions on Google or Dialogflow phone gateway) use this information to close interaction with an end user. Default is false. |
input |
Optional. The list of context names required for this intent to be triggered. Format: |
events[] |
Optional. The collection of event names that trigger the intent. If the collection of input contexts is not empty, all of the contexts must be present in the active user session for an event to trigger this intent. Event names are limited to 150 characters. |
training |
Optional. The collection of examples that the agent is trained on. |
action |
Optional. The name of the action associated with the intent. Note: The action name must not contain whitespaces. |
output |
Optional. The collection of contexts that are activated when the intent is matched. Context messages in this collection should not set the parameters field. Setting the |
reset |
Optional. Indicates whether to delete all contexts in the current session when this intent is matched. |
parameters[] |
Optional. The collection of parameters associated with the intent. |
messages[] |
Optional. The collection of rich messages corresponding to the |
default |
Optional. The list of platforms for which the first responses will be copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform). |
root |
Output only. Read-only. The unique identifier of the root intent in the chain of followup intents. It identifies the correct followup intents chain for this intent. We populate this field only in the output. Format: |
parent |
Read-only after creation. The unique identifier of the parent intent in the chain of followup intents. You can set this field when creating an intent, for example with It identifies the parent followup intent. Format: |
followup |
Output only. Read-only. Information about all followup intents that have this intent as a direct or indirect parent. We populate this field only in the output. |
WebhookState
Represents the different states that webhooks can be in.
Enums | |
---|---|
WEBHOOK_STATE_UNSPECIFIED |
Webhook is disabled in the agent and in the intent. |
WEBHOOK_STATE_ENABLED |
Webhook is enabled in the agent and in the intent. |
WEBHOOK_STATE_ENABLED_FOR_SLOT_FILLING |
Webhook is enabled in the agent and in the intent. Also, each slot filling prompt is forwarded to the webhook. |
TrainingPhrase
Represents an example that the agent is trained on.
JSON representation |
---|
{ "name": string, "type": enum ( |
Fields | |
---|---|
name |
Output only. The unique identifier of this training phrase. |
type |
Required. The type of the training phrase. |
parts[] |
Required. The ordered list of training phrase parts. The parts are concatenated in order to form the training phrase. Note: The API does not automatically annotate training phrases like the Dialogflow Console does. Note: Do not forget to include whitespace at part boundaries, so the training phrase is well formatted when the parts are concatenated. If the training phrase does not need to be annotated with parameters, you just need a single part with only the If you want to annotate the training phrase, you must create multiple parts, where the fields of each part are populated in one of two ways:
|
times |
Optional. Indicates how many times this example was added to the intent. Each time a developer adds an existing sample by editing an intent or training, this counter is increased. |
Type
Represents different types of training phrases.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Not specified. This value should never be used. |
EXAMPLE |
Examples do not contain @-prefixed entity type names, but example parts can be annotated with entity types. |
TEMPLATE |
Templates are not annotated with entity types, but they can contain @-prefixed entity type names as substrings. Template mode has been deprecated. Example mode is the only supported way to create new training phrases. If you have existing training phrases that you've created in template mode, those will continue to work. |
Part
Represents a part of a training phrase.
JSON representation |
---|
{ "text": string, "entityType": string, "alias": string, "userDefined": boolean } |
Fields | |
---|---|
text |
Required. The text for this part. |
entity |
Optional. The entity type name prefixed with |
alias |
Optional. The parameter name for the value extracted from the annotated part of the example. This field is required for annotated parts of the training phrase. |
user |
Optional. Indicates whether the text was manually annotated. This field is set to true when the Dialogflow Console is used to manually annotate the part. When creating an annotated part with the API, you must set this to true. |
Parameter
Represents intent parameters.
JSON representation |
---|
{ "name": string, "displayName": string, "value": string, "defaultValue": string, "entityTypeDisplayName": string, "mandatory": boolean, "prompts": [ string ], "isList": boolean } |
Fields | |
---|---|
name |
The unique identifier of this parameter. |
display |
Required. The name of the parameter. |
value |
Optional. The definition of the parameter value. It can be:
|
default |
Optional. The default value to use when the |
entity |
Optional. The name of the entity type, prefixed with |
mandatory |
Optional. Indicates whether the parameter is required. That is, whether the intent cannot be completed without collecting the parameter value. |
prompts[] |
Optional. The collection of prompts that the agent can present to the user in order to collect a value for the parameter. |
is |
Optional. Indicates whether the parameter represents a list of values. |
Message
A rich response message. Corresponds to the intent Response
field in the Dialogflow console. For more information, see Rich response messages.
JSON representation |
---|
{ "platform": enum ( |
Fields | |
---|---|
platform |
Optional. The platform that this message is intended for. |
Union field message . Required. The rich response message. message can be only one of the following: |
|
text |
The text response. |
image |
The image response. |
quick |
The quick replies response. |
card |
The card response. |
payload |
A custom platform-specific response. |
simple |
The voice and text-only responses for Actions on Google. |
basic |
The basic card response for Actions on Google. |
suggestions |
The suggestion chips for Actions on Google. |
link |
The link out suggestion chip for Actions on Google. |
list |
The list card response for Actions on Google. |
carousel |
The carousel card response for Actions on Google. |
browse |
Browse carousel card for Actions on Google. |
table |
Table card for Actions on Google. |
media |
The media content card for Actions on Google. |
Text
The text response message.
JSON representation |
---|
{ "text": [ string ] } |
Fields | |
---|---|
text[] |
Optional. The collection of the agent's responses. |
Image
The image response message.
JSON representation |
---|
{ "imageUri": string, "accessibilityText": string } |
Fields | |
---|---|
image |
Optional. The public URI to an image file. |
accessibility |
Optional. A text description of the image to be used for accessibility, e.g., screen readers. |
QuickReplies
The quick replies response message.
JSON representation |
---|
{ "title": string, "quickReplies": [ string ] } |
Fields | |
---|---|
title |
Optional. The title of the collection of quick replies. |
quick |
Optional. The collection of quick replies. |
Card
The card response message.
JSON representation |
---|
{
"title": string,
"subtitle": string,
"imageUri": string,
"buttons": [
{
object ( |
Fields | |
---|---|
title |
Optional. The title of the card. |
subtitle |
Optional. The subtitle of the card. |
image |
Optional. The public URI to an image file for the card. |
buttons[] |
Optional. The collection of card buttons. |
Button
Contains information about a button.
JSON representation |
---|
{ "text": string, "postback": string } |
Fields | |
---|---|
text |
Optional. The text to show on the button. |
postback |
Optional. The text to send back to the Dialogflow API or a URI to open. |
SimpleResponses
The collection of simple response candidates. This message in QueryResult.fulfillment_messages
and WebhookResponse.fulfillment_messages
should contain only one SimpleResponse
.
JSON representation |
---|
{
"simpleResponses": [
{
object ( |
Fields | |
---|---|
simple |
Required. The list of simple responses. |
SimpleResponse
The simple response message containing speech or text.
JSON representation |
---|
{ "textToSpeech": string, "ssml": string, "displayText": string } |
Fields | |
---|---|
text |
One of textToSpeech or ssml must be provided. The plain text of the speech output. Mutually exclusive with ssml. |
ssml |
One of textToSpeech or ssml must be provided. Structured spoken response to the user in the SSML format. Mutually exclusive with textToSpeech. |
display |
Optional. The text to display. |
BasicCard
The basic card message. Useful for displaying information.
JSON representation |
---|
{ "title": string, "subtitle": string, "formattedText": string, "image": { object ( |
Fields | |
---|---|
title |
Optional. The title of the card. |
subtitle |
Optional. The subtitle of the card. |
formatted |
Required, unless image is present. The body text of the card. |
image |
Optional. The image for the card. |
buttons[] |
Optional. The collection of card buttons. |
Button
The button object that appears at the bottom of a card.
JSON representation |
---|
{
"title": string,
"openUriAction": {
object ( |
Fields | |
---|---|
title |
Required. The title of the button. |
open |
Required. Action to take when a user taps on the button. |
OpenUriAction
Opens the given URI.
JSON representation |
---|
{ "uri": string } |
Fields | |
---|---|
uri |
Required. The HTTP or HTTPS scheme URI. |
Suggestions
The collection of suggestions.
JSON representation |
---|
{
"suggestions": [
{
object ( |
Fields | |
---|---|
suggestions[] |
Required. The list of suggested replies. |
Suggestion
The suggestion chip message that the user can tap to quickly post a reply to the conversation.
JSON representation |
---|
{ "title": string } |
Fields | |
---|---|
title |
Required. The text shown the in the suggestion chip. |
LinkOutSuggestion
The suggestion chip message that allows the user to jump out to the app or website associated with this agent.
JSON representation |
---|
{ "destinationName": string, "uri": string } |
Fields | |
---|---|
destination |
Required. The name of the app or site this chip is linking to. |
uri |
Required. The URI of the app or site to open when the user taps the suggestion chip. |
ListSelect
The card for presenting a list of options to select from.
JSON representation |
---|
{
"title": string,
"items": [
{
object ( |
Fields | |
---|---|
title |
Optional. The overall title of the list. |
items[] |
Required. List items. |
subtitle |
Optional. Subtitle of the list. |
Item
An item in the list.
JSON representation |
---|
{ "info": { object ( |
Fields | |
---|---|
info |
Required. Additional information about this option. |
title |
Required. The title of the list item. |
description |
Optional. The main text describing the item. |
image |
Optional. The image to display. |
SelectItemInfo
Additional info about the select item for when it is triggered in a dialog.
JSON representation |
---|
{ "key": string, "synonyms": [ string ] } |
Fields | |
---|---|
key |
Required. A unique key that will be sent back to the agent if this response is given. |
synonyms[] |
Optional. A list of synonyms that can also be used to trigger this item in dialog. |
CarouselSelect
The card for presenting a carousel of options to select from.
JSON representation |
---|
{
"items": [
{
object ( |
Fields | |
---|---|
items[] |
Required. Carousel items. |
Item
An item in the carousel.
JSON representation |
---|
{ "info": { object ( |
Fields | |
---|---|
info |
Required. Additional info about the option item. |
title |
Required. Title of the carousel item. |
description |
Optional. The body text of the card. |
image |
Optional. The image to display. |
BrowseCarouselCard
Browse Carousel Card for Actions on Google. https://developers.google.com/actions/assistant/responses#browsing_carousel
JSON representation |
---|
{ "items": [ { object ( |
Fields | |
---|---|
items[] |
Required. List of items in the Browse Carousel Card. Minimum of two items, maximum of ten. |
image |
Optional. Settings for displaying the image. Applies to every image in |
BrowseCarouselCardItem
Browsing carousel tile
JSON representation |
---|
{ "openUriAction": { object ( |
Fields | |
---|---|
open |
Required. Action to present to the user. |
title |
Required. Title of the carousel item. Maximum of two lines of text. |
description |
Optional. Description of the carousel item. Maximum of four lines of text. |
image |
Optional. Hero image for the carousel item. |
footer |
Optional. Text that appears at the bottom of the Browse Carousel Card. Maximum of one line of text. |
OpenUrlAction
Actions on Google action to open a given url.
JSON representation |
---|
{
"url": string,
"urlTypeHint": enum ( |
Fields | |
---|---|
url |
Required. URL |
url |
Optional. Specifies the type of viewer that is used when opening the URL. Defaults to opening via web browser. |
UrlTypeHint
Type of the URI.
Enums | |
---|---|
URL_TYPE_HINT_UNSPECIFIED |
Unspecified |
AMP_ACTION |
Url would be an amp action |
AMP_CONTENT |
URL that points directly to AMP content, or to a canonical URL which refers to AMP content via . |
ImageDisplayOptions
Image display options for Actions on Google. This should be used for when the image's aspect ratio does not match the image container's aspect ratio.
Enums | |
---|---|
IMAGE_DISPLAY_OPTIONS_UNSPECIFIED |
Fill the gaps between the image and the image container with gray bars. |
GRAY |
Fill the gaps between the image and the image container with gray bars. |
WHITE |
Fill the gaps between the image and the image container with white bars. |
CROPPED |
Image is scaled such that the image width and height match or exceed the container dimensions. This may crop the top and bottom of the image if the scaled image height is greater than the container height, or crop the left and right of the image if the scaled image width is greater than the container width. This is similar to "Zoom Mode" on a widescreen TV when playing a 4:3 video. |
BLURRED_BACKGROUND |
Pad the gaps between image and image frame with a blurred copy of the same image. |
TableCard
Table card for Actions on Google.
JSON representation |
---|
{ "title": string, "subtitle": string, "image": { object ( |
Fields | |
---|---|
title |
Required. Title of the card. |
subtitle |
Optional. Subtitle to the title. |
image |
Optional. Image which should be displayed on the card. |
column |
Optional. Display properties for the columns in this table. |
rows[] |
Optional. Rows in this table of data. |
buttons[] |
Optional. List of buttons for the card. |
ColumnProperties
Column properties for TableCard
.
JSON representation |
---|
{
"header": string,
"horizontalAlignment": enum ( |
Fields | |
---|---|
header |
Required. Column heading. |
horizontal |
Optional. Defines text alignment for all cells in this column. |
HorizontalAlignment
Text alignments within a cell.
Enums | |
---|---|
HORIZONTAL_ALIGNMENT_UNSPECIFIED |
Text is aligned to the leading edge of the column. |
LEADING |
Text is aligned to the leading edge of the column. |
CENTER |
Text is centered in the column. |
TRAILING |
Text is aligned to the trailing edge of the column. |
TableCardRow
Row of TableCard
.
JSON representation |
---|
{
"cells": [
{
object ( |
Fields | |
---|---|
cells[] |
Optional. List of cells that make up this row. |
divider |
Optional. Whether to add a visual divider after this row. |
TableCardCell
Cell of TableCardRow
.
JSON representation |
---|
{ "text": string } |
Fields | |
---|---|
text |
Required. Text in this cell. |
MediaContent
The media content card for Actions on Google.
JSON representation |
---|
{ "mediaType": enum ( |
Fields | |
---|---|
media |
Optional. What type of media is the content (ie "audio"). |
media |
Required. List of media objects. |
ResponseMediaType
Format of response media type.
Enums | |
---|---|
RESPONSE_MEDIA_TYPE_UNSPECIFIED |
Unspecified. |
AUDIO |
Response media type is audio. |
ResponseMediaObject
Response media object for media content card.
JSON representation |
---|
{ "name": string, "description": string, "contentUrl": string, // Union field |
Fields | |
---|---|
name |
Required. Name of media card. |
description |
Optional. Description of media card. |
content |
Required. Url where the media is stored. |
Union field image . Image to show with the media card. image can be only one of the following: |
|
large |
Optional. Image to display above media content. |
icon |
Optional. Icon to display above media content. |
Platform
The rich response message integration platform. See Integrations.
Enums | |
---|---|
PLATFORM_UNSPECIFIED |
Default platform. |
FACEBOOK |
Facebook. |
SLACK |
Slack. |
TELEGRAM |
Telegram. |
KIK |
Kik. |
SKYPE |
Skype. |
LINE |
Line. |
VIBER |
Viber. |
ACTIONS_ON_GOOGLE |
Google Assistant See Dialogflow webhook format |
GOOGLE_HANGOUTS |
Google Hangouts. |
FollowupIntentInfo
Represents a single followup intent in the chain.
JSON representation |
---|
{ "followupIntentName": string, "parentFollowupIntentName": string } |
Fields | |
---|---|
followup |
The unique identifier of the followup intent. Format: |
parent |
The unique identifier of the followup intent's parent. Format: |
Methods |
|
---|---|
|
Deletes intents in the specified agent. |
|
Updates/Creates multiple intents in the specified agent. |
|
Creates an intent in the specified agent. |
|
Deletes the specified intent and its direct or indirect followup intents. |
|
Retrieves the specified intent. |
|
Returns the list of all intents in the specified agent. |
|
Updates the specified intent. |