docs: update generated docs (#981)
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html
index 4758ddf..58113a7 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.contexts.html
@@ -84,7 +84,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves the specified context.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Returns the list of all contexts in the specified session.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -109,7 +109,38 @@
body: object, The request body.
The object takes the form of:
-{ # 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).
+ "parameters": { # Optional. The collection of parameters associated with this context.
+ #
+ # Depending on your protocol or client library language, this is a
+ # map, associative array, symbol table, dictionary, or JSON object
+ # composed of a collection of (MapKey, MapValue) pairs:
+ #
+ # - MapKey type: string
+ # - MapKey value: parameter name
+ # - MapValue type:
+ # - If parameter's entity type is a composite entity: map
+ # - Else: string or number, depending on parameter value type
+ # - MapValue value:
+ # - If parameter's entity type is a composite entity:
+ # map from composite entity property names to property values
+ # - Else: parameter value
+ "a_key": "", # Properties of the object.
+ },
"lifespanCount": 42, # Optional. The number of conversational query requests after which the
# context expires. The default is `0`. If set to `0`, the context expires
# immediately. Contexts expire automatically after 20 minutes if there
@@ -131,23 +162,6 @@
# * `__system_counters__`
# * `*_id_dialog_context`
# * `*_dialog_params_size`
- "parameters": { # Optional. The collection of parameters associated with this context.
- #
- # Depending on your protocol or client library language, this is a
- # map, associative array, symbol table, dictionary, or JSON object
- # composed of a collection of (MapKey, MapValue) pairs:
- #
- # - MapKey type: string
- # - MapKey value: parameter name
- # - MapValue type:
- # - If parameter's entity type is a composite entity: map
- # - Else: string or number, depending on parameter value type
- # - MapValue value:
- # - If parameter's entity type is a composite entity:
- # map from composite entity property names to property values
- # - Else: parameter value
- "a_key": "", # Properties of the object.
- },
}
x__xgafv: string, V1 error format.
@@ -158,7 +172,38 @@
Returns:
An object of the form:
- { # 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).
+ "parameters": { # Optional. The collection of parameters associated with this context.
+ #
+ # Depending on your protocol or client library language, this is a
+ # map, associative array, symbol table, dictionary, or JSON object
+ # composed of a collection of (MapKey, MapValue) pairs:
+ #
+ # - MapKey type: string
+ # - MapKey value: parameter name
+ # - MapValue type:
+ # - If parameter's entity type is a composite entity: map
+ # - Else: string or number, depending on parameter value type
+ # - MapValue value:
+ # - If parameter's entity type is a composite entity:
+ # map from composite entity property names to property values
+ # - Else: parameter value
+ "a_key": "", # Properties of the object.
+ },
"lifespanCount": 42, # Optional. The number of conversational query requests after which the
# context expires. The default is `0`. If set to `0`, the context expires
# immediately. Contexts expire automatically after 20 minutes if there
@@ -180,23 +225,6 @@
# * `__system_counters__`
# * `*_id_dialog_context`
# * `*_dialog_params_size`
- "parameters": { # Optional. The collection of parameters associated with this context.
- #
- # Depending on your protocol or client library language, this is a
- # map, associative array, symbol table, dictionary, or JSON object
- # composed of a collection of (MapKey, MapValue) pairs:
- #
- # - MapKey type: string
- # - MapKey value: parameter name
- # - MapValue type:
- # - If parameter's entity type is a composite entity: map
- # - Else: string or number, depending on parameter value type
- # - MapValue value:
- # - If parameter's entity type is a composite entity:
- # map from composite entity property names to property values
- # - Else: parameter value
- "a_key": "", # Properties of the object.
- },
}</pre>
</div>
@@ -250,7 +278,38 @@
Returns:
An object of the form:
- { # 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).
+ "parameters": { # Optional. The collection of parameters associated with this context.
+ #
+ # Depending on your protocol or client library language, this is a
+ # map, associative array, symbol table, dictionary, or JSON object
+ # composed of a collection of (MapKey, MapValue) pairs:
+ #
+ # - MapKey type: string
+ # - MapKey value: parameter name
+ # - MapValue type:
+ # - If parameter's entity type is a composite entity: map
+ # - Else: string or number, depending on parameter value type
+ # - MapValue value:
+ # - If parameter's entity type is a composite entity:
+ # map from composite entity property names to property values
+ # - Else: parameter value
+ "a_key": "", # Properties of the object.
+ },
"lifespanCount": 42, # Optional. The number of conversational query requests after which the
# context expires. The default is `0`. If set to `0`, the context expires
# immediately. Contexts expire automatically after 20 minutes if there
@@ -272,28 +331,11 @@
# * `__system_counters__`
# * `*_id_dialog_context`
# * `*_dialog_params_size`
- "parameters": { # Optional. The collection of parameters associated with this context.
- #
- # Depending on your protocol or client library language, this is a
- # map, associative array, symbol table, dictionary, or JSON object
- # composed of a collection of (MapKey, MapValue) pairs:
- #
- # - MapKey type: string
- # - MapKey value: parameter name
- # - MapValue type:
- # - If parameter's entity type is a composite entity: map
- # - Else: string or number, depending on parameter value type
- # - MapValue value:
- # - If parameter's entity type is a composite entity:
- # map from composite entity property names to property values
- # - Else: parameter value
- "a_key": "", # Properties of the object.
- },
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Returns the list of all contexts in the specified session.
Args:
@@ -303,9 +345,9 @@
ID>/sessions/<Session ID>`. If `Environment ID` is not specified, we assume
default 'draft' environment. If `User ID` is not specified, we assume
default '-' user. (required)
- pageToken: string, Optional. The next_page_token value returned from a previous list request.
pageSize: integer, Optional. The maximum number of items to return in a single page. By
default 100 and at most 1000.
+ pageToken: string, Optional. The next_page_token value returned from a previous list request.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -319,7 +361,38 @@
# more results in the list.
"contexts": [ # The list of contexts. There will be a maximum number of items
# returned based on the page_size field in the request.
- { # 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).
+ "parameters": { # Optional. The collection of parameters associated with this context.
+ #
+ # Depending on your protocol or client library language, this is a
+ # map, associative array, symbol table, dictionary, or JSON object
+ # composed of a collection of (MapKey, MapValue) pairs:
+ #
+ # - MapKey type: string
+ # - MapKey value: parameter name
+ # - MapValue type:
+ # - If parameter's entity type is a composite entity: map
+ # - Else: string or number, depending on parameter value type
+ # - MapValue value:
+ # - If parameter's entity type is a composite entity:
+ # map from composite entity property names to property values
+ # - Else: parameter value
+ "a_key": "", # Properties of the object.
+ },
"lifespanCount": 42, # Optional. The number of conversational query requests after which the
# context expires. The default is `0`. If set to `0`, the context expires
# immediately. Contexts expire automatically after 20 minutes if there
@@ -341,23 +414,6 @@
# * `__system_counters__`
# * `*_id_dialog_context`
# * `*_dialog_params_size`
- "parameters": { # Optional. The collection of parameters associated with this context.
- #
- # Depending on your protocol or client library language, this is a
- # map, associative array, symbol table, dictionary, or JSON object
- # composed of a collection of (MapKey, MapValue) pairs:
- #
- # - MapKey type: string
- # - MapKey value: parameter name
- # - MapValue type:
- # - If parameter's entity type is a composite entity: map
- # - Else: string or number, depending on parameter value type
- # - MapValue value:
- # - If parameter's entity type is a composite entity:
- # map from composite entity property names to property values
- # - Else: parameter value
- "a_key": "", # Properties of the object.
- },
},
],
}</pre>
@@ -402,7 +458,38 @@
body: object, The request body.
The object takes the form of:
-{ # 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).
+ "parameters": { # Optional. The collection of parameters associated with this context.
+ #
+ # Depending on your protocol or client library language, this is a
+ # map, associative array, symbol table, dictionary, or JSON object
+ # composed of a collection of (MapKey, MapValue) pairs:
+ #
+ # - MapKey type: string
+ # - MapKey value: parameter name
+ # - MapValue type:
+ # - If parameter's entity type is a composite entity: map
+ # - Else: string or number, depending on parameter value type
+ # - MapValue value:
+ # - If parameter's entity type is a composite entity:
+ # map from composite entity property names to property values
+ # - Else: parameter value
+ "a_key": "", # Properties of the object.
+ },
"lifespanCount": 42, # Optional. The number of conversational query requests after which the
# context expires. The default is `0`. If set to `0`, the context expires
# immediately. Contexts expire automatically after 20 minutes if there
@@ -424,23 +511,6 @@
# * `__system_counters__`
# * `*_id_dialog_context`
# * `*_dialog_params_size`
- "parameters": { # Optional. The collection of parameters associated with this context.
- #
- # Depending on your protocol or client library language, this is a
- # map, associative array, symbol table, dictionary, or JSON object
- # composed of a collection of (MapKey, MapValue) pairs:
- #
- # - MapKey type: string
- # - MapKey value: parameter name
- # - MapValue type:
- # - If parameter's entity type is a composite entity: map
- # - Else: string or number, depending on parameter value type
- # - MapValue value:
- # - If parameter's entity type is a composite entity:
- # map from composite entity property names to property values
- # - Else: parameter value
- "a_key": "", # Properties of the object.
- },
}
updateMask: string, Optional. The mask to control which fields get updated.
@@ -452,7 +522,38 @@
Returns:
An object of the form:
- { # 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).
+ "parameters": { # Optional. The collection of parameters associated with this context.
+ #
+ # Depending on your protocol or client library language, this is a
+ # map, associative array, symbol table, dictionary, or JSON object
+ # composed of a collection of (MapKey, MapValue) pairs:
+ #
+ # - MapKey type: string
+ # - MapKey value: parameter name
+ # - MapValue type:
+ # - If parameter's entity type is a composite entity: map
+ # - Else: string or number, depending on parameter value type
+ # - MapValue value:
+ # - If parameter's entity type is a composite entity:
+ # map from composite entity property names to property values
+ # - Else: parameter value
+ "a_key": "", # Properties of the object.
+ },
"lifespanCount": 42, # Optional. The number of conversational query requests after which the
# context expires. The default is `0`. If set to `0`, the context expires
# immediately. Contexts expire automatically after 20 minutes if there
@@ -474,23 +575,6 @@
# * `__system_counters__`
# * `*_id_dialog_context`
# * `*_dialog_params_size`
- "parameters": { # Optional. The collection of parameters associated with this context.
- #
- # Depending on your protocol or client library language, this is a
- # map, associative array, symbol table, dictionary, or JSON object
- # composed of a collection of (MapKey, MapValue) pairs:
- #
- # - MapKey type: string
- # - MapKey value: parameter name
- # - MapValue type:
- # - If parameter's entity type is a composite entity: map
- # - Else: string or number, depending on parameter value type
- # - MapValue value:
- # - If parameter's entity type is a composite entity:
- # map from composite entity property names to property values
- # - Else: parameter value
- "a_key": "", # Properties of the object.
- },
}</pre>
</div>