Dynamic Variables whilst Testing
Published:
Overview
This guide explains how to set and manage dynamic variables when testing an AI Voice Agent in the portal. Dynamic variables are values injected into the agent’s prompt at runtime — for example, a caller’s first name — and must be populated before testing to ensure the agent behaves correctly.
What Are Dynamic Variables?
Dynamic variables appear in the agent prompt as orange highlighted text enclosed in curly brackets (e.g., {first_name}). They must be:
- A single word (no spaces)
- Case sensitive
- Defined in the Variables panel before testing
Steps to Set Dynamic Variables for Testing
- Navigate to Call Flows and locate the agent you want to test.
- Confirm the agent prompt contains dynamic variables (displayed in orange with curly brackets).
- Before testing, go to the Variables panel.
- Locate the variable (e.g.,
{first_name}) and enter a test value (e.g., John). - Optionally, click Save to Library to store this variable set for future test sessions — enter a name and confirm.
- In the Library, click the star icon next to a saved set to make it the default — this means the agent will automatically load that variable set each time you test.
- Click Load to apply the variable set before testing.
- Only add variables that exist in the agent prompt — adding variables not referenced in the prompt has no effect.
- Once testing is complete, save any changes using Save to Draft.
Key Notes
| Item | Details |
|---|---|
| Format | Variables must be a single word, enclosed in curly brackets, and are case sensitive |
| Display | Dynamic variables appear highlighted in orange within the agent prompt |
| Library | Save frequently used variable sets to the library to avoid re-entering values each session |
| Default Set | Star a library entry to automatically load it each time the agent is tested |
| Unused Variables | Adding a variable that does not exist in the prompt has no effect |
