From 8ab67e8018ea8f655ab47cabc2c7dd443ac2ee60 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Sat, 25 Jul 2020 00:08:49 +0000 Subject: [PATCH] feat(all): auto-regenerate .pb.go files This is an auto-generated regeneration of the .pb.go files by cloud.google.com/go/internal/gapicgen. Once this PR is submitted, genbot will update the corresponding PR to depend on the newer version of go-genproto, and assign reviewers. Whilst this or any regen PR is open in go-genproto, genbot will not create any more regeneration PRs. If all regen PRs are closed, gapicgen will create a new set of regeneration PRs once per night. If you have been assigned to review this PR, please: - Ensure that CI is passing. If it's failing, it requires your manual attention. - Approve and submit this PR if you believe it's ready to ship. That will prompt genbot to assign reviewers to the google-cloud-go PR. --- googleapis/cloud/dialogflow/v2/agent.pb.go | 3 +-- googleapis/cloud/dialogflow/v2/context.pb.go | 16 +++++++++++++++- .../cloud/dialogflow/v2/entity_type.pb.go | 15 ++++++++++++--- .../cloud/dialogflow/v2/environment.pb.go | 19 ++++++++++++++++++- googleapis/cloud/dialogflow/v2/intent.pb.go | 12 +++++++++--- googleapis/cloud/dialogflow/v2/session.pb.go | 18 ++++++++++++++++-- .../dialogflow/v2/session_entity_type.pb.go | 13 +++++++------ 7 files changed, 78 insertions(+), 18 deletions(-) diff --git a/googleapis/cloud/dialogflow/v2/agent.pb.go b/googleapis/cloud/dialogflow/v2/agent.pb.go index cdec99b63..c24b0ed50 100644 --- a/googleapis/cloud/dialogflow/v2/agent.pb.go +++ b/googleapis/cloud/dialogflow/v2/agent.pb.go @@ -225,8 +225,7 @@ func (Agent_Tier) EnumDescriptor() ([]byte, []int) { // conversations required for your system. // // For more information about agents, see the -// [Agents -// documentation](https://cloud.google.com/dialogflow/docs/agents-overview). +// [Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview). type Agent struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache diff --git a/googleapis/cloud/dialogflow/v2/context.pb.go b/googleapis/cloud/dialogflow/v2/context.pb.go index c6b2b468f..a0fd07ab6 100644 --- a/googleapis/cloud/dialogflow/v2/context.pb.go +++ b/googleapis/cloud/dialogflow/v2/context.pb.go @@ -48,7 +48,21 @@ const ( // of the legacy proto package is being used. const _ = proto.ProtoPackageIsVersion4 -// Represents a context. +// Dialogflow contexts are similar to natural language context. If a person says +// to you "they are orange", you need context in order to understand what "they" +// is referring to. Similarly, for Dialogflow to handle an end-user expression +// like that, it needs to be provided with context in order to correctly match +// an intent. +// +// Using contexts, you can control the flow of a conversation. You can configure +// contexts for an intent by setting input and output contexts, which are +// identified by string names. When an intent is matched, any configured output +// contexts for that intent become active. While any contexts are active, +// Dialogflow is more likely to match intents that are configured with input +// contexts that correspond to the currently active contexts. +// +// For more information about context, see the +// [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview). type Context struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache diff --git a/googleapis/cloud/dialogflow/v2/entity_type.pb.go b/googleapis/cloud/dialogflow/v2/entity_type.pb.go index ccafdd150..b2329ddbf 100644 --- a/googleapis/cloud/dialogflow/v2/entity_type.pb.go +++ b/googleapis/cloud/dialogflow/v2/entity_type.pb.go @@ -161,9 +161,18 @@ func (EntityType_AutoExpansionMode) EnumDescriptor() ([]byte, []int) { return file_google_cloud_dialogflow_v2_entity_type_proto_rawDescGZIP(), []int{0, 1} } -// Represents an entity type. -// Entity types serve as a tool for extracting parameter values from natural -// language queries. +// Each intent parameter has a type, called the entity type, which dictates +// exactly how data from an end-user expression is extracted. +// +// Dialogflow provides predefined system entities that can match many common +// types of data. For example, there are system entities for matching dates, +// times, colors, email addresses, and so on. You can also create your own +// custom entities for matching custom data. For example, you could define a +// vegetable entity that can match the types of vegetables available for +// purchase with a grocery store agent. +// +// For more information, see the +// [Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview). type EntityType struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache diff --git a/googleapis/cloud/dialogflow/v2/environment.pb.go b/googleapis/cloud/dialogflow/v2/environment.pb.go index 149f603ec..7f175ce29 100644 --- a/googleapis/cloud/dialogflow/v2/environment.pb.go +++ b/googleapis/cloud/dialogflow/v2/environment.pb.go @@ -109,7 +109,24 @@ func (Environment_State) EnumDescriptor() ([]byte, []int) { return file_google_cloud_dialogflow_v2_environment_proto_rawDescGZIP(), []int{0, 0} } -// Represents an agent environment. +// You can create multiple versions of your agent and publish them to separate +// environments. +// +// When you edit an agent, you are editing the draft agent. At any point, you +// can save the draft agent as an agent version, which is an immutable snapshot +// of your agent. +// +// When you save the draft agent, it is published to the default environment. +// When you create agent versions, you can publish them to custom environments. +// You can create a variety of custom environments for: +// +// - testing +// - development +// - production +// - etc. +// +// For more information, see the [versions and environments +// guide](https://cloud.google.com/dialogflow/docs/agents-versions). type Environment struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache diff --git a/googleapis/cloud/dialogflow/v2/intent.pb.go b/googleapis/cloud/dialogflow/v2/intent.pb.go index 7cfb5ab69..bda75097e 100644 --- a/googleapis/cloud/dialogflow/v2/intent.pb.go +++ b/googleapis/cloud/dialogflow/v2/intent.pb.go @@ -532,9 +532,15 @@ func (Intent_Message_ColumnProperties_HorizontalAlignment) EnumDescriptor() ([]b return file_google_cloud_dialogflow_v2_intent_proto_rawDescGZIP(), []int{0, 2, 16, 0} } -// Represents an intent. -// Intents convert a number of user expressions or patterns into an action. An -// action is an extraction of a user command or sentence semantics. +// 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). type Intent struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache diff --git a/googleapis/cloud/dialogflow/v2/session.pb.go b/googleapis/cloud/dialogflow/v2/session.pb.go index 4f6ea3405..28e80d89a 100644 --- a/googleapis/cloud/dialogflow/v2/session.pb.go +++ b/googleapis/cloud/dialogflow/v2/session.pb.go @@ -124,6 +124,9 @@ type DetectIntentRequest struct { // `User Id`. They can be a random number or some type of user and session // identifiers (preferably hashed). The length of the `Session ID` and // `User ID` must not exceed 36 characters. + // + // For more information, see the [API interactions + // guide](https://cloud.google.com/dialogflow/docs/api-overview). Session string `protobuf:"bytes,1,opt,name=session,proto3" json:"session,omitempty"` // The parameters of this query. QueryParams *QueryParameters `protobuf:"bytes,2,opt,name=query_params,json=queryParams,proto3" json:"query_params,omitempty"` @@ -825,6 +828,9 @@ type StreamingDetectIntentRequest struct { // `User Id`. They can be a random number or some type of user and session // identifiers (preferably hashed). The length of the `Session ID` and // `User ID` must not exceed 36 characters. + // + // For more information, see the [API interactions + // guide](https://cloud.google.com/dialogflow/docs/api-overview). Session string `protobuf:"bytes,1,opt,name=session,proto3" json:"session,omitempty"` // The parameters of this query. QueryParams *QueryParameters `protobuf:"bytes,2,opt,name=query_params,json=queryParams,proto3" json:"query_params,omitempty"` @@ -1402,8 +1408,16 @@ func (x *SentimentAnalysisRequestConfig) GetAnalyzeQueryTextSentiment() bool { return false } -// The result of sentiment analysis as configured by -// `sentiment_analysis_request_config`. +// The result of sentiment analysis. Sentiment analysis inspects user input +// and identifies the prevailing subjective opinion, especially to determine a +// user's attitude as positive, negative, or neutral. +// For [Participants.AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent], it needs to be configured in +// [DetectIntentRequest.query_params][google.cloud.dialogflow.v2.DetectIntentRequest.query_params]. For +// [Participants.StreamingAnalyzeContent][google.cloud.dialogflow.v2.Participants.StreamingAnalyzeContent], it needs to be configured in +// [StreamingDetectIntentRequest.query_params][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.query_params]. +// And for [Participants.AnalyzeContent][google.cloud.dialogflow.v2.Participants.AnalyzeContent] and +// [Participants.StreamingAnalyzeContent][google.cloud.dialogflow.v2.Participants.StreamingAnalyzeContent], it needs to be configured in +// [ConversationProfile.human_agent_assistant_config][google.cloud.dialogflow.v2.ConversationProfile.human_agent_assistant_config] type SentimentAnalysisResult struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache diff --git a/googleapis/cloud/dialogflow/v2/session_entity_type.pb.go b/googleapis/cloud/dialogflow/v2/session_entity_type.pb.go index eec4db1ab..54a55c7db 100644 --- a/googleapis/cloud/dialogflow/v2/session_entity_type.pb.go +++ b/googleapis/cloud/dialogflow/v2/session_entity_type.pb.go @@ -109,13 +109,14 @@ func (SessionEntityType_EntityOverrideMode) EnumDescriptor() ([]byte, []int) { return file_google_cloud_dialogflow_v2_session_entity_type_proto_rawDescGZIP(), []int{0, 0} } -// Represents a session entity type. +// A session represents a conversation between a Dialogflow agent and an +// end-user. You can create special entities, called session entities, during a +// session. Session entities can extend or replace custom entity types and only +// exist during the session that they were created for. All session data, +// including session entities, is stored by Dialogflow for 20 minutes. // -// Extends or replaces a custom entity type at the user session level (we -// refer to the entity types defined at the agent level as "custom entity -// types"). -// -// Note: session entity types apply to all queries, regardless of the language. +// For more information, see the [session entity +// guide](https://cloud.google.com/dialogflow/docs/entities-session). type SessionEntityType struct { state protoimpl.MessageState sizeCache protoimpl.SizeCache