Skip to main content

flows

Overview

Nameflows
TypeResource
Idgoogle.dialogflow.flows

Fields

NameDatatypeDescription
namestringThe unique identifier of the flow. Format: projects//locations//agents//flows/.
descriptionstringThe description of the flow. The maximum length is 500 characters. If exceeded, the request is rejected.
displayNamestringRequired. The human-readable name of the flow.
eventHandlersarrayA flow's event handlers serve two purposes: They are responsible for handling events (e.g. no match, webhook errors) in the flow. They are inherited by every page's event handlers, which can be used to handle common events regardless of the current page. Event handlers defined in the page have higher priority than those defined in the flow. Unlike transition_routes, these handlers are evaluated on a first-match basis. The first one that matches the event get executed, with the rest being ignored.
knowledgeConnectorSettingsobjectThe Knowledge Connector settings for this page or flow. This includes information such as the attached Knowledge Bases, and the way to execute fulfillment.
nluSettingsobjectSettings related to NLU.
transitionRouteGroupsarrayA flow's transition route group serve two purposes: They are responsible for matching the user's first utterances in the flow. They are inherited by every page's transition route groups. Transition route groups defined in the page have higher priority than those defined in the flow. Format:projects//locations//agents//flows//transitionRouteGroups/ or projects//locations//agents//transitionRouteGroups/ for agent-level groups.
transitionRoutesarrayA flow's transition routes serve two purposes: They are responsible for matching the user's first utterances in the flow. They are inherited by every page's transition routes and can support use cases such as the user saying "help" or "can I talk to a human?", which can be handled in a common way regardless of the current page. Transition routes defined in the page have higher priority than those defined in the flow. TransitionRoutes are evalauted in the following order: TransitionRoutes with intent specified. TransitionRoutes with only condition specified. TransitionRoutes with intent specified are inherited by pages in the flow.

Methods

NameAccessible byRequired ParamsDescription
projects_locations_agents_flows_getSELECTagentsId, flowsId, locationsId, projectsIdRetrieves the specified flow.
projects_locations_agents_flows_listSELECTagentsId, locationsId, projectsIdReturns the list of all flows in the specified agent.
projects_locations_agents_flows_createINSERTagentsId, locationsId, projectsIdCreates a flow in the specified agent. Note: You should always train a flow prior to sending it queries. See the training documentation.
projects_locations_agents_flows_deleteDELETEagentsId, flowsId, locationsId, projectsIdDeletes a specified flow.
_projects_locations_agents_flows_listEXECagentsId, locationsId, projectsIdReturns the list of all flows in the specified agent.
projects_locations_agents_flows_exportEXECagentsId, flowsId, locationsId, projectsIdExports the specified flow to a binary file. This method is a long-running operation. The returned Operation type has the following method-specific fields: - metadata: An empty Struct message - response: ExportFlowResponse Note that resources (e.g. intents, entities, webhooks) that the flow references will also be exported.
projects_locations_agents_flows_importEXECagentsId, locationsId, projectsIdImports the specified flow to the specified agent from a binary file. This method is a long-running operation. The returned Operation type has the following method-specific fields: - metadata: An empty Struct message - response: ImportFlowResponse Note: You should always train a flow prior to sending it queries. See the training documentation.
projects_locations_agents_flows_patchEXECagentsId, flowsId, locationsId, projectsIdUpdates the specified flow. Note: You should always train a flow prior to sending it queries. See the training documentation.
projects_locations_agents_flows_trainEXECagentsId, flowsId, locationsId, projectsIdTrains the specified flow. Note that only the flow in 'draft' environment is trained. This method is a long-running operation. The returned Operation type has the following method-specific fields: - metadata: An empty Struct message - response: An Empty message Note: You should always train a flow prior to sending it queries. See the training documentation.
projects_locations_agents_flows_validateEXECagentsId, flowsId, locationsId, projectsIdValidates the specified flow and creates or updates validation results. Please call this API after the training is completed to get the complete validation results.