Skip to main content
A gambit is one step in a flow. This section holds one page per gambit type, each with the gambit shown in the builder, its editor open, and every setting that editor offers.

​
Every gambit type

The Gambits tab of the Gambit Types palette groups the types into five categories. Tool gambits come from the palette’s Tools tab instead. Each calls one action from a connected toolkit or from CodeKit, and they are covered in Enable and use actions. Component also sits in the Tools tab. A Component gambit gives an AI Agent gambit native capabilities, such as forms, a meeting booking, and file reading, or runs one of them as a flow step. See Component gambit and Book meetings with the Meeting Scheduler. Knowledge Retrieval also sits in the Tools tab, badged Built-in. It searches knowledge bases and returns results to an agent, and it attaches to an AI Agent gambit the way a tool gambit does. See Attach knowledge to an agent.

​
What every gambit editor shares

Selecting a gambit in the builder opens its editor in the right panel. Every editor opens with the same header and metadata row, whatever the gambit type. The header runs along the top of that panel, and the LABEL and VARIABLE fields sit directly under it. The elements appear in this order, left to right.
Renaming a variable does not update every reference. References in card fields and button options are not rewritten. Custom Code also needs manual updates to JavaScript references such as variables.response.<name>.Check all card fields, button options, and Custom Code after a rename. Run Validate before publishing.
Below that row, the sections differ by type. Most gambits offer Messages for the bubbles sent before the step, and a type-specific Configuration section. Input gambits add POST Action, and all of them except Media Upload add Conditions.

​
Media in messages

A message bubble can carry one image or video. Toggle media attachment on the bubble opens the media area. Then add the media in one of two ways:
  • Drop a file on Drop image or video, or click to browse. Uploads accept PNG, JPG, GIF, and WebP images, and MP4, WebM, and MOV videos.
  • Paste a link in the Image, video, YouTube, Vimeo, or embed URL… field and select Add.
  • A pasted image or video link shows as that image or video in the chat. An image link with no file extension, such as a signed or CDN link, shows as an image when it loads as one.
  • YouTube, Vimeo, and other embed links show as embedded content, as before.
  • Images are never cropped. They fit within half the chat width and 40% of the screen height. A small image shows at least 240 pixels wide.
  • An upload shows a spinner until it finishes, and one save is enough to keep it.
  • A bubble saved earlier with an image or video link shows the media too, with no edit.
Every input gambit carries Allow Skip, which lets the end user move on without answering. It adds a skip hint to the prompt and an arrow button to the composer. Input gambits other than Text also carry Allow Free Text. It is on for a new gambit, and it adds a Free Input handle for typed answers. Input gambits and Live Chat also carry a Bridge Event accordion, which appears only when the agent runs inside a native mobile bridge. It sends an event type and key and value parameters to the host app. See Bridge events.

​
How to read these pages

Every page in this section shows the same demo flow: Start, a Welcome message, the gambit the page covers, then End. The gambit and its editor are highlighted, and the rest of the screen is dimmed.