Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 970c229

Browse files
committedMar 18, 2025
feat(dialogflow): update the api
#### dialogflow:v2 The following keys were added: - resources.projects.resources.conversations.resources.suggestions.methods.generate (Total Keys: 12) - resources.projects.resources.locations.resources.conversations.methods.ingestContextReferences (Total Keys: 12) - resources.projects.resources.locations.resources.conversations.resources.suggestions.methods.generate (Total Keys: 12) - schemas.GoogleCloudDialogflowV2Conversation.properties.ingestedContextReferences (Total Keys: 3) - schemas.GoogleCloudDialogflowV2ConversationContextReference (Total Keys: 16) - schemas.GoogleCloudDialogflowV2FreeFormContext (Total Keys: 3) - schemas.GoogleCloudDialogflowV2FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2GenerateStatelessSuggestionRequest.properties.contextReferences (Total Keys: 2) - schemas.GoogleCloudDialogflowV2GenerateSuggestionsRequest (Total Keys: 5) - schemas.GoogleCloudDialogflowV2GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2Generator.properties.freeFormContext.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2Generator.properties.publishedModel.type (Total Keys: 1) - schemas.GoogleCloudDialogflowV2GeneratorSuggestion.properties.freeFormSuggestion.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2IngestContextReferencesRequest (Total Keys: 4) - schemas.GoogleCloudDialogflowV2IngestContextReferencesResponse (Total Keys: 4) - schemas.GoogleCloudDialogflowV2SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2beta1FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2beta1GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2beta1GeneratorSuggestion (Total Keys: 4) - schemas.GoogleCloudDialogflowV2beta1SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2beta1SummarySuggestion (Total Keys: 8) #### dialogflow:v2beta1 The following keys were added: - resources.projects.resources.conversations.resources.suggestions.methods.generate (Total Keys: 12) - resources.projects.resources.locations.resources.conversations.methods.ingestContextReferences (Total Keys: 12) - resources.projects.resources.locations.resources.conversations.resources.suggestions.methods.generate (Total Keys: 12) - schemas.GoogleCloudDialogflowV2FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2GeneratorSuggestion (Total Keys: 4) - schemas.GoogleCloudDialogflowV2SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2SummarySuggestion (Total Keys: 8) - schemas.GoogleCloudDialogflowV2beta1Conversation.properties.ingestedContextReferences (Total Keys: 3) - schemas.GoogleCloudDialogflowV2beta1ConversationContextReference (Total Keys: 16) - schemas.GoogleCloudDialogflowV2beta1FreeFormContext (Total Keys: 3) - schemas.GoogleCloudDialogflowV2beta1FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2beta1GenerateStatelessSuggestionRequest.properties.contextReferences (Total Keys: 2) - schemas.GoogleCloudDialogflowV2beta1GenerateSuggestionsRequest (Total Keys: 5) - schemas.GoogleCloudDialogflowV2beta1GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2beta1Generator.properties.freeFormContext.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2beta1Generator.properties.publishedModel.type (Total Keys: 1) - schemas.GoogleCloudDialogflowV2beta1GeneratorSuggestion.properties.freeFormSuggestion.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2beta1IngestContextReferencesRequest (Total Keys: 4) - schemas.GoogleCloudDialogflowV2beta1IngestContextReferencesResponse (Total Keys: 4) - schemas.GoogleCloudDialogflowV2beta1SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) #### dialogflow:v3 The following keys were added: - schemas.GoogleCloudDialogflowV2FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2GeneratorSuggestion (Total Keys: 4) - schemas.GoogleCloudDialogflowV2SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2SummarySuggestion (Total Keys: 8) - schemas.GoogleCloudDialogflowV2beta1FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2beta1GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2beta1GeneratorSuggestion (Total Keys: 4) - schemas.GoogleCloudDialogflowV2beta1SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2beta1SummarySuggestion (Total Keys: 8) #### dialogflow:v3beta1 The following keys were added: - schemas.GoogleCloudDialogflowCxV3beta1Tool.properties.connectorSpec.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowCxV3beta1ToolConnectorTool (Total Keys: 18) - schemas.GoogleCloudDialogflowCxV3beta1ToolEndUserAuthConfig (Total Keys: 12) - schemas.GoogleCloudDialogflowV2FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2GeneratorSuggestion (Total Keys: 4) - schemas.GoogleCloudDialogflowV2SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2SummarySuggestion (Total Keys: 8) - schemas.GoogleCloudDialogflowV2beta1FreeFormSuggestion (Total Keys: 3) - schemas.GoogleCloudDialogflowV2beta1GenerateSuggestionsResponse (Total Keys: 10) - schemas.GoogleCloudDialogflowV2beta1GeneratorSuggestion (Total Keys: 4) - schemas.GoogleCloudDialogflowV2beta1SuggestionResult.properties.generateSuggestionsResponse.$ref (Total Keys: 1) - schemas.GoogleCloudDialogflowV2beta1SummarySuggestion (Total Keys: 8)
1 parent 2e47e19 commit 970c229

