suguo
/
googleapis
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
googleapis/google/cloud/dialogflow/v2beta1/intent.proto

1401 lines
50 KiB
Protocol Buffer
Raw Blame History

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.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://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
syntax = "proto3";
package google.cloud.dialogflow.v2beta1;
import "google/api/annotations.proto";
import "google/api/client.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
import "google/cloud/dialogflow/v2beta1/audio_config.proto";
import "google/cloud/dialogflow/v2beta1/context.proto";
import "google/longrunning/operations.proto";
import "google/protobuf/duration.proto";
import "google/protobuf/empty.proto";
import "google/protobuf/field_mask.proto";
import "google/protobuf/struct.proto";
option cc_enable_arenas = true;
option csharp_namespace = "Google.Cloud.Dialogflow.V2beta1";
option go_package = "google.golang.org/genproto/googleapis/cloud/dialogflow/v2beta1;dialogflow";
option java_multiple_files = true;
option java_outer_classname = "IntentProto";
option java_package = "com.google.cloud.dialogflow.v2beta1";
option objc_class_prefix = "DF";
// Service for managing [Intents][google.cloud.dialogflow.v2beta1.Intent].
service Intents {
option (google.api.default_host) = "dialogflow.googleapis.com";
option (google.api.oauth_scopes) =
"https://www.googleapis.com/auth/cloud-platform,"
"https://www.googleapis.com/auth/dialogflow";
// Returns the list of all intents in the specified agent.
rpc ListIntents(ListIntentsRequest) returns (ListIntentsResponse) {
option (google.api.http) = {
get: "/v2beta1/{parent=projects/*/agent}/intents"
additional_bindings {
get: "/v2beta1/{parent=projects/*/locations/*/agent}/intents"
}
};
option (google.api.method_signature) = "parent";
option (google.api.method_signature) = "parent,language_code";
}
// Retrieves the specified intent.
rpc GetIntent(GetIntentRequest) returns (Intent) {
option (google.api.http) = {
get: "/v2beta1/{name=projects/*/agent/intents/*}"
additional_bindings {
get: "/v2beta1/{name=projects/*/locations/*/agent/intents/*}"
}
};
option (google.api.method_signature) = "name";
option (google.api.method_signature) = "name,language_code";
}
// Creates an intent in the specified agent.
rpc CreateIntent(CreateIntentRequest) returns (Intent) {
option (google.api.http) = {
post: "/v2beta1/{parent=projects/*/agent}/intents"
body: "intent"
additional_bindings {
post: "/v2beta1/{parent=projects/*/locations/*/agent}/intents"
body: "intent"
}
};
option (google.api.method_signature) = "parent,intent";
option (google.api.method_signature) = "parent,intent,language_code";
}
// Updates the specified intent.
rpc UpdateIntent(UpdateIntentRequest) returns (Intent) {
option (google.api.http) = {
patch: "/v2beta1/{intent.name=projects/*/agent/intents/*}"
body: "intent"
additional_bindings {
patch: "/v2beta1/{intent.name=projects/*/locations/*/agent/intents/*}"
body: "intent"
}
};
option (google.api.method_signature) = "intent,update_mask";
option (google.api.method_signature) = "intent";
option (google.api.method_signature) = "intent,language_code";
option (google.api.method_signature) = "intent,language_code,update_mask";
}
// Deletes the specified intent and its direct or indirect followup intents.
rpc DeleteIntent(DeleteIntentRequest) returns (google.protobuf.Empty) {
option (google.api.http) = {
delete: "/v2beta1/{name=projects/*/agent/intents/*}"
additional_bindings {
delete: "/v2beta1/{name=projects/*/locations/*/agent/intents/*}"
}
};
option (google.api.method_signature) = "name";
}
// Updates/Creates multiple intents in the specified agent.
//
// Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2beta1.BatchUpdateIntentsResponse]>
rpc BatchUpdateIntents(BatchUpdateIntentsRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
post: "/v2beta1/{parent=projects/*/agent}/intents:batchUpdate"
body: "*"
additional_bindings {
post: "/v2beta1/{parent=projects/*/locations/*/agent}/intents:batchUpdate"
body: "*"
}
};
option (google.longrunning.operation_info) = {
response_type: "google.cloud.dialogflow.v2beta1.BatchUpdateIntentsResponse"
metadata_type: "google.protobuf.Struct"
};
}
// Deletes intents in the specified agent.
//
// Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>
rpc BatchDeleteIntents(BatchDeleteIntentsRequest) returns (google.longrunning.Operation) {
option (google.api.http) = {
post: "/v2beta1/{parent=projects/*/agent}/intents:batchDelete"
body: "*"
additional_bindings {
post: "/v2beta1/{parent=projects/*/locations/*/agent}/intents:batchDelete"
body: "*"
}
};
option (google.api.method_signature) = "parent,intents";
option (google.longrunning.operation_info) = {
response_type: "google.protobuf.Empty"
metadata_type: "google.protobuf.Struct"
};
}
}
// 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](https://cloud.google.com/dialogflow/docs/intents-overview).
message Intent {
option (google.api.resource) = {
type: "dialogflow.googleapis.com/Intent"
pattern: "projects/{project}/agent/intents/{intent}"
pattern: "projects/{project}/locations/{location}/agent/intents/{intent}"
};
// Represents an example that the agent is trained on.
message TrainingPhrase {
// Represents a part of a training phrase.
message Part {
// Required. The text for this part.
string text = 1;
// Optional. The entity type name prefixed with `@`.
// This field is required for annotated parts of the training phrase.
string entity_type = 2;
// 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.
string alias = 3;
// 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.
bool user_defined = 4;
}
// Represents different types of training phrases.
enum Type {
// Not specified. This value should never be used.
TYPE_UNSPECIFIED = 0;
// Examples do not contain @-prefixed entity type names, but example parts
// can be annotated with entity types.
EXAMPLE = 1;
// 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.
TEMPLATE = 2 [deprecated = true];
}
// Output only. The unique identifier of this training phrase.
string name = 1;
// Required. The type of the training phrase.
Type type = 2 [(google.api.field_behavior) = REQUIRED];
// 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 [Part.text][google.cloud.dialogflow.v2beta1.Intent.TrainingPhrase.Part.text] field set.
//
// 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:
//
// - `Part.text` is set to a part of the phrase that has no parameters.
// - `Part.text` is set to a part of the phrase that you want to annotate,
// and the `entity_type`, `alias`, and `user_defined` fields are all
// set.
repeated Part parts = 3 [(google.api.field_behavior) = REQUIRED];
// 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.
int32 times_added_count = 4 [(google.api.field_behavior) = OPTIONAL];
}
// Represents intent parameters.
message Parameter {
// The unique identifier of this parameter.
string name = 1;
// Required. The name of the parameter.
string display_name = 2;
// Optional. The definition of the parameter value. It can be:
//
// - a constant string,
// - a parameter value defined as `$parameter_name`,
// - an original parameter value defined as `$parameter_name.original`,
// - a parameter value from some context defined as
// `#context_name.parameter_name`.
string value = 3;
// Optional. The default value to use when the `value` yields an empty
// result.
// Default values can be extracted from contexts by using the following
// syntax: `#context_name.parameter_name`.
string default_value = 4;
// Optional. The name of the entity type, prefixed with `@`, that
// describes values of the parameter. If the parameter is
// required, this must be provided.
string entity_type_display_name = 5;
// Optional. Indicates whether the parameter is required. That is,
// whether the intent cannot be completed without collecting the parameter
// value.
bool mandatory = 6;
// Optional. The collection of prompts that the agent can present to the
// user in order to collect a value for the parameter.
repeated string prompts = 7;
// Optional. Indicates whether the parameter represents a list of values.
bool is_list = 8;
}
// Corresponds to the `Response` field in the Dialogflow console.
message Message {
// The text response message.
message Text {
// Optional. The collection of the agent's responses.
repeated string text = 1;
}
// The image response message.
message Image {
// Optional. The public URI to an image file.
string image_uri = 1;
// A text description of the image to be used for accessibility,
// e.g., screen readers. Required if image_uri is set for CarouselSelect.
string accessibility_text = 2;
}
// The quick replies response message.
message QuickReplies {
// Optional. The title of the collection of quick replies.
string title = 1;
// Optional. The collection of quick replies.
repeated string quick_replies = 2;
}
// The card response message.
message Card {
// Optional. Contains information about a button.
message Button {
// Optional. The text to show on the button.
string text = 1;
// Optional. The text to send back to the Dialogflow API or a URI to
// open.
string postback = 2;
}
// Optional. The title of the card.
string title = 1;
// Optional. The subtitle of the card.
string subtitle = 2;
// Optional. The public URI to an image file for the card.
string image_uri = 3;
// Optional. The collection of card buttons.
repeated Button buttons = 4;
}
// The simple response message containing speech or text.
message SimpleResponse {
// One of text_to_speech or ssml must be provided. The plain text of the
// speech output. Mutually exclusive with ssml.
string text_to_speech = 1;
// One of text_to_speech or ssml must be provided. Structured spoken
// response to the user in the SSML format. Mutually exclusive with
// text_to_speech.
string ssml = 2;
// Optional. The text to display.
string display_text = 3;
}
// The collection of simple response candidates.
// This message in `QueryResult.fulfillment_messages` and
// `WebhookResponse.fulfillment_messages` should contain only one
// `SimpleResponse`.
message SimpleResponses {
// Required. The list of simple responses.
repeated SimpleResponse simple_responses = 1;
}
// The basic card message. Useful for displaying information.
message BasicCard {
// The button object that appears at the bottom of a card.
message Button {
// Opens the given URI.
message OpenUriAction {
// Required. The HTTP or HTTPS scheme URI.
string uri = 1;
}
// Required. The title of the button.
string title = 1;
// Required. Action to take when a user taps on the button.
OpenUriAction open_uri_action = 2;
}
// Optional. The title of the card.
string title = 1;
// Optional. The subtitle of the card.
string subtitle = 2;
// Required, unless image is present. The body text of the card.
string formatted_text = 3;
// Optional. The image for the card.
Image image = 4;
// Optional. The collection of card buttons.
repeated Button buttons = 5;
}
// The suggestion chip message that the user can tap to quickly post a reply
// to the conversation.
message Suggestion {
// Required. The text shown the in the suggestion chip.
string title = 1;
}
// The collection of suggestions.
message Suggestions {
// Required. The list of suggested replies.
repeated Suggestion suggestions = 1;
}
// The suggestion chip message that allows the user to jump out to the app
// or website associated with this agent.
message LinkOutSuggestion {
// Required. The name of the app or site this chip is linking to.
string destination_name = 1;
// Required. The URI of the app or site to open when the user taps the
// suggestion chip.
string uri = 2;
}
// The card for presenting a list of options to select from.
message ListSelect {
// An item in the list.
message Item {
// Required. Additional information about this option.
SelectItemInfo info = 1;
// Required. The title of the list item.
string title = 2;
// Optional. The main text describing the item.
string description = 3;
// Optional. The image to display.
Image image = 4;
}
// Optional. The overall title of the list.
string title = 1;
// Required. List items.
repeated Item items = 2;
// Optional. Subtitle of the list.
string subtitle = 3 [(google.api.field_behavior) = OPTIONAL];
}
// The card for presenting a carousel of options to select from.
message CarouselSelect {
// An item in the carousel.
message Item {
// Required. Additional info about the option item.
SelectItemInfo info = 1;
// Required. Title of the carousel item.
string title = 2;
// Optional. The body text of the card.
string description = 3;
// Optional. The image to display.
Image image = 4;
}
// Required. Carousel items.
repeated Item items = 1;
}
// Additional info about the select item for when it is triggered in a
// dialog.
message SelectItemInfo {
// Required. A unique key that will be sent back to the agent if this
// response is given.
string key = 1;
// Optional. A list of synonyms that can also be used to trigger this
// item in dialog.
repeated string synonyms = 2;
}
// Plays audio from a file in Telephony Gateway.
message TelephonyPlayAudio {
// Required. URI to a Google Cloud Storage object containing the audio to
// play, e.g., "gs://bucket/object". The object must contain a single
// channel (mono) of linear PCM audio (2 bytes / sample) at 8kHz.
//
// This object must be readable by the `service-<Project
// Number>@gcp-sa-dialogflow.iam.gserviceaccount.com` service account
// where <Project Number> is the number of the Telephony Gateway project
// (usually the same as the Dialogflow agent project). If the Google Cloud
// Storage bucket is in the Telephony Gateway project, this permission is
// added by default when enabling the Dialogflow V2 API.
//
// For audio from other sources, consider using the
// `TelephonySynthesizeSpeech` message with SSML.
string audio_uri = 1;
}
// Synthesizes speech and plays back the synthesized audio to the caller in
// Telephony Gateway.
//
// Telephony Gateway takes the synthesizer settings from
// `DetectIntentResponse.output_audio_config` which can either be set
// at request-level or can come from the agent-level synthesizer config.
message TelephonySynthesizeSpeech {
// Required. The source to be synthesized.
oneof source {
// The raw text to be synthesized.
string text = 1;
// The SSML to be synthesized. For more information, see
// [SSML](https://developers.google.com/actions/reference/ssml).
string ssml = 2;
}
}
// Transfers the call in Telephony Gateway.
message TelephonyTransferCall {
// Required. The phone number to transfer the call to
// in [E.164 format](https://en.wikipedia.org/wiki/E.164).
//
// We currently only allow transferring to US numbers (+1xxxyyyzzzz).
string phone_number = 1;
}
// Rich Business Messaging (RBM) text response with suggestions.
message RbmText {
// Required. Text sent and displayed to the user.
string text = 1;
// Optional. One or more suggestions to show to the user.
repeated RbmSuggestion rbm_suggestion = 2;
}
// Carousel Rich Business Messaging (RBM) rich card.
//
// Rich cards allow you to respond to users with more vivid content, e.g.
// with media and suggestions.
//
// If you want to show a single card with more control over the layout,
// please use [RbmStandaloneCard][google.cloud.dialogflow.v2beta1.Intent.Message.RbmStandaloneCard] instead.
message RbmCarouselCard {
// The width of the cards in the carousel.
enum CardWidth {
// Not specified.
CARD_WIDTH_UNSPECIFIED = 0;
// 120 DP. Note that tall media cannot be used.
SMALL = 1;
// 232 DP.
MEDIUM = 2;
}
// Required. The width of the cards in the carousel.
CardWidth card_width = 1;
// Required. The cards in the carousel. A carousel must have at least
// 2 cards and at most 10.
repeated RbmCardContent card_contents = 2;
}
// Standalone Rich Business Messaging (RBM) rich card.
//
// Rich cards allow you to respond to users with more vivid content, e.g.
// with media and suggestions.
//
// You can group multiple rich cards into one using [RbmCarouselCard][google.cloud.dialogflow.v2beta1.Intent.Message.RbmCarouselCard] but
// carousel cards will give you less control over the card layout.
message RbmStandaloneCard {
// Orientation of the card.
enum CardOrientation {
// Not specified.
CARD_ORIENTATION_UNSPECIFIED = 0;
// Horizontal layout.
HORIZONTAL = 1;
// Vertical layout.
VERTICAL = 2;
}
// Thumbnail preview alignment for standalone cards with horizontal
// layout.
enum ThumbnailImageAlignment {
// Not specified.
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED = 0;
// Thumbnail preview is left-aligned.
LEFT = 1;
// Thumbnail preview is right-aligned.
RIGHT = 2;
}
// Required. Orientation of the card.
CardOrientation card_orientation = 1;
// Required if orientation is horizontal.
// Image preview alignment for standalone cards with horizontal layout.
ThumbnailImageAlignment thumbnail_image_alignment = 2;
// Required. Card content.
RbmCardContent card_content = 3;
}
// Rich Business Messaging (RBM) Card content
message RbmCardContent {
// Rich Business Messaging (RBM) Media displayed in Cards
// The following media-types are currently supported:
//
// Image Types
//
// * image/jpeg
// * image/jpg'
// * image/gif
// * image/png
//
// Video Types
//
// * video/h263
// * video/m4v
// * video/mp4
// * video/mpeg
// * video/mpeg4
// * video/webm
message RbmMedia {
// Media height
enum Height {
// Not specified.
HEIGHT_UNSPECIFIED = 0;
// 112 DP.
SHORT = 1;
// 168 DP.
MEDIUM = 2;
// 264 DP. Not available for rich card carousels when the card width
// is set to small.
TALL = 3;
}
// Required. Publicly reachable URI of the file. The RBM platform
// determines the MIME type of the file from the content-type field in
// the HTTP headers when the platform fetches the file. The content-type
// field must be present and accurate in the HTTP response from the URL.
string file_uri = 1;
// Optional. Publicly reachable URI of the thumbnail.If you don't
// provide a thumbnail URI, the RBM platform displays a blank
// placeholder thumbnail until the user's device downloads the file.
// Depending on the user's setting, the file may not download
// automatically and may require the user to tap a download button.
string thumbnail_uri = 2;
// Required for cards with vertical orientation. The height of the media
// within a rich card with a vertical layout.
// For a standalone card with horizontal layout, height is not
// customizable, and this field is ignored.
Height height = 3;
}
// Optional. Title of the card (at most 200 bytes).
//
// At least one of the title, description or media must be set.
string title = 1;
// Optional. Description of the card (at most 2000 bytes).
//
// At least one of the title, description or media must be set.
string description = 2;
// Optional. However at least one of the title, description or media must
// be set. Media (image, GIF or a video) to include in the card.
RbmMedia media = 3;
// Optional. List of suggestions to include in the card.
repeated RbmSuggestion suggestions = 4;
}
// Rich Business Messaging (RBM) suggestion. Suggestions allow user to
// easily select/click a predefined response or perform an action (like
// opening a web uri).
message RbmSuggestion {
// Predefined suggested response or action for user to choose
oneof suggestion {
// Predefined replies for user to select instead of typing
RbmSuggestedReply reply = 1;
// Predefined client side actions that user can choose
RbmSuggestedAction action = 2;
}
}
// Rich Business Messaging (RBM) suggested reply that the user can click
// instead of typing in their own response.
message RbmSuggestedReply {
// Suggested reply text.
string text = 1;
// Opaque payload that the Dialogflow receives in a user event
// when the user taps the suggested reply. This data will be also
// forwarded to webhook to allow performing custom business logic.
string postback_data = 2;
}
// Rich Business Messaging (RBM) suggested client-side action that the user
// can choose from the card.
message RbmSuggestedAction {
// Opens the user's default dialer app with the specified phone number
// but does not dial automatically.
message RbmSuggestedActionDial {
// Required. The phone number to fill in the default dialer app.
// This field should be in [E.164](https://en.wikipedia.org/wiki/E.164)
// format. An example of a correctly formatted phone number:
// +15556767888.
string phone_number = 1;
}
// Opens the user's default web browser app to the specified uri
// If the user has an app installed that is
// registered as the default handler for the URL, then this app will be
// opened instead, and its icon will be used in the suggested action UI.
message RbmSuggestedActionOpenUri {
// Required. The uri to open on the user device
string uri = 1;
}
// Opens the device's location chooser so the user can pick a location
// to send back to the agent.
message RbmSuggestedActionShareLocation {
}
// Text to display alongside the action.
string text = 1;
// Opaque payload that the Dialogflow receives in a user event
// when the user taps the suggested action. This data will be also
// forwarded to webhook to allow performing custom business logic.
string postback_data = 2;
// Action that needs to be triggered.
oneof action {
// Suggested client side action: Dial a phone number
RbmSuggestedActionDial dial = 3;
// Suggested client side action: Open a URI on device
RbmSuggestedActionOpenUri open_url = 4;
// Suggested client side action: Share user location
RbmSuggestedActionShareLocation share_location = 5;
}
}
// The media content card for Actions on Google.
message MediaContent {
// Response media object for media content card.
message ResponseMediaObject {
// Required. Name of media card.
string name = 1;
// Optional. Description of media card.
string description = 2;
// Image to show with the media card.
oneof image {
// Optional. Image to display above media content.
Image large_image = 3;
// Optional. Icon to display above media content.
Image icon = 4;
}
// Required. Url where the media is stored.
string content_url = 5;
}
// Format of response media type.
enum ResponseMediaType {
// Unspecified.
RESPONSE_MEDIA_TYPE_UNSPECIFIED = 0;
// Response media type is audio.
AUDIO = 1;
}
// Optional. What type of media is the content (ie "audio").
ResponseMediaType media_type = 1;
// Required. List of media objects.
repeated ResponseMediaObject media_objects = 2;
}
// Browse Carousel Card for Actions on Google.
// https://developers.google.com/actions/assistant/responses#browsing_carousel
message BrowseCarouselCard {
// Browsing carousel tile
message BrowseCarouselCardItem {
// Actions on Google action to open a given url.
message OpenUrlAction {
// Type of the URI.
enum UrlTypeHint {
// Unspecified
URL_TYPE_HINT_UNSPECIFIED = 0;
// Url would be an amp action
AMP_ACTION = 1;
// URL that points directly to AMP content, or to a canonical URL
// which refers to AMP content via <link rel="amphtml">.
AMP_CONTENT = 2;
}
// Required. URL
string url = 1;
// Optional. Specifies the type of viewer that is used when opening
// the URL. Defaults to opening via web browser.
UrlTypeHint url_type_hint = 3;
}
// Required. Action to present to the user.
OpenUrlAction open_uri_action = 1;
// Required. Title of the carousel item. Maximum of two lines of text.
string title = 2;
// Optional. Description of the carousel item. Maximum of four lines of
// text.
string description = 3;
// Optional. Hero image for the carousel item.
Image image = 4;
// Optional. Text that appears at the bottom of the Browse Carousel
// Card. Maximum of one line of text.
string footer = 5;
}
// 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.
enum ImageDisplayOptions {
// Fill the gaps between the image and the image container with gray
// bars.
IMAGE_DISPLAY_OPTIONS_UNSPECIFIED = 0;
// Fill the gaps between the image and the image container with gray
// bars.
GRAY = 1;
// Fill the gaps between the image and the image container with white
// bars.
WHITE = 2;
// 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.
CROPPED = 3;
// Pad the gaps between image and image frame with a blurred copy of the
// same image.
BLURRED_BACKGROUND = 4;
}
// Required. List of items in the Browse Carousel Card. Minimum of two
// items, maximum of ten.
repeated BrowseCarouselCardItem items = 1;
// Optional. Settings for displaying the image. Applies to every image in
// [items][google.cloud.dialogflow.v2beta1.Intent.Message.BrowseCarouselCard.items].
ImageDisplayOptions image_display_options = 2;
}
// Table card for Actions on Google.
message TableCard {
// Required. Title of the card.
string title = 1;
// Optional. Subtitle to the title.
string subtitle = 2;
// Optional. Image which should be displayed on the card.
Image image = 3;
// Optional. Display properties for the columns in this table.
repeated ColumnProperties column_properties = 4;
// Optional. Rows in this table of data.
repeated TableCardRow rows = 5;
// Optional. List of buttons for the card.
repeated BasicCard.Button buttons = 6;
}
// Column properties for [TableCard][google.cloud.dialogflow.v2beta1.Intent.Message.TableCard].
message ColumnProperties {
// Text alignments within a cell.
enum HorizontalAlignment {
// Text is aligned to the leading edge of the column.
HORIZONTAL_ALIGNMENT_UNSPECIFIED = 0;
// Text is aligned to the leading edge of the column.
LEADING = 1;
// Text is centered in the column.
CENTER = 2;
// Text is aligned to the trailing edge of the column.
TRAILING = 3;
}
// Required. Column heading.
string header = 1;
// Optional. Defines text alignment for all cells in this column.
HorizontalAlignment horizontal_alignment = 2;
}
// Row of [TableCard][google.cloud.dialogflow.v2beta1.Intent.Message.TableCard].
message TableCardRow {
// Optional. List of cells that make up this row.
repeated TableCardCell cells = 1;
// Optional. Whether to add a visual divider after this row.
bool divider_after = 2;
}
// Cell of [TableCardRow][google.cloud.dialogflow.v2beta1.Intent.Message.TableCardRow].
message TableCardCell {
// Required. Text in this cell.
string text = 1;
}
// Represents different platforms that a rich message can be intended for.
enum Platform {
// Not specified.
PLATFORM_UNSPECIFIED = 0;
// Facebook.
FACEBOOK = 1;
// Slack.
SLACK = 2;
// Telegram.
TELEGRAM = 3;
// Kik.
KIK = 4;
// Skype.
SKYPE = 5;
// Line.
LINE = 6;
// Viber.
VIBER = 7;
// Google Assistant
// See [Dialogflow webhook
// format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)
ACTIONS_ON_GOOGLE = 8;
// Telephony Gateway.
TELEPHONY = 10;
// Google Hangouts.
GOOGLE_HANGOUTS = 11;
}
// Required. The rich response message.
oneof message {
// Returns a text response.
Text text = 1;
// Displays an image.
Image image = 2;
// Displays quick replies.
QuickReplies quick_replies = 3;
// Displays a card.
Card card = 4;
// A custom platform-specific response.
google.protobuf.Struct payload = 5;
// Returns a voice or text-only response for Actions on Google.
SimpleResponses simple_responses = 7;
// Displays a basic card for Actions on Google.
BasicCard basic_card = 8;
// Displays suggestion chips for Actions on Google.
Suggestions suggestions = 9;
// Displays a link out suggestion chip for Actions on Google.
LinkOutSuggestion link_out_suggestion = 10;
// Displays a list card for Actions on Google.
ListSelect list_select = 11;
// Displays a carousel card for Actions on Google.
CarouselSelect carousel_select = 12;
// Plays audio from a file in Telephony Gateway.
TelephonyPlayAudio telephony_play_audio = 13;
// Synthesizes speech in Telephony Gateway.
TelephonySynthesizeSpeech telephony_synthesize_speech = 14;
// Transfers the call in Telephony Gateway.
TelephonyTransferCall telephony_transfer_call = 15;
// Rich Business Messaging (RBM) text response.
//
// RBM allows businesses to send enriched and branded versions of SMS. See
// https://jibe.google.com/business-messaging.
RbmText rbm_text = 18;
// Standalone Rich Business Messaging (RBM) rich card response.
RbmStandaloneCard rbm_standalone_rich_card = 19;
// Rich Business Messaging (RBM) carousel rich card response.
RbmCarouselCard rbm_carousel_rich_card = 20;
// Browse carousel card for Actions on Google.
BrowseCarouselCard browse_carousel_card = 22;
// Table card for Actions on Google.
TableCard table_card = 23;
// The media content card for Actions on Google.
MediaContent media_content = 24;
}
// Optional. The platform that this message is intended for.
Platform platform = 6 [(google.api.field_behavior) = OPTIONAL];
}
// Represents a single followup intent in the chain.
message FollowupIntentInfo {
// The unique identifier of the followup intent.
// Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
string followup_intent_name = 1;
// The unique identifier of the followup intent's parent.
// Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
string parent_followup_intent_name = 2;
}
// Represents the different states that webhooks can be in.
enum WebhookState {
// Webhook is disabled in the agent and in the intent.
WEBHOOK_STATE_UNSPECIFIED = 0;
// Webhook is enabled in the agent and in the intent.
WEBHOOK_STATE_ENABLED = 1;
// Webhook is enabled in the agent and in the intent. Also, each slot
// filling prompt is forwarded to the webhook.
WEBHOOK_STATE_ENABLED_FOR_SLOT_FILLING = 2;
}
// Optional. The unique identifier of this intent.
// Required for [Intents.UpdateIntent][google.cloud.dialogflow.v2beta1.Intents.UpdateIntent] and [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents]
// methods.
// Supported formats:
//
// - `projects/<Project ID>/agent/intents/<Intent ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/intents/<Intent ID>`
string name = 1 [(google.api.field_behavior) = OPTIONAL];
// Required. The name of this intent.
string display_name = 2 [(google.api.field_behavior) = REQUIRED];
// Optional. Indicates whether webhooks are enabled for the intent.
WebhookState webhook_state = 6 [(google.api.field_behavior) = OPTIONAL];
// Optional. The priority of this intent. Higher numbers represent higher
// priorities.
//
// - If the supplied value is unspecified or 0, the service
// translates the value to 500,000, which corresponds to the
// `Normal` priority in the console.
// - If the supplied value is negative, the intent is ignored
// in runtime detect intent requests.
int32 priority = 3 [(google.api.field_behavior) = OPTIONAL];
// Optional. Indicates whether this is a fallback intent.
bool is_fallback = 4 [(google.api.field_behavior) = OPTIONAL];
// Optional. Indicates whether Machine Learning is enabled for the intent.
// Note: If `ml_enabled` setting is set to false, then this intent is not
// taken into account during inference in `ML ONLY` match mode. Also,
// auto-markup in the UI is turned off.
// DEPRECATED! Please use `ml_disabled` field instead.
// NOTE: If both `ml_enabled` and `ml_disabled` are either not set or false,
// then the default value is determined as follows:
//
// - Before April 15th, 2018 the default is:
// ml_enabled = false / ml_disabled = true.
// - After April 15th, 2018 the default is:
// ml_enabled = true / ml_disabled = false.
bool ml_enabled = 5 [
deprecated = true,
(google.api.field_behavior) = OPTIONAL
];
// Optional. Indicates whether Machine Learning is disabled for the intent.
// Note: If `ml_disabled` setting is set to true, then this intent is not
// taken into account during inference in `ML ONLY` match mode. Also,
// auto-markup in the UI is turned off.
bool ml_disabled = 19 [(google.api.field_behavior) = OPTIONAL];
// 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.
bool end_interaction = 21 [(google.api.field_behavior) = OPTIONAL];
// Optional. The list of context names required for this intent to be
// triggered.
// Formats:
//
// - `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`
// - `projects/<Project ID>/locations/<Location
// ID>/agent/sessions/-/contexts/<Context ID>`
repeated string input_context_names = 7 [(google.api.field_behavior) = OPTIONAL];
// 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.
repeated string events = 8 [(google.api.field_behavior) = OPTIONAL];
// Optional. The collection of examples that the agent is
// trained on.
repeated TrainingPhrase training_phrases = 9 [(google.api.field_behavior) = OPTIONAL];
// Optional. The name of the action associated with the intent.
// Note: The action name must not contain whitespaces.
string action = 10 [(google.api.field_behavior) = OPTIONAL];
// 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 `lifespan_count` to 0 will reset the context
// when the intent is matched.
// Format: `projects/<Project ID>/agent/sessions/-/contexts/<Context ID>`.
repeated Context output_contexts = 11 [(google.api.field_behavior) = OPTIONAL];
// Optional. Indicates whether to delete all contexts in the current
// session when this intent is matched.
bool reset_contexts = 12 [(google.api.field_behavior) = OPTIONAL];
// Optional. The collection of parameters associated with the intent.
repeated Parameter parameters = 13 [(google.api.field_behavior) = OPTIONAL];
// Optional. The collection of rich messages corresponding to the
// `Response` field in the Dialogflow console.
repeated Message messages = 14;
// Optional. The list of platforms for which the first responses will be
// copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform).
repeated Message.Platform default_response_platforms = 15 [(google.api.field_behavior) = OPTIONAL];
// Output only. The unique identifier of the root intent in the chain of
// followup intents. It identifies the correct followup intents chain for
// this intent.
//
// Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
string root_followup_intent_name = 16 [(google.api.field_behavior) = OUTPUT_ONLY];
// Optional. 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 [CreateIntent][google.cloud.dialogflow.v2beta1.Intents.CreateIntent] or
// [BatchUpdateIntents][google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents], in order to make this
// intent a followup intent.
//
// It identifies the parent followup intent.
// Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
string parent_followup_intent_name = 17 [(google.api.field_behavior) = OPTIONAL];
// Output only. Information about all followup intents that have this intent as
// a direct or indirect parent. We populate this field only in the output.
repeated FollowupIntentInfo followup_intent_info = 18 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The request message for [Intents.ListIntents][google.cloud.dialogflow.v2beta1.Intents.ListIntents].
message ListIntentsRequest {
// Required. The agent to list all intents from.
// Format: `projects/<Project ID>/agent`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
child_type: "dialogflow.googleapis.com/Intent"
}
];
// Optional. The language used to access language-specific data.
// If not specified, the agent's default language is used.
// For more information, see
// [Multilingual intent and entity
// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. The resource view to apply to the returned intent.
IntentView intent_view = 3;
// Optional. The maximum number of items to return in a single page. By
// default 100 and at most 1000.
int32 page_size = 4;
// Optional. The next_page_token value returned from a previous list request.
string page_token = 5;
}
// The response message for [Intents.ListIntents][google.cloud.dialogflow.v2beta1.Intents.ListIntents].
message ListIntentsResponse {
// The list of agent intents. There will be a maximum number of items
// returned based on the page_size field in the request.
repeated Intent intents = 1;
// Token to retrieve the next page of results, or empty if there are no
// more results in the list.
string next_page_token = 2;
}
// The request message for [Intents.GetIntent][google.cloud.dialogflow.v2beta1.Intents.GetIntent].
message GetIntentRequest {
// Required. The name of the intent.
// Supported formats:
//
// - `projects/<Project ID>/agent/intents/<Intent ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/intents/<Intent ID>`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "dialogflow.googleapis.com/Intent"
}
];
// Optional. The language used to access language-specific data.
// If not specified, the agent's default language is used.
// For more information, see
// [Multilingual intent and entity
// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. The resource view to apply to the returned intent.
IntentView intent_view = 3;
}
// The request message for [Intents.CreateIntent][google.cloud.dialogflow.v2beta1.Intents.CreateIntent].
message CreateIntentRequest {
// Required. The agent to create a intent for.
// Supported formats:
//
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
child_type: "dialogflow.googleapis.com/Intent"
}
];
// Required. The intent to create.
Intent intent = 2 [(google.api.field_behavior) = REQUIRED];
// Optional. The language used to access language-specific data.
// If not specified, the agent's default language is used.
// For more information, see
// [Multilingual intent and entity
// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
string language_code = 3 [(google.api.field_behavior) = OPTIONAL];
// Optional. The resource view to apply to the returned intent.
IntentView intent_view = 4;
}
// The request message for [Intents.UpdateIntent][google.cloud.dialogflow.v2beta1.Intents.UpdateIntent].
message UpdateIntentRequest {
// Required. The intent to update.
Intent intent = 1 [(google.api.field_behavior) = REQUIRED];
// Optional. The language used to access language-specific data.
// If not specified, the agent's default language is used.
// For more information, see
// [Multilingual intent and entity
// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
// Optional. The mask to control which fields get updated.
google.protobuf.FieldMask update_mask = 3;
// Optional. The resource view to apply to the returned intent.
IntentView intent_view = 4;
}
// The request message for [Intents.DeleteIntent][google.cloud.dialogflow.v2beta1.Intents.DeleteIntent].
message DeleteIntentRequest {
// Required. The name of the intent to delete. If this intent has direct or
// indirect followup intents, we also delete them.
//
// Supported formats:
//
// - `projects/<Project ID>/agent/intents/<Intent ID>`
// - `projects/<Project ID>/locations/<Location ID>/agent/intents/<Intent ID>`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "dialogflow.googleapis.com/Intent"
}
];
}
// The request message for [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents].
message BatchUpdateIntentsRequest {
// Required. The name of the agent to update or create intents in.
// Supported formats:
//
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
child_type: "dialogflow.googleapis.com/Intent"
}
];
// Required. The source of the intent batch.
//
// For each intent in the batch:
//
// * If `name` is specified, we update an existing intent.
// * If `name` is not specified, we create a new intent.
oneof intent_batch {
// The URI to a Google Cloud Storage file containing intents to update or
// create. The file format can either be a serialized proto (of IntentBatch
// type) or JSON object. Note: The URI must start with "gs://".
string intent_batch_uri = 2;
// The collection of intents to update or create.
IntentBatch intent_batch_inline = 3;
}
// Optional. The language used to access language-specific data.
// If not specified, the agent's default language is used.
// For more information, see
// [Multilingual intent and entity
// data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
string language_code = 4 [(google.api.field_behavior) = OPTIONAL];
// Optional. The mask to control which fields get updated.
google.protobuf.FieldMask update_mask = 5;
// Optional. The resource view to apply to the returned intent.
IntentView intent_view = 6;
}
// The response message for [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents].
message BatchUpdateIntentsResponse {
// The collection of updated or created intents.
repeated Intent intents = 1;
}
// The request message for [Intents.BatchDeleteIntents][google.cloud.dialogflow.v2beta1.Intents.BatchDeleteIntents].
message BatchDeleteIntentsRequest {
// Required. The name of the agent to delete all entities types for.
// Supported formats:
//
// - `projects/<Project ID>/agent`
// - `projects/<Project ID>/locations/<Location ID>/agent`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
child_type: "dialogflow.googleapis.com/Intent"
}
];
// Required. The collection of intents to delete. Only intent `name` must be
// filled in.
repeated Intent intents = 2 [(google.api.field_behavior) = REQUIRED];
}
// This message is a wrapper around a collection of intents.
message IntentBatch {
// A collection of intents.
repeated Intent intents = 1;
}
// Represents the options for views of an intent.
// An intent can be a sizable object. Therefore, we provide a resource view that
// does not return training phrases in the response by default.
enum IntentView {
// Training phrases field is not populated in the response.
INTENT_VIEW_UNSPECIFIED = 0;
// All fields are populated.
INTENT_VIEW_FULL = 1;
}
Reference in New Issue View Git Blame Copy Permalink