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 various environments.\u003c/p\u003e\n"],["\u003cp\u003eEach agent version has a unique identifier, description, sequential version number, creation time, and status.\u003c/p\u003e\n"],["\u003cp\u003eAgent versions can have statuses such as \u003ccode\u003eIN_PROGRESS\u003c/code\u003e, \u003ccode\u003eREADY\u003c/code\u003e, or \u003ccode\u003eFAILED\u003c/code\u003e, indicating the readiness to serve.\u003c/p\u003e\n"],["\u003cp\u003eYou can perform actions like creating, deleting, retrieving, listing, and updating agent versions via available methods.\u003c/p\u003e\n"],["\u003cp\u003eAgent versions allow publishing to default environments when saving the draft agent and to custom environments with specific agent versions, for testing, development, or production.\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."]]