Context bundles

You can use context bundles to automatically import variables

into the conversation. You can find the context bundles menu when you select the environment.

Uses of context bundles

Context bundles can be very useful in various scenarios, including but not limited to:

• Different variable values for different languages
• Webhook variables that can be edited at any time without intervening with code
• Different information within the same AI Agent, depending on the environment

Add a context bundle

To add a context bundle, go to your environment → Context bundles → + Add context bundle. Enter a name and (optionally) a description. After you create the bundle, add all variable keys and values and save.

Upload a context bundle

You can also upload your context bundle in a JSON file. There are two ways to do this:

Import a new bundle

Similar to importing an AI Agent, you can import your context bundle. Select a name, a description, and your JSON file to import your context bundle as new.

Merge bundle

You can also upload your bundle into an existing one to merge all variables into one bundle. In case of conflicts, you have the option to either keep the original variable values or replace them with the new ones.

Use a context bundle

Once you have created a context bundle, you can use it in your Agent as context variables. To do this, you first need to apply the context bundle to the conversation using a rule, and then you can use the variables in a dialog

.

Apply a context bundle

1. Navigate to Deploy → Rules.
2. Click on + Add rule.
3. Select the conditions you want to apply the context bundle to.
4. In the Then section, select Apply bundle.
5. Choose the context bundle you want to apply.
6. Depending on your conditions, you may want to assign an AI Agent too.
7. Activate the rule.
8. Save changes.

Use the variables

In a dialog, you can use the variables from the context bundle by using the {{$global.bundle.variable_name}} syntax. For example, if you have a variable name in your context bundle, you can use it in a dialog like {{$global.bundle.name}}. If you use the variable before applying the context bundle, it will show as %UNKNOWN in the conversation, just like any other variable.

Every bundle has a preset property bundle with its name, so you can use it in your dialog as {{$global.bundle.bundle}}. This can be useful to differentiate between different bundles in the same dialog using conditions

.