Skip to main content
Variables are the dynamic content in your prompts. They can take different values for all your test cases. You can create text, image, and PDF variables.

​
Variable Name Constraints

Variable names must follow specific naming rules to ensure compatibility with Adaline’s system. When creating variables, keep the following constraints in mind:

​
Allowed Characters

Variable names can only contain:
  • Letters: a-z and A-Z
  • Numbers: 0-9
  • Underscores: _
  • Hyphens: -

​
Valid Variable Names

Examples of valid variable names:
  • {{user_question}}
  • {{product_name}}
  • {{user-id}}
  • {{item_123}}
  • {{my_variable}}

​
Invalid Variable Names

The following variable names are not allowed:
  • {{user question}} - contains spaces
  • {{user.question}} - contains a period
  • {{user@name}} - contains special characters
  • {{user/name}} - contains a slash
  • {{user:}} - contains a colon

​
Creating Text Variables

Text variables are simple to create. The following is an example of a prompt without variables:
Example of a prompt without variables:
“Write a haiku about nature that captures a peaceful moment.”
The following is an example of a prompt with variables:
Example of a prompt with variables:
“Write a haiku about {{topic}} that evokes {{emotion}} and includes {{element}}”
A variable can be added anywhere in a prompt by enclosing its name in double curly braces, for example {{persona}}. You can manage the content for each variable in the Variable Editor: Defining the content of a variable

​
Creating Image Variables

To create image variables follow the steps below:
1

Click insert image

Insert a new image in the Editor and select From Variable.Adding a new image
2

Give a name and attach the image variable

Define a name for the image variable and attach it to the message.Name and attach image
3

Attach an actual image to the variable

Attach an actual image to the variable. You can paste the URL, the base64, or load it from your computer.Attaching an actual image

​
Creating PDF Variables

To create PDF variables follow the steps below:
1

Click insert PDF

Insert a new PDF in the Editor and select From Variable.Adding a PDF variable
2

Give a name and attach the PDF variable

Define a name for the PDF variable and attach it to the message.Rename a PDF variable
3

Attach an actual PDF to the variable

Attach an actual PDF to the variable. You can paste the URL, the base64, or load it from your computer.Attaching an actual PDF

​
Variable Sources

Variables can have different sources depending on your needs:
  • Static Values: Direct text, image, or PDF content
  • API Variables: Fetch live data from external HTTP endpoints
  • Prompt Variables: Use the output from another prompt in your project
To modify a variable’s source, follow the steps below:
1

Create a Text, Image, or PDF Variable

Follow the steps above to create a variable.
2

Choose a source for the variable

A variable can have its source from an external API, another prompt, or a static value. Select the appropriate source type in the Variable Editor.Choose variable source

​
Creating API Variables

API variables allow your prompts to interact with external systems in real-time by fetching data from HTTP endpoints at runtime. To create API variables and use external endpoints as a source, follow the steps below:
1

Create a Text, Image, or PDF Variable

Follow the steps above to create a variable.
2

Choose API as source for the variable

Select API as the source type. This enables the variable to fetch data from external HTTP endpoints.
3

Configure the API endpoint

Define the API configuration in the Variable Editor:
  • URL: Configure the endpoint URL
  • Method: Configure the HTTP method from GET, POST, PUT, PATCH, or DELETE
  • Headers: Set request headers (use secretHeaders for sensitive keys/tokens)
  • Body: Configure the request body for POST/PUT/PATCH requests
Insert an API variable
TIP: Use placeholders like {{columnName}} within the API configuration (URL, headers, query params, or body). These are automatically resolved from your dataset columns at runtime.

​
Creating Prompt Variables

Prompt variables enable Prompt Chaining, where the output of one AI instruction serves as the input for another. This allows you to build agent-like workflows and modular prompt architectures. To create prompt variables and link other prompts, follow the steps below:
1

Create a Text, Image, or PDF Variable

Follow the steps above to create a variable.
2

Choose prompt as source for the variable

Select Prompt as the source type. This enables the variable to use the output from another prompt within your project.
3

Select a prompt from the dropdown

Select a prompt from the dropdown in the Variable Editor. The system will automatically execute the selected prompt and use its output as the variable value.Choose prompt as variable source
Tips: When using prompt variables:
  • Data from the parent dataset is automatically passed down to the referenced prompt
  • Child prompts can reference any column available in the parent dataset
  • The system automatically detects and blocks circular dependencies