GitHubContribute in GitHub: Edit online

copyright: year: 2024 last updated: 2024-06-03

Using custom forms

You can define input and output forms by using custom forms in the skill flow mapping. You use input forms to create a form that collects user data, which can be primitive types (string, integer, Boolean). These inputs can be used in other forms. With the output form, you can map data in the primitive type outputs of other skills (including input forms) to create a customized final output for your users.

You have more control over how to gather input from your users when you combine this feature with the option to hide input/output forms of skills. Also, the input forms can be hidden if you want to use them as a hidden data transformation skill.

Custom forms

Input form

The builder can create a form to input data and map this input to a skill later in the flow.

To add an input form to the skill flow, do as follows:

  1. Click the add icon Add-alt.
  2. Click the Custom forms tile.
  3. Click Add Skill + in the Input form tile.
  4. Click the Input form tile in the skill flow.
    • Optional: Enter a title for the form.
    • Optional: Hide the form from the user.
  5. Click the Add input field + button.
  6. Select the input type:
    • Single line text
    • Paragraph text
    • Date
    • Decimal number
    • Number
    • Confirmation (Boolean)
  7. Click Next.
  8. Enter a name to be displayed as a label in the Input name field.
  9. Click Apply.

If it was needed, you can configure the input field again by clicking the gear icon next to the field.

Configure input field button

You can add as many input fields as you need. Then, you can map these inputs to another skill in your skill flow.

Output form

Customize the results from a skill flow by using a custom output form. With this option, you can define what users can see in the chat and improve their experience by focusing on what is necessary to be seen. The following steps show how to add an output form in a skill flow:

  1. Click the add icon Add-alt.
  2. Search and click Custom forms skill.
  3. Click Add skill + in the Output form tile.
  4. Click the Output form tile in the skill flow.
    • Optional: Hide the form from the user.
  5. Add values from other skills as the follow:
    1. Click the blank field and type #.
    2. In the window that is open, you select an output from a previous skill.
    3. Click Ok.
    • You can repeat this action to add as many output values as you need.

Custom output values

Parent topic:

→ Combining skills into skill flows