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>__.
Attributes
Name
Description
name
str
Required. The unique identifier of the context. Format:
projects/,
or
projects/.
The Context ID is always converted to lowercase, may
only contain characters in a-zA-Z0-9_-% and may be at
most 250 bytes long.
If Environment ID is not specified, we assume default
'draft' environment. If User ID is not specified, we
assume default '-' user.
The following context names are reserved for internal use by
Dialogflow. You should not use these contexts or create
contexts with these names:
- __system_counters__
- *_id_dialog_context
- *_dialog_params_size
lifespan_count
int
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 are no matching
queries.
parameters
google.protobuf.struct_pb2.Struct
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 then use map, otherwise, depending on the
parameter value type, it could be one of string, number,
boolean, null, list or map.
- MapValue value: If parameter's entity type is a composite
entity then use map from composite entity property names
to property values, otherwise, use parameter value.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class Context (2.41.2)\n\nVersion latestkeyboard_arrow_down\n\n- [2.41.2 (latest)](/python/docs/reference/dialogflow/latest/google.cloud.dialogflow_v2.types.Context)\n- [2.41.1](/python/docs/reference/dialogflow/2.41.1/google.cloud.dialogflow_v2.types.Context)\n- [2.40.0](/python/docs/reference/dialogflow/2.40.0/google.cloud.dialogflow_v2.types.Context)\n- [2.39.1](/python/docs/reference/dialogflow/2.39.1/google.cloud.dialogflow_v2.types.Context)\n- [2.38.0](/python/docs/reference/dialogflow/2.38.0/google.cloud.dialogflow_v2.types.Context)\n- [2.37.0](/python/docs/reference/dialogflow/2.37.0/google.cloud.dialogflow_v2.types.Context)\n- [2.36.0](/python/docs/reference/dialogflow/2.36.0/google.cloud.dialogflow_v2.types.Context)\n- [2.35.0](/python/docs/reference/dialogflow/2.35.0/google.cloud.dialogflow_v2.types.Context)\n- [2.34.0](/python/docs/reference/dialogflow/2.34.0/google.cloud.dialogflow_v2.types.Context)\n- [2.33.0](/python/docs/reference/dialogflow/2.33.0/google.cloud.dialogflow_v2.types.Context)\n- [2.32.0](/python/docs/reference/dialogflow/2.32.0/google.cloud.dialogflow_v2.types.Context)\n- [2.30.2](/python/docs/reference/dialogflow/2.30.2/google.cloud.dialogflow_v2.types.Context)\n- [2.29.0](/python/docs/reference/dialogflow/2.29.0/google.cloud.dialogflow_v2.types.Context)\n- [2.28.3](/python/docs/reference/dialogflow/2.28.3/google.cloud.dialogflow_v2.types.Context)\n- [2.27.0](/python/docs/reference/dialogflow/2.27.0/google.cloud.dialogflow_v2.types.Context)\n- [2.26.0](/python/docs/reference/dialogflow/2.26.0/google.cloud.dialogflow_v2.types.Context)\n- [2.25.0](/python/docs/reference/dialogflow/2.25.0/google.cloud.dialogflow_v2.types.Context)\n- [2.24.1](/python/docs/reference/dialogflow/2.24.1/google.cloud.dialogflow_v2.types.Context)\n- [2.23.3](/python/docs/reference/dialogflow/2.23.3/google.cloud.dialogflow_v2.types.Context)\n- [2.22.0](/python/docs/reference/dialogflow/2.22.0/google.cloud.dialogflow_v2.types.Context)\n- [2.21.0](/python/docs/reference/dialogflow/2.21.0/google.cloud.dialogflow_v2.types.Context)\n- [2.20.0](/python/docs/reference/dialogflow/2.20.0/google.cloud.dialogflow_v2.types.Context)\n- [2.19.1](/python/docs/reference/dialogflow/2.19.1/google.cloud.dialogflow_v2.types.Context)\n- [2.18.0](/python/docs/reference/dialogflow/2.18.0/google.cloud.dialogflow_v2.types.Context)\n- [2.17.0](/python/docs/reference/dialogflow/2.17.0/google.cloud.dialogflow_v2.types.Context)\n- [2.16.1](/python/docs/reference/dialogflow/2.16.1/google.cloud.dialogflow_v2.types.Context)\n- [2.15.2](/python/docs/reference/dialogflow/2.15.2/google.cloud.dialogflow_v2.types.Context)\n- [2.14.1](/python/docs/reference/dialogflow/2.14.1/google.cloud.dialogflow_v2.types.Context)\n- [2.13.0](/python/docs/reference/dialogflow/2.13.0/google.cloud.dialogflow_v2.types.Context)\n- [2.12.0](/python/docs/reference/dialogflow/2.12.0/google.cloud.dialogflow_v2.types.Context)\n- [2.11.0](/python/docs/reference/dialogflow/2.11.0/google.cloud.dialogflow_v2.types.Context)\n- [2.10.0](/python/docs/reference/dialogflow/2.10.0/google.cloud.dialogflow_v2.types.Context)\n- [2.9.1](/python/docs/reference/dialogflow/2.9.1/google.cloud.dialogflow_v2.types.Context)\n- [2.8.1](/python/docs/reference/dialogflow/2.8.1/google.cloud.dialogflow_v2.types.Context)\n- [2.7.1](/python/docs/reference/dialogflow/2.7.1/google.cloud.dialogflow_v2.types.Context)\n- [2.6.0](/python/docs/reference/dialogflow/2.6.0/google.cloud.dialogflow_v2.types.Context)\n- [2.5.0](/python/docs/reference/dialogflow/2.5.0/google.cloud.dialogflow_v2.types.Context)\n- [2.4.0](/python/docs/reference/dialogflow/2.4.0/google.cloud.dialogflow_v2.types.Context)\n- [2.3.0](/python/docs/reference/dialogflow/2.3.0/google.cloud.dialogflow_v2.types.Context)\n- [2.2.0](/python/docs/reference/dialogflow/2.2.0/google.cloud.dialogflow_v2.types.Context)\n- [2.1.2](/python/docs/reference/dialogflow/2.1.2/google.cloud.dialogflow_v2.types.Context)\n- [2.0.0](/python/docs/reference/dialogflow/2.0.0/google.cloud.dialogflow_v2.types.Context)\n- [1.1.3](/python/docs/reference/dialogflow/1.1.3/google.cloud.dialogflow_v2.types.Context)\n- [1.0.0](/python/docs/reference/dialogflow/1.0.0/google.cloud.dialogflow_v2.types.Context)\n- [0.8.0](/python/docs/reference/dialogflow/0.8.0/google.cloud.dialogflow_v2.types.Context)\n- [0.7.2](/python/docs/reference/dialogflow/0.7.2/google.cloud.dialogflow_v2.types.Context) \n\n Context(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nDialogflow contexts are similar to natural language context. If a\nperson says to you \"they are orange\", you need context in order to\nunderstand what \"they\" is referring to. Similarly, for Dialogflow to\nhandle an end-user expression like that, it needs to be provided\nwith context in order to correctly match an intent.\n\nUsing contexts, you can control the flow of a conversation. You can\nconfigure contexts for an intent by setting input and output\ncontexts, which are identified by string names. When an intent is\nmatched, any configured output contexts for that intent become\nactive. While any contexts are active, Dialogflow is more likely to\nmatch intents that are configured with input contexts that\ncorrespond to the currently active contexts.\n\nFor more information about context, see the `Contexts\nguide \u003chttps://cloud.google.com/dialogflow/docs/contexts-overview\u003e`__."]]