What Variables Are
A variable is a placeholder wrapped in double curly braces.
Example:
Hi {{contact.first_name}}
If the contact’s first name is John, the agent reads it as:
Hi John
Variables can be typed manually or inserted from the variable picker.
What Custom Values Are
Custom Values are reusable key-value pairs created in Settings → Custom Values.
Use Custom Values for information that may be reused across agents, workflows, pages, and messages.
Example:
Name: Support Email
Key: {{custom_values.support_email}}
Value: [email protected]
Variable Categories in Agent Studio
Agent Studio includes variable categories that pull data from different parts of Kyrios. Common categories include:
Account: Business details from account settings.
Custom Values: Reusable values from Settings.
Right Now: Live date and time values.
Form Data: Submitted form field values.
Contact: Saved CRM contact data.
Runtime Variables: Temporary values created during the current agent run.
Open Agent Studio
Go to AI Agents → Agent Studio. Open an existing agent or create a new one.
Insert a Variable in an AI Agent Prompt
Click inside a prompt or message field. Click the dropdown arrow in the field to open the variable picker. Choose a category, then select the variable you want to insert.
Use Variables in Conditions
Variables can also be used in conditional logic. Use them when the agent needs to compare a contact value, form value, custom value, or runtime value before choosing the next path.
Save and Test Variables
After adding variables:
Click Save.
Click Test.
Run a sample conversation.
Confirm the variables resolve correctly.
If a variable appears blank, check that the source data exists in the contact record, account settings, form submission, or Custom Values.
Publish the Agent
After testing confirms the variables work correctly, click Publish. Publishing makes the updated agent available for live use.
Contact Variables vs Runtime Variables
Contact variables pull saved CRM data from the contact record. Runtime variables store temporary information collected during the current conversation. Use Contact variables when the data already exists before the conversation starts. Use Runtime variables when the agent collects the value during the conversation.
Common Issues and Fixes
A variable appears blank
The source field may not have a value. Check the contact record, account settings, form submission, or Custom Value.
A Form Data variable is blank
Form Data variables only populate when the agent is triggered by a form submission.
A Custom Value is not working
Confirm the Custom Value exists in Settings → Custom Values and that the key matches exactly.
The wrong value appears
Check that the agent is using the correct variable category and key.
FAQ
What happens if a variable has no value?
Kyrios returns a blank value. The agent does not stop running.
What happens if a Custom Value is deleted?
The deleted Custom Value returns blank where it is used.
Can I type variables manually?
Yes. Use the exact variable key with double curly braces.
Are variable placeholders case-sensitive?
Yes. Use the exact key shown in the variable picker.
Do Right Now variables use the account timezone?
Yes. Right now, variables use the account timezone.
Can Form Data variables be used anytime?
No. Form Data variables only populate when the agent is triggered by a form submission.