Variables | Smallest AI Docs

Variables let you personalize conversations with dynamic data. Instead of static text, insert values that change based on the caller, API responses, or information collected during the call.

Location: Config Panel (right sidebar) → Variables

Variable Types

User Defined

System

API

User defined variables — User Defined variables

Variables you create with default values.

Example	Use Case
`{{company_name}}`	Your company name
`{{support_hours}}`	Operating hours
`{{promo_code}}`	Current promotion

Syntax

Use double curly braces:

{{variable_name}}

Example

In your prompt:

Hello {{customer_name}}! Thanks for calling {{company_name}}.
I see you're a {{api.tier}} member. Your last order was 
{{api.last_order_status}}.
How can I help you today?

At runtime:

Hello Sarah! Thanks for calling Acme Corp.
I see you're a Premium member. Your last order was 
shipped on Monday.
How can I help you today?

Default Values

Handle missing variables gracefully:

Hello {{customer_name|there}}!

If customer_name is empty → “Hello there!”

Creating User Variables

Open the Variables panel
Go to User Defined tab
Click + Add Variable
Enter name and default value
Use in prompts with {{name}} syntax

Best Practices

Use descriptive names

Good	Bad
`{{customer_first_name}}`	`{{n}}`
`{{appointment_date}}`	`{{d1}}`

Always have fallbacks

What if the variable is empty?

Use default values: {{name|there}}
Handle in prompt: “If customer name is unknown, greet generically”

Test substitution

Verify variables replace correctly. Check Convo Logs to see actual values.

API Calls

Fetch data from external APIs

Writing Prompts

Use variables in your prompts