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>__.
Attributes
Name
Description
name
str
Output only. The unique identifier of this agent
environment. Supported formats:
- projects/
- projects/
The environment ID for the default environment is -.
description
str
Optional. The developer-provided description
for this environment. The maximum length is 500
characters. If exceeded, the request is
rejected.
agent_version
str
Optional. The agent version loaded into this environment.
Supported formats:
- projects/
- projects/
google.protobuf.timestamp_pb2.Timestamp
Output only. The last update time of this
environment. This field is read-only, i.e., it
cannot be set by create and update methods.
Represents an environment state. When an environment is pointed to a
new agent version, the environment is temporarily set to the
LOADING state. During that time, the environment keeps on
serving the previous version of the agent. After the new agent
version is done loading, the environment is set back to the
RUNNING state.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Class Environment (2.41.2)\n\nVersion latestkeyboard_arrow_down\n\n- [2.41.2 (latest)](/python/docs/reference/dialogflow/latest/google.cloud.dialogflow_v2.types.Environment)\n- [2.41.1](/python/docs/reference/dialogflow/2.41.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.40.0](/python/docs/reference/dialogflow/2.40.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.39.1](/python/docs/reference/dialogflow/2.39.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.38.0](/python/docs/reference/dialogflow/2.38.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.37.0](/python/docs/reference/dialogflow/2.37.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.36.0](/python/docs/reference/dialogflow/2.36.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.35.0](/python/docs/reference/dialogflow/2.35.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.34.0](/python/docs/reference/dialogflow/2.34.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.33.0](/python/docs/reference/dialogflow/2.33.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.32.0](/python/docs/reference/dialogflow/2.32.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.30.2](/python/docs/reference/dialogflow/2.30.2/google.cloud.dialogflow_v2.types.Environment)\n- [2.29.0](/python/docs/reference/dialogflow/2.29.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.28.3](/python/docs/reference/dialogflow/2.28.3/google.cloud.dialogflow_v2.types.Environment)\n- [2.27.0](/python/docs/reference/dialogflow/2.27.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.26.0](/python/docs/reference/dialogflow/2.26.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.25.0](/python/docs/reference/dialogflow/2.25.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.24.1](/python/docs/reference/dialogflow/2.24.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.23.3](/python/docs/reference/dialogflow/2.23.3/google.cloud.dialogflow_v2.types.Environment)\n- [2.22.0](/python/docs/reference/dialogflow/2.22.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.21.0](/python/docs/reference/dialogflow/2.21.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.20.0](/python/docs/reference/dialogflow/2.20.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.19.1](/python/docs/reference/dialogflow/2.19.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.18.0](/python/docs/reference/dialogflow/2.18.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.17.0](/python/docs/reference/dialogflow/2.17.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.16.1](/python/docs/reference/dialogflow/2.16.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.15.2](/python/docs/reference/dialogflow/2.15.2/google.cloud.dialogflow_v2.types.Environment)\n- [2.14.1](/python/docs/reference/dialogflow/2.14.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.13.0](/python/docs/reference/dialogflow/2.13.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.12.0](/python/docs/reference/dialogflow/2.12.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.11.0](/python/docs/reference/dialogflow/2.11.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.10.0](/python/docs/reference/dialogflow/2.10.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.9.1](/python/docs/reference/dialogflow/2.9.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.8.1](/python/docs/reference/dialogflow/2.8.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.7.1](/python/docs/reference/dialogflow/2.7.1/google.cloud.dialogflow_v2.types.Environment)\n- [2.6.0](/python/docs/reference/dialogflow/2.6.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.5.0](/python/docs/reference/dialogflow/2.5.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.4.0](/python/docs/reference/dialogflow/2.4.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.3.0](/python/docs/reference/dialogflow/2.3.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.2.0](/python/docs/reference/dialogflow/2.2.0/google.cloud.dialogflow_v2.types.Environment)\n- [2.1.2](/python/docs/reference/dialogflow/2.1.2/google.cloud.dialogflow_v2.types.Environment)\n- [2.0.0](/python/docs/reference/dialogflow/2.0.0/google.cloud.dialogflow_v2.types.Environment)\n- [1.1.3](/python/docs/reference/dialogflow/1.1.3/google.cloud.dialogflow_v2.types.Environment)\n- [1.0.0](/python/docs/reference/dialogflow/1.0.0/google.cloud.dialogflow_v2.types.Environment)\n- [0.8.0](/python/docs/reference/dialogflow/0.8.0/google.cloud.dialogflow_v2.types.Environment)\n- [0.7.2](/python/docs/reference/dialogflow/0.7.2/google.cloud.dialogflow_v2.types.Environment) \n\n Environment(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nYou can create multiple versions of your agent and publish them to\nseparate environments.\n\nWhen you edit an agent, you are editing the draft agent. At any\npoint, you can save the draft agent as an agent version, which is an\nimmutable snapshot of your agent.\n\nWhen you save the draft agent, it is published to the default\nenvironment. When you create agent versions, you can publish them to\ncustom environments. You can create a variety of custom environments\nfor:\n\n- testing\n- development\n- production\n- etc.\n\nFor more information, see the `versions and environments\nguide \u003chttps://cloud.google.com/dialogflow/docs/agents-versions\u003e`__.\n\nClasses\n-------\n\n### State\n\n State(value)\n\nRepresents an environment state. When an environment is pointed to a\nnew agent version, the environment is temporarily set to the\n`LOADING` state. During that time, the environment keeps on\nserving the previous version of the agent. After the new agent\nversion is done loading, the environment is set back to the\n`RUNNING` state."]]