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:
Output only. The creation time of this version. This field is read-only, i.e., it cannot be set by create and update methods.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
[[["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-08-21 UTC."],[[["\u003cp\u003eAgent versions are immutable snapshots of your agent, allowing you to save your progress at different stages.\u003c/p\u003e\n"],["\u003cp\u003eDraft agents are editable, while saved agent versions cannot be modified once created.\u003c/p\u003e\n"],["\u003cp\u003eAgent versions can be published to various custom environments like testing, development, or production.\u003c/p\u003e\n"],["\u003cp\u003eEach agent version has a unique name, an optional description, a sequential version number, a creation timestamp, and a status.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage agent versions using several methods including creating, deleting, retrieving, listing, and updating.\u003c/p\u003e\n"]]],[],null,["# REST Resource: projects.locations.agent.versions\n\n- [Resource: Version](#Version)\n - [JSON representation](#Version.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Version\n-----------------\n\nYou can create multiple versions of your agent and publish them to separate environments.\n\nWhen 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.\n\nWhen 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:\n\n- testing\n- development\n- production\n- etc.\n\nFor more information, see the [versions and environments guide](https://cloud.google.com/dialogflow/docs/agents-versions)."]]