From 78dc641b2d05b36f6bb08d90773236004905e55f Mon Sep 17 00:00:00 2001 From: Google APIs Date: Thu, 13 Jun 2019 07:20:20 -0700 Subject: [PATCH] Synchronize new proto/yaml changes. PiperOrigin-RevId: 253022966 --- google/cloud/dialogflow/v2/agent.proto | 86 ++++++++++- google/cloud/dialogflow/v2/audio_config.proto | 133 +++++++++--------- google/cloud/dialogflow/v2/context.proto | 10 +- google/cloud/dialogflow/v2/entity_type.proto | 24 ++-- google/cloud/dialogflow/v2/intent.proto | 19 ++- google/cloud/dialogflow/v2/session.proto | 36 +++-- .../dialogflow/v2/session_entity_type.proto | 8 +- 7 files changed, 214 insertions(+), 102 deletions(-) diff --git a/google/cloud/dialogflow/v2/agent.proto b/google/cloud/dialogflow/v2/agent.proto index f6ad5637..5815800a 100644 --- a/google/cloud/dialogflow/v2/agent.proto +++ b/google/cloud/dialogflow/v2/agent.proto @@ -22,6 +22,7 @@ import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/struct.proto"; +import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -44,7 +45,7 @@ option objc_class_prefix = "DF"; // You can create an agent using both Dialogflow Standard Edition and // Dialogflow Enterprise Edition. For details, see // [Dialogflow -// Editions](https://cloud.google.com/dialogflow-enterprise/docs/editions). +// Editions](https://cloud.google.com/dialogflow/docs/editions). // // You can save your agent for backup or versioning by exporting the agent by // using the [ExportAgent][google.cloud.dialogflow.v2.Agents.ExportAgent] method. You can import a saved @@ -52,14 +53,19 @@ option objc_class_prefix = "DF"; // // Dialogflow provides several // [prebuilt -// agents](https://cloud.google.com/dialogflow-enterprise/docs/agents-prebuilt) +// agents](https://cloud.google.com/dialogflow/docs/agents-prebuilt) // for common conversation scenarios such as determining a date and time, // converting currency, and so on. // // For more information about agents, see the // [Dialogflow -// documentation](https://cloud.google.com/dialogflow-enterprise/docs/agents-overview). +// documentation](https://cloud.google.com/dialogflow/docs/agents-overview). service Agents { + 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"; + // Retrieves the specified agent. rpc GetAgent(GetAgentRequest) returns (Agent) { option (google.api.http) = { @@ -67,6 +73,21 @@ service Agents { }; } + // Creates/updates the specified agent. + rpc SetAgent(SetAgentRequest) returns (Agent) { + option (google.api.http) = { + post: "/v2/{agent.parent=projects/*}/agent" + body: "agent" + }; + } + + // Deletes the specified agent. + rpc DeleteAgent(DeleteAgentRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v2/{parent=projects/*}/agent" + }; + } + // Returns the list of agents. // // Since there is at most one conversational agent per project, this method is @@ -144,6 +165,36 @@ message Agent { MATCH_MODE_ML_ONLY = 2; } + // API version for the agent. + enum ApiVersion { + // Not specified. + API_VERSION_UNSPECIFIED = 0; + + // Legacy V1 API. + API_VERSION_V1 = 1; + + // V2 API. + API_VERSION_V2 = 2; + + // V2beta1 API. + API_VERSION_V2_BETA_1 = 3; + } + + // Represents the agent tier. + enum Tier { + // Not specified. This value should never be used. + TIER_UNSPECIFIED = 0; + + // Standard tier. + TIER_STANDARD = 1; + + // Enterprise tier (Essentials). + TIER_ENTERPRISE = 2; + + // Enterprise tier (Plus). + TIER_ENTERPRISE_PLUS = 3; + } + // Required. The project of this agent. // Format: `projects/`. string parent = 1; @@ -153,7 +204,7 @@ message Agent { // Required. The default language of the agent as a language tag. See // [Language - // Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // Support](https://cloud.google.com/dialogflow/docs/reference/language) // for a list of the currently supported language codes. This field cannot be // set by the `Update` method. string default_language_code = 3; @@ -174,7 +225,7 @@ message Agent { // Optional. The URI of the agent's avatar. // Avatars are used throughout the Dialogflow console and in the self-hosted // [Web - // Demo](https://cloud.google.com/dialogflow-enterprise/docs/integrations/web-demo) + // Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo) // integration. string avatar_uri = 7; @@ -192,6 +243,15 @@ message Agent { // values range from 0.0 (completely uncertain) to 1.0 (completely certain). // If set to 0.0, the default of 0.3 is used. float classification_threshold = 10; + + // Optional. API version displayed in Dialogflow console. If not specified, + // V2 API is assumed. Clients are free to query different service endpoints + // for different API versions. However, bots connectors and webhook calls will + // follow the specified API version. + ApiVersion api_version = 14; + + // Optional. The agent tier. If not specified, TIER_STANDARD is assumed. + Tier tier = 15; } // The request message for [Agents.GetAgent][google.cloud.dialogflow.v2.Agents.GetAgent]. @@ -201,6 +261,22 @@ message GetAgentRequest { string parent = 1; } +// The request message for [Agents.SetAgent][google.cloud.dialogflow.v2.Agents.SetAgent]. +message SetAgentRequest { + // Required. The agent to update. + Agent agent = 1; + + // Optional. The mask to control which fields get updated. + google.protobuf.FieldMask update_mask = 2; +} + +// The request message for [Agents.DeleteAgent][google.cloud.dialogflow.v2.Agents.DeleteAgent]. +message DeleteAgentRequest { + // Required. The project that the agent to delete is associated with. + // Format: `projects/`. + string parent = 1; +} + // The request message for [Agents.SearchAgents][google.cloud.dialogflow.v2.Agents.SearchAgents]. message SearchAgentsRequest { // Required. The project to list agents from. diff --git a/google/cloud/dialogflow/v2/audio_config.proto b/google/cloud/dialogflow/v2/audio_config.proto index 800e5c6a..22e2dc8d 100644 --- a/google/cloud/dialogflow/v2/audio_config.proto +++ b/google/cloud/dialogflow/v2/audio_config.proto @@ -17,6 +17,7 @@ syntax = "proto3"; package google.cloud.dialogflow.v2; +import "google/protobuf/duration.proto"; import "google/api/annotations.proto"; option cc_enable_arenas = true; @@ -76,6 +77,37 @@ enum AudioEncoding { AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE = 7; } +// Instructs the speech recognizer how to process the audio content. +message InputAudioConfig { + // Required. Audio encoding of the audio content to process. + AudioEncoding audio_encoding = 1; + + // Required. Sample rate (in Hertz) of the audio content sent in the query. + // Refer to + // [Cloud Speech API + // documentation](https://cloud.google.com/speech-to-text/docs/basics) for + // more details. + int32 sample_rate_hertz = 2; + + // Required. The language of the supplied audio. Dialogflow does not do + // translations. See [Language + // Support](https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that queries in + // the same session do not necessarily need to specify the same language. + string language_code = 3; + + // Optional. A list of strings containing words and phrases that the speech + // recognizer should recognize with higher likelihood. + // + // See [the Cloud Speech + // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. + repeated string phrase_hints = 4; + + // Optional. Which variant of the [Speech model][google.cloud.dialogflow.v2.InputAudioConfig.model] to use. + SpeechModelVariant model_variant = 10; +} + // Variant of the specified [Speech model][google.cloud.dialogflow.v2.InputAudioConfig.model] to use. // // See the [Cloud Speech @@ -92,7 +124,7 @@ enum SpeechModelVariant { // model][InputAudioConfig.model] that the caller is eligible for. // // Please see the [Dialogflow - // docs](https://cloud.google.com/dialogflow-enterprise/docs/data-logging) for + // docs](https://cloud.google.com/dialogflow/docs/data-logging) for // how to make your project eligible for enhanced models. USE_BEST_AVAILABLE = 1; @@ -114,59 +146,11 @@ enum SpeechModelVariant { // // * If the API caller isn't eligible for enhanced models, Dialogflow returns // an error. Please see the [Dialogflow - // docs](https://cloud.google.com/dialogflow-enterprise/docs/data-logging) + // docs](https://cloud.google.com/dialogflow/docs/data-logging) // for how to make your project eligible. USE_ENHANCED = 3; } -// Instructs the speech recognizer how to process the audio content. -message InputAudioConfig { - // Required. Audio encoding of the audio content to process. - AudioEncoding audio_encoding = 1; - - // Required. Sample rate (in Hertz) of the audio content sent in the query. - // Refer to - // [Cloud Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics) for - // more details. - int32 sample_rate_hertz = 2; - - // Required. The language of the supplied audio. Dialogflow does not do - // translations. See [Language - // Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) - // for a list of the currently supported language codes. Note that queries in - // the same session do not necessarily need to specify the same language. - string language_code = 3; - - // Optional. The collection of phrase hints which are used to boost accuracy - // of speech recognition. - // Refer to - // [Cloud Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) - // for more details. - repeated string phrase_hints = 4; - - // Optional. Which variant of the [Speech model][google.cloud.dialogflow.v2.InputAudioConfig.model] to use. - SpeechModelVariant model_variant = 10; -} - -// Gender of the voice as described in -// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice). -enum SsmlVoiceGender { - // An unspecified gender, which means that the client doesn't care which - // gender the selected voice will have. - SSML_VOICE_GENDER_UNSPECIFIED = 0; - - // A male voice. - SSML_VOICE_GENDER_MALE = 1; - - // A female voice. - SSML_VOICE_GENDER_FEMALE = 2; - - // A gender-neutral voice. - SSML_VOICE_GENDER_NEUTRAL = 3; -} - // Description of which voice to use for speech synthesis. message VoiceSelectionParams { // Optional. The name of the voice. If not set, the service will choose a @@ -213,6 +197,39 @@ message SynthesizeSpeechConfig { VoiceSelectionParams voice = 4; } +// Gender of the voice as described in +// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice). +enum SsmlVoiceGender { + // An unspecified gender, which means that the client doesn't care which + // gender the selected voice will have. + SSML_VOICE_GENDER_UNSPECIFIED = 0; + + // A male voice. + SSML_VOICE_GENDER_MALE = 1; + + // A female voice. + SSML_VOICE_GENDER_FEMALE = 2; + + // A gender-neutral voice. + SSML_VOICE_GENDER_NEUTRAL = 3; +} + +// Instructs the speech synthesizer on how to generate the output audio content. +message OutputAudioConfig { + // Required. Audio encoding of the synthesized audio content. + OutputAudioEncoding audio_encoding = 1; + + // Optional. The synthesis sample rate (in hertz) for this audio. If not + // provided, then the synthesizer will use the default sample rate based on + // the audio encoding. If this is different from the voice's natural sample + // rate, then the synthesizer will honor this request by converting to the + // desired sample rate (which might result in worse audio quality). + int32 sample_rate_hertz = 2; + + // Optional. Configuration of how speech should be synthesized. + SynthesizeSpeechConfig synthesize_speech_config = 3; +} + // Audio encoding of the output audio format in Text-To-Speech. enum OutputAudioEncoding { // Not specified. @@ -231,19 +248,3 @@ enum OutputAudioEncoding { // than MP3 while using approximately the same bitrate. OUTPUT_AUDIO_ENCODING_OGG_OPUS = 3; } - -// Instructs the speech synthesizer on how to generate the output audio content. -message OutputAudioConfig { - // Required. Audio encoding of the synthesized audio content. - OutputAudioEncoding audio_encoding = 1; - - // Optional. The synthesis sample rate (in hertz) for this audio. If not - // provided, then the synthesizer will use the default sample rate based on - // the audio encoding. If this is different from the voice's natural sample - // rate, then the synthesizer will honor this request by converting to the - // desired sample rate (which might result in worse audio quality). - int32 sample_rate_hertz = 2; - - // Optional. Configuration of how speech should be synthesized. - SynthesizeSpeechConfig synthesize_speech_config = 3; -} diff --git a/google/cloud/dialogflow/v2/context.proto b/google/cloud/dialogflow/v2/context.proto index 83502b2f..1df6f769 100644 --- a/google/cloud/dialogflow/v2/context.proto +++ b/google/cloud/dialogflow/v2/context.proto @@ -21,6 +21,7 @@ import "google/api/annotations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/struct.proto"; +import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -47,8 +48,13 @@ option objc_class_prefix = "DF"; // // For more information about contexts, see the // [Dialogflow -// documentation](https://cloud.google.com/dialogflow-enterprise/docs/contexts-overview). +// documentation](https://cloud.google.com/dialogflow/docs/contexts-overview). service Contexts { + 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 contexts in the specified session. rpc ListContexts(ListContextsRequest) returns (ListContextsResponse) { option (google.api.http) = { @@ -113,7 +119,7 @@ message Context { // Optional. The collection of parameters associated with this context. // Refer to [this - // doc](https://cloud.google.com/dialogflow-enterprise/docs/intents-actions-parameters) + // doc](https://cloud.google.com/dialogflow/docs/intents-actions-parameters) // for syntax. google.protobuf.Struct parameters = 3; } diff --git a/google/cloud/dialogflow/v2/entity_type.proto b/google/cloud/dialogflow/v2/entity_type.proto index b216fa4a..265fdcdb 100644 --- a/google/cloud/dialogflow/v2/entity_type.proto +++ b/google/cloud/dialogflow/v2/entity_type.proto @@ -22,6 +22,7 @@ import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/struct.proto"; +import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -58,8 +59,13 @@ option objc_class_prefix = "DF"; // // For more information about entity types, see the // [Dialogflow -// documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview). +// documentation](https://cloud.google.com/dialogflow/docs/entities-overview). service EntityTypes { + 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 entity types in the specified agent. rpc ListEntityTypes(ListEntityTypesRequest) returns (ListEntityTypesResponse) { option (google.api.http) = { @@ -236,7 +242,7 @@ message ListEntityTypesRequest { // Optional. The language to list entity synonyms for. If not specified, // the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 2; @@ -269,7 +275,7 @@ message GetEntityTypeRequest { // Optional. The language to retrieve entity synonyms for. If not specified, // the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 2; @@ -287,7 +293,7 @@ message CreateEntityTypeRequest { // Optional. The language of entity synonyms defined in `entity_type`. If not // specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 3; @@ -301,7 +307,7 @@ message UpdateEntityTypeRequest { // Optional. The language of entity synonyms defined in `entity_type`. If not // specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 2; @@ -343,7 +349,7 @@ message BatchUpdateEntityTypesRequest { // Optional. The language of entity synonyms defined in `entity_types`. If not // specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 4; @@ -381,7 +387,7 @@ message BatchCreateEntitiesRequest { // Optional. The language of entity synonyms defined in `entities`. If not // specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 3; @@ -399,7 +405,7 @@ message BatchUpdateEntitiesRequest { // Optional. The language of entity synonyms defined in `entities`. If not // specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 3; @@ -422,7 +428,7 @@ message BatchDeleteEntitiesRequest { // Optional. The language of entity synonyms defined in `entities`. If not // specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 3; diff --git a/google/cloud/dialogflow/v2/intent.proto b/google/cloud/dialogflow/v2/intent.proto index 0a6ea273..11fbef37 100644 --- a/google/cloud/dialogflow/v2/intent.proto +++ b/google/cloud/dialogflow/v2/intent.proto @@ -18,12 +18,14 @@ syntax = "proto3"; package google.cloud.dialogflow.v2; import "google/api/annotations.proto"; +import "google/cloud/dialogflow/v2/audio_config.proto"; import "google/cloud/dialogflow/v2/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"; +import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -64,8 +66,13 @@ option objc_class_prefix = "DF"; // // For more information about intents, see the // [Dialogflow -// documentation](https://cloud.google.com/dialogflow-enterprise/docs/intents-overview). +// documentation](https://cloud.google.com/dialogflow/docs/intents-overview). 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) = { @@ -689,7 +696,7 @@ message ListIntentsRequest { // Optional. The language to list training phrases, parameters and rich // messages for. If not specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 2; @@ -725,7 +732,7 @@ message GetIntentRequest { // Optional. The language to retrieve training phrases, parameters and rich // messages for. If not specified, the agent's default language is used. // [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 2; @@ -746,7 +753,7 @@ message CreateIntentRequest { // Optional. The language of training phrases, parameters and rich messages // defined in `intent`. If not specified, the agent's default language is // used. [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 3; @@ -763,7 +770,7 @@ message UpdateIntentRequest { // Optional. The language of training phrases, parameters and rich messages // defined in `intent`. If not specified, the agent's default language is // used. [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 2; @@ -803,7 +810,7 @@ message BatchUpdateIntentsRequest { // Optional. The language of training phrases, parameters and rich messages // defined in `intents`. If not specified, the agent's default language is // used. [Many - // languages](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // languages](https://cloud.google.com/dialogflow/docs/reference/language) // are supported. Note: languages must be enabled in the agent before they can // be used. string language_code = 4; diff --git a/google/cloud/dialogflow/v2/session.proto b/google/cloud/dialogflow/v2/session.proto index 8026a6d6..84bbc2c5 100644 --- a/google/cloud/dialogflow/v2/session.proto +++ b/google/cloud/dialogflow/v2/session.proto @@ -22,9 +22,11 @@ import "google/cloud/dialogflow/v2/audio_config.proto"; import "google/cloud/dialogflow/v2/context.proto"; import "google/cloud/dialogflow/v2/intent.proto"; import "google/cloud/dialogflow/v2/session_entity_type.proto"; +import "google/protobuf/duration.proto"; import "google/protobuf/struct.proto"; import "google/rpc/status.proto"; import "google/type/latlng.proto"; +import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -39,6 +41,11 @@ option objc_class_prefix = "DF"; // [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) method to determine // user intent and respond. service Sessions { + 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"; + // Processes a natural language query and returns structured, actionable data // as a result. This method is not idempotent, because it may cause contexts // and session entity types to be updated, which in turn might affect @@ -185,7 +192,7 @@ message QueryResult { // The language that was triggered during intent detection. // See [Language - // Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // Support](https://cloud.google.com/dialogflow/docs/reference/language) // for a list of the currently supported language codes. string language_code = 15; @@ -270,7 +277,7 @@ message QueryResult { message StreamingDetectIntentRequest { // Required. The name of the session the query is sent to. // Format of the session name: - // `projects//agent/sessions/`. It’s up to the API + // `projects//agent/sessions/`. It's up to the API // caller to choose an appropriate `Session ID`. It can be a random number or // some type of user identifier (preferably hashed). The length of the session // ID must not exceed 36 characters. @@ -337,11 +344,14 @@ message StreamingDetectIntentResponse { google.rpc.Status webhook_status = 4; // The audio data bytes encoded as specified in the request. + // Note: The output audio is generated based on the values of default platform + // text responses found in the `query_result.fulfillment_messages` field. If + // multiple default text responses exist, they will be concatenated when + // generating audio. If no default platform text responses exist, the + // generated audio content will be empty. bytes output_audio = 5; - // Instructs the speech synthesizer how to generate the output audio. This - // field is populated from the agent-level speech synthesizer configuration, - // if enabled. + // The config used by the speech synthesizer to generate the output audio. OutputAudioConfig output_audio_config = 6; } @@ -388,12 +398,12 @@ message StreamingRecognitionResult { TRANSCRIPT = 1; // Event indicates that the server has detected the end of the user's speech - // utterance and expects no additional speech. Therefore, the server will - // not process additional audio (although it may subsequently return - // additional results). The client should stop sending additional audio - // data, half-close the gRPC connection, and wait for any additional results - // until the server closes the gRPC connection. This message is only sent if - // `single_utterance` was set to `true`, and is not used otherwise. + // utterance and expects no additional inputs. + // Therefore, the server will not process additional audio (although it may subsequently return additional results). The + // client should stop sending additional audio data, half-close the gRPC + // connection, and wait for any additional results until the server closes + // the gRPC connection. This message is only sent if `single_utterance` was + // set to `true`, and is not used otherwise. END_OF_SINGLE_UTTERANCE = 2; } @@ -427,7 +437,7 @@ message TextInput { string text = 1; // Required. The language of this conversational query. See [Language - // Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // Support](https://cloud.google.com/dialogflow/docs/reference/language) // for a list of the currently supported language codes. Note that queries in // the same session do not necessarily need to specify the same language. string language_code = 2; @@ -446,7 +456,7 @@ message EventInput { google.protobuf.Struct parameters = 2; // Required. The language of this query. See [Language - // Support](https://cloud.google.com/dialogflow-enterprise/docs/reference/language) + // Support](https://cloud.google.com/dialogflow/docs/reference/language) // for a list of the currently supported language codes. Note that queries in // the same session do not necessarily need to specify the same language. string language_code = 3; diff --git a/google/cloud/dialogflow/v2/session_entity_type.proto b/google/cloud/dialogflow/v2/session_entity_type.proto index b72ce691..8714152a 100644 --- a/google/cloud/dialogflow/v2/session_entity_type.proto +++ b/google/cloud/dialogflow/v2/session_entity_type.proto @@ -21,6 +21,7 @@ import "google/api/annotations.proto"; import "google/cloud/dialogflow/v2/entity_type.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; +import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -42,8 +43,13 @@ option objc_class_prefix = "DF"; // // For more information about entity types, see the // [Dialogflow -// documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview). +// documentation](https://cloud.google.com/dialogflow/docs/entities-overview). service SessionEntityTypes { + 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 session entity types in the specified session. rpc ListSessionEntityTypes(ListSessionEntityTypesRequest) returns (ListSessionEntityTypesResponse) { option (google.api.http) = {