Skip to main content
Content variables provide a centralized way to define contextual data—such as user profiles, customer IDs, or language preferences—and share it across agents, prompts, tools, and workflows in an Agentic App.

Overview

Instead of repeating the same contextual logic in every agent or prompt, content variables let you define key–value pairs once and reference them wherever needed. When referenced, the Platform resolves all keys in the content object, fetches any dynamic values (such as memory variables), and makes the data available in the session history. This eliminates redundant memory lookups and ensures consistent data access across all agents. Example Suppose multiple agents need user details. Instead of having each agent query the memory store separately, create a content variable group called UserContext:
KeyValue
username{{memory.userdetails.name}}
location{{memory.userdetails.location}}
preferredLang{{memory.userdetails.preferredLang}}
Reference it in the Supervisor prompt:
The user details are available as {{content.UserContext}}.
The Platform resolves and adds all values to the session history. Downstream agents access the already-resolved data directly—for example:
Use the user's preferred language to answer queries.

When to Use Content Variables

Use content variables when:
  • Multiple agents need access to the same contextual data.
  • You want to bundle related fields into a single logical object.
  • You want to avoid repeated memory lookups across agents or prompts.

Create a Content Variable

  1. Go to Settings > Content.
  2. Click + New Content.
  3. Fill in the following fields:
    FieldDescription
    NameUnique identifier for the content variable.
    Display NameDisplay name shown in the UI.
    DescriptionBrief description of the variable’s purpose.
    Contextual InformationKey–value pairs that define the variable. Values can be static strings or dynamic references to memory stores or environment variables.
  4. Click Create.

Access Content Variables

Use the following format to reference a content variable in prompts, tools, or workflows:
{{content.<content-name>.<key>}}
Example: A content variable named guidelines with a key prefLang is referenced as:
{{content.guidelines.prefLang}}