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 an agent, allowing you to save drafts and publish to custom environments like testing, development, or production.\u003c/p\u003e\n"],["\u003cp\u003eEach version has a unique identifier, an optional description, a sequential version number, a creation timestamp, and a status indicating if it's ready, in progress, or failed.\u003c/p\u003e\n"],["\u003cp\u003eThe status of the version can be one of these: \u003ccode\u003eVERSION_STATUS_UNSPECIFIED\u003c/code\u003e, \u003ccode\u003eIN_PROGRESS\u003c/code\u003e, \u003ccode\u003eREADY\u003c/code\u003e, \u003ccode\u003eFAILED\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThere are five methods for managing agent versions: create, delete, get, list, and patch, which facilitate creating, deleting, retrieving, listing, and updating agent versions respectively.\u003c/p\u003e\n"]]],[],null,["# REST Resource: projects.agent.versions\n\n- [Resource: Version](#Version)\n - [JSON representation](#Version.SCHEMA_REPRESENTATION)\n - [VersionStatus](#Version.VersionStatus)\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).\n\n### VersionStatus\n\nThe status of a version."]]