24 files changed

+2623
-28
lines changed
 

‎docs/dyn/dialogflow_v2.projects.conversations.html

+70
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,20 @@ <h3>Method Details</h3>
137137
&quot;conversationProfile&quot;: &quot;A String&quot;, # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`.
138138
&quot;conversationStage&quot;: &quot;A String&quot;, # Optional. The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE.
139139
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time the conversation was finished.
140+
&quot;ingestedContextReferences&quot;: { # Output only. The context reference updates provided by external systems.
141+
&quot;a_key&quot;: { # Represents a section of ingested context information.
142+
&quot;contextContents&quot;: [ # Required. The list of content updates for a context reference.
143+
{ # Contents ingested.
144+
&quot;content&quot;: &quot;A String&quot;, # Required. The information ingested in a single request.
145+
&quot;contentFormat&quot;: &quot;A String&quot;, # Required. The format of the ingested string.
146+
&quot;ingestionTime&quot;: &quot;A String&quot;, # Output only. The time when this information was incorporated into the relevant context reference.
147+
},
148+
],
149+
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the context reference was first created.
150+
&quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the information ingested, defaults to &quot;en-US&quot; if not set.
151+
&quot;updateMode&quot;: &quot;A String&quot;, # Required. The mode in which context reference contents are updated.
152+
},
153+
},
140154
&quot;lifecycleState&quot;: &quot;A String&quot;, # Output only. The current state of the Conversation.
141155
&quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The unique identifier of this conversation. Format: `projects//locations//conversations/`.
142156
&quot;phoneNumber&quot;: { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. It will not be empty if the conversation is to be connected over telephony.
@@ -176,6 +190,20 @@ <h3>Method Details</h3>
176190
&quot;conversationProfile&quot;: &quot;A String&quot;, # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`.
177191
&quot;conversationStage&quot;: &quot;A String&quot;, # Optional. The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE.
178192
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time the conversation was finished.
193+
&quot;ingestedContextReferences&quot;: { # Output only. The context reference updates provided by external systems.
194+
&quot;a_key&quot;: { # Represents a section of ingested context information.
195+
&quot;contextContents&quot;: [ # Required. The list of content updates for a context reference.
196+
{ # Contents ingested.
197+
&quot;content&quot;: &quot;A String&quot;, # Required. The information ingested in a single request.
198+
&quot;contentFormat&quot;: &quot;A String&quot;, # Required. The format of the ingested string.
199+
&quot;ingestionTime&quot;: &quot;A String&quot;, # Output only. The time when this information was incorporated into the relevant context reference.
200+
},
201+
],
202+
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the context reference was first created.
203+
&quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the information ingested, defaults to &quot;en-US&quot; if not set.
204+
&quot;updateMode&quot;: &quot;A String&quot;, # Required. The mode in which context reference contents are updated.
205+
},
206+
},
179207
&quot;lifecycleState&quot;: &quot;A String&quot;, # Output only. The current state of the Conversation.
180208
&quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The unique identifier of this conversation. Format: `projects//locations//conversations/`.
181209
&quot;phoneNumber&quot;: { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. It will not be empty if the conversation is to be connected over telephony.
@@ -214,6 +242,20 @@ <h3>Method Details</h3>
214242
&quot;conversationProfile&quot;: &quot;A String&quot;, # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`.
215243
&quot;conversationStage&quot;: &quot;A String&quot;, # Optional. The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE.
216244
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time the conversation was finished.
245+
&quot;ingestedContextReferences&quot;: { # Output only. The context reference updates provided by external systems.
246+
&quot;a_key&quot;: { # Represents a section of ingested context information.
247+
&quot;contextContents&quot;: [ # Required. The list of content updates for a context reference.
248+
{ # Contents ingested.
249+
&quot;content&quot;: &quot;A String&quot;, # Required. The information ingested in a single request.
250+
&quot;contentFormat&quot;: &quot;A String&quot;, # Required. The format of the ingested string.
251+
&quot;ingestionTime&quot;: &quot;A String&quot;, # Output only. The time when this information was incorporated into the relevant context reference.
252+
},
253+
],
254+
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the context reference was first created.
255+
&quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the information ingested, defaults to &quot;en-US&quot; if not set.
256+
&quot;updateMode&quot;: &quot;A String&quot;, # Required. The mode in which context reference contents are updated.
257+
},
258+
},
217259
&quot;lifecycleState&quot;: &quot;A String&quot;, # Output only. The current state of the Conversation.
218260
&quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The unique identifier of this conversation. Format: `projects//locations//conversations/`.
219261
&quot;phoneNumber&quot;: { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. It will not be empty if the conversation is to be connected over telephony.
@@ -258,6 +300,20 @@ <h3>Method Details</h3>
258300
&quot;conversationProfile&quot;: &quot;A String&quot;, # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`.
259301
&quot;conversationStage&quot;: &quot;A String&quot;, # Optional. The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE.
260302
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time the conversation was finished.
303+
&quot;ingestedContextReferences&quot;: { # Output only. The context reference updates provided by external systems.
304+
&quot;a_key&quot;: { # Represents a section of ingested context information.
305+
&quot;contextContents&quot;: [ # Required. The list of content updates for a context reference.
306+
{ # Contents ingested.
307+
&quot;content&quot;: &quot;A String&quot;, # Required. The information ingested in a single request.
308+
&quot;contentFormat&quot;: &quot;A String&quot;, # Required. The format of the ingested string.
309+
&quot;ingestionTime&quot;: &quot;A String&quot;, # Output only. The time when this information was incorporated into the relevant context reference.
310+
},
311+
],
312+
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the context reference was first created.
313+
&quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the information ingested, defaults to &quot;en-US&quot; if not set.
314+
&quot;updateMode&quot;: &quot;A String&quot;, # Required. The mode in which context reference contents are updated.
315+
},
316+
},
261317
&quot;lifecycleState&quot;: &quot;A String&quot;, # Output only. The current state of the Conversation.
262318
&quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The unique identifier of this conversation. Format: `projects//locations//conversations/`.
263319
&quot;phoneNumber&quot;: { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. It will not be empty if the conversation is to be connected over telephony.
@@ -307,6 +363,20 @@ <h3>Method Details</h3>
307363
&quot;conversationProfile&quot;: &quot;A String&quot;, # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`.
308364
&quot;conversationStage&quot;: &quot;A String&quot;, # Optional. The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE.
309365
&quot;endTime&quot;: &quot;A String&quot;, # Output only. The time the conversation was finished.
366+
&quot;ingestedContextReferences&quot;: { # Output only. The context reference updates provided by external systems.
367+
&quot;a_key&quot;: { # Represents a section of ingested context information.
368+
&quot;contextContents&quot;: [ # Required. The list of content updates for a context reference.
369+
{ # Contents ingested.
370+
&quot;content&quot;: &quot;A String&quot;, # Required. The information ingested in a single request.
371+
&quot;contentFormat&quot;: &quot;A String&quot;, # Required. The format of the ingested string.
372+
&quot;ingestionTime&quot;: &quot;A String&quot;, # Output only. The time when this information was incorporated into the relevant context reference.
373+
},
374+
],
375+
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time the context reference was first created.
376+
&quot;languageCode&quot;: &quot;A String&quot;, # Optional. The language of the information ingested, defaults to &quot;en-US&quot; if not set.
377+
&quot;updateMode&quot;: &quot;A String&quot;, # Required. The mode in which context reference contents are updated.
378+
},
379+
},
310380
&quot;lifecycleState&quot;: &quot;A String&quot;, # Output only. The current state of the Conversation.
311381
&quot;name&quot;: &quot;A String&quot;, # Output only. Identifier. The unique identifier of this conversation. Format: `projects//locations//conversations/`.
312382
&quot;phoneNumber&quot;: { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. It will not be empty if the conversation is to be connected over telephony.

‎docs/dyn/dialogflow_v2.projects.conversations.participants.html

+44
Original file line numberDiff line numberDiff line change
@@ -735,6 +735,28 @@ <h3>Method Details</h3>
735735
],
736736
&quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
737737
},
738+
&quot;generateSuggestionsResponse&quot;: { # The response message for Conversations.GenerateSuggestions. # Suggestions generated using generators triggered by customer or agent messages.
739+
&quot;generatorSuggestionAnswers&quot;: [ # The answers generated for the conversation based on context.
740+
{ # A GeneratorSuggestion answer.
741+
&quot;answerRecord&quot;: &quot;A String&quot;, # Answer record that uniquely identifies the suggestion. This can be used to provide suggestion feedback.
742+
&quot;generatorSuggestion&quot;: { # Suggestion generated using a Generator. # Suggestion details.
743+
&quot;freeFormSuggestion&quot;: { # Suggestion generated using free form generator. # Optional. Free form suggestion.
744+
&quot;response&quot;: &quot;A String&quot;, # Required. Free form suggestion.
745+
},
746+
&quot;summarySuggestion&quot;: { # Suggested summary of the conversation. # Optional. Suggested summary.
747+
&quot;summarySections&quot;: [ # Required. All the parts of generated summary.
748+
{ # A component of the generated summary.
749+
&quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
750+
&quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
751+
},
752+
],
753+
},
754+
},
755+
&quot;sourceGenerator&quot;: &quot;A String&quot;, # The name of the generator used to generate this suggestion. Format: `projects//locations//generators/`.
756+
},
757+
],
758+
&quot;latestMessage&quot;: &quot;A String&quot;, # The name of the latest conversation message used as context for compiling suggestion. Format: `projects//locations//conversations//messages/`.
759+
},
738760
&quot;suggestArticlesResponse&quot;: { # The response message for Participants.SuggestArticles. # SuggestArticlesResponse if request is for ARTICLE_SUGGESTION.
739761
&quot;articleAnswers&quot;: [ # Articles ordered by score in descending order.
740762
{ # Represents article answer.
@@ -821,6 +843,28 @@ <h3>Method Details</h3>
821843
],
822844
&quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
823845
},
846+
&quot;generateSuggestionsResponse&quot;: { # The response message for Conversations.GenerateSuggestions. # Suggestions generated using generators triggered by customer or agent messages.
847+
&quot;generatorSuggestionAnswers&quot;: [ # The answers generated for the conversation based on context.
848+
{ # A GeneratorSuggestion answer.
849+
&quot;answerRecord&quot;: &quot;A String&quot;, # Answer record that uniquely identifies the suggestion. This can be used to provide suggestion feedback.
850+
&quot;generatorSuggestion&quot;: { # Suggestion generated using a Generator. # Suggestion details.
851+
&quot;freeFormSuggestion&quot;: { # Suggestion generated using free form generator. # Optional. Free form suggestion.
852+
&quot;response&quot;: &quot;A String&quot;, # Required. Free form suggestion.
853+
},
854+
&quot;summarySuggestion&quot;: { # Suggested summary of the conversation. # Optional. Suggested summary.
855+
&quot;summarySections&quot;: [ # Required. All the parts of generated summary.
856+
{ # A component of the generated summary.
857+
&quot;section&quot;: &quot;A String&quot;, # Required. Name of the section.
858+
&quot;summary&quot;: &quot;A String&quot;, # Required. Summary text for the section.
859+
},
860+
],
861+
},
862+
},
863+
&quot;sourceGenerator&quot;: &quot;A String&quot;, # The name of the generator used to generate this suggestion. Format: `projects//locations//generators/`.
864+
},
865+
],
866+
&quot;latestMessage&quot;: &quot;A String&quot;, # The name of the latest conversation message used as context for compiling suggestion. Format: `projects//locations//conversations//messages/`.
867+
},
824868
&quot;suggestArticlesResponse&quot;: { # The response message for Participants.SuggestArticles. # SuggestArticlesResponse if request is for ARTICLE_SUGGESTION.
825869
&quot;articleAnswers&quot;: [ # Articles ordered by score in descending order.
826870
{ # Represents article answer.

0 commit comments

Comments
 (0)
Please sign in to comment.