The Variables tab in the AI Agent Orchestration provides a centralized view of all variables used within an AI Agent Orchestration. These variables enable data exchange between the AI Agent, its Skills, and external systems, helping drive dynamic and context-aware automation.
You can view the variable list by pressing the {} button on the lower-left side of the screen.
Types of Variables
There are two types of variables shown in the list:
- Custom Variables: Created and managed by users. These are typically used within Skills (Integrations or Workflows) and help define what data the AI Agent should work with.
- System Variables: Automatically populated by the consumer application (e.g., Autopilot, Copilot, Studio). These provide contextual data such as Interaction ID, Caller ID, or Application input.
Custom Variables
The Custom Variables list displays all user-defined variables along with the following details:
- Name.
- Description.
- Where the variable is used (e.g., which Skills reference it).
Users can perform the following actions:
- Create a new custom variable
- Edit existing variables
- Delete existing variables
Defining a Custom Variable
When creating a new custom variable, the following fields must be provided:
- Name: A unique identifier used to reference the variable within the AI Agent system.
- Description: A clear explanation of what the variable represents. This helps the AI Agent understand how to use the variable correctly in its responses.
- List of Allowed Values: You can optionally define a list of allowed values for each variable. This helps guide the AI Agent on what inputs are acceptable when attempting to capture that variable during interaction.