Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. Seethe details.
A transition route specifies aintentthat can be matched and/or a data condition that can be evaluated during a session. When a specified transition is matched, the following actions are taken in order:
If there is atriggerFulfillmentassociated with the transition, it will be called.
If there is atargetPageassociated with the transition, the session will transition into the specified page.
If there is atargetFlowassociated with the transition, the session will transition into the specified flow.
JSON representation
{"name":string,"description":string,"intent":string,"condition":string,"triggerFulfillment":{object (Fulfillment)},// Union fieldtargetcan be only one of the following:"targetPage":string,"targetFlow":string// End of list of possible types for union fieldtarget.}
Fields
name
string
Output only. The unique identifier of this transition route.
description
string
Optional. The description of the transition route. The maximum length is 500 characters.
intent
string
The unique identifier of anIntent. Format:projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/intents/<IntentID>. Indicates that the transition can only happen when the given intent is matched. At least one ofintentorconditionmust be specified. When bothintentandconditionare specified, the transition can only happen when both are fulfilled.
See theconditions reference. At least one ofintentorconditionmust be specified. When bothintentandconditionare specified, the transition can only happen when both are fulfilled.
The fulfillment to call when the condition is satisfied. At least one oftriggerFulfillmentandtargetmust be specified. When both are defined,triggerFulfillmentis executed first.
Union fieldtarget. The target to transition to, either a page in the same host flow (the flow that owns thisTransitionRoute), or another flow in the same agent.targetcan be only one of the following:
targetPage
string
The target page to transition to. Format:projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.
targetFlow
string
The target flow to transition to. Format:projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.
[[["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-06-27 UTC."],[[["\u003cp\u003eA transition route defines an intent and/or a data condition that triggers actions during a session.\u003c/p\u003e\n"],["\u003cp\u003eWhen a transition is matched, actions are executed sequentially: \u003ccode\u003etriggerFulfillment\u003c/code\u003e is called first, followed by the session transitioning to either a \u003ccode\u003etargetPage\u003c/code\u003e or \u003ccode\u003etargetFlow\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA transition route requires specifying either an \u003ccode\u003eintent\u003c/code\u003e or a \u003ccode\u003econdition\u003c/code\u003e, or both, and it needs either a \u003ccode\u003etriggerFulfillment\u003c/code\u003e or a \u003ccode\u003etarget\u003c/code\u003e to define the actions upon matching.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etarget\u003c/code\u003e field can be one of the two options, \u003ccode\u003etargetPage\u003c/code\u003e or \u003ccode\u003etargetFlow\u003c/code\u003e, that defines the next step in the session.\u003c/p\u003e\n"],["\u003cp\u003eThe json representation of the transition route contains information about its name, description, intent, condition, trigger fulfillment, target page, and target flow.\u003c/p\u003e\n"]]],[],null,["# TransitionRoute\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nA transition route specifies a [intent](/dialogflow/cx/docs/reference/rest/v3beta1/projects.locations.agents.intents#Intent) that can be matched and/or a data condition that can be evaluated during a session. When a specified transition is matched, the following actions are taken in order:\n\n- If there is a [`triggerFulfillment`](/dialogflow/cx/docs/reference/rest/v3beta1/TransitionRoute#FIELDS.trigger_fulfillment) associated with the transition, it will be called.\n- If there is a [`targetPage`](/dialogflow/cx/docs/reference/rest/v3beta1/TransitionRoute#FIELDS.target_page) associated with the transition, the session will transition into the specified page.\n- If there is a [`targetFlow`](/dialogflow/cx/docs/reference/rest/v3beta1/TransitionRoute#FIELDS.target_flow) associated with the transition, the session will transition into the specified flow."]]
