Step-by-Step Instructions on How to Use Jargon
Need Additional Support?
We're here for you and happy to answer questions. Don't hesitate to reach out!
How to add variants and components to responses:
1. Responses can be accessed in Studio, under App Content. You can organize your responses in folders on the left by clicking the folder icon to the right of “Responses”.
2. When you click on a response, you will see a menu of the underlying components.
- Response Name
- Application Label. This is used in your app’s code to fetch this response. Jargon will assemble the right components, based on the conditions you’ve set.
- Variants are different versions of the same response. They can be randomly selected (no conditions set) or conditional, based on platform, channel, or other custom conditions.
- Each variant may contain multiple components , such as text, speech, reprompt, image, card, button, etc.
3. Click the “add variant” button and you will be prompted to name the variant (optional) and select the components for the response. You also have the option to apply conditions. Without selecting conditions, the variant will be randomly selected. Here are the main differences between random and conditional variants:
- Random variants are randomly selected at an equal opportunity. This can help keep your app responses fresh and relevant for your users. One might say “Congrats!” another “Well done!” etc.
- Adding a condition to a variant allows you to tailor the variant’s content to a specific user context, such as when the user is on a specific platform or channel (i.e. “Rasa Channel: Slack”) or when a variable has a specific value (i.e. “userType: New”).
- If multiple response variants are available, Jargon first considers all variants that are eligible, by matching conditions in the response request. If it finds multiple variants that match the condition(s), it will select randomly from among those. For example, say your response contains the variants below. If your user is on Slack, Jargon will randomly choose either variant 4 or 5. If your user is on another channel, Jargon will randomly choose from 1, 2 or 3.
- Variant 1: No conditions
- Variant 2: No conditions
- Variant 3: No conditions
- Variant 4: Condition “Rasa Channel: Slack"
- Variant 5: Condition “Rasa Channel: Slack”
4. Components and conditions can also be added via the edit button to the right of the response variant.
5. Strings, located under responses on the left navigation bar, can also add variety within a response. Strings have two main uses:
- When a response component consists of two or more parts strung together, each pulling randomly from a predefined set of options, analogous to how a slot machine works. It's similar to response variants, but without needing to write out each possible combination. More information on cross-referencing strings here.
- When your content doesn't fit Jargon's basic format of a multi-component Response. More information on retrieving strings and objects from your app here.