> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raycaster.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Variable Resolution

> Harness the power of Raycaster's custom variable resolution using the '@' key to scale your research

<div class="mt-4 bg-gradient-to-br from-[#4F5DFF10] to-[#7B85FF15] rounded-xl p-6 pb-8 border border-[#4F5DFF20]">
  <h1 class="text-2xl font-bold mb-2">Custom Variable Resolution</h1>
  <p class="text-lg opacity-80 mb-4">Leverage the '@' key to dynamically access and utilize data across your workspace for powerful, context-aware analysis.</p>

  <div class="flex items-center gap-3 mb-4">
    <div class="bg-[#4F5DFF15] p-3 rounded-lg flex items-center justify-center">
      <span class="text-[#4F5DFF] text-xl font-bold">@</span>
    </div>

    <div>
      <h3 class="font-medium">Dynamic References</h3>
      <p class="text-sm opacity-75">Reference any data point across your tables with simple '@' syntax</p>
    </div>
  </div>

  <div class="flex items-center gap-3 mb-4">
    <div class="bg-[#4F5DFF15] p-3 rounded-lg">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" class="w-6 h-6 text-[#4F5DFF]">
        <path fillRule="evenodd" d="M12 1.5a5.25 5.25 0 00-5.25 5.25v3a3 3 0 00-3 3v6.75a3 3 0 003 3h10.5a3 3 0 003-3v-6.75a3 3 0 00-3-3v-3c0-2.9-2.35-5.25-5.25-5.25zm3.75 8.25v-3a3.75 3.75 0 10-7.5 0v3h7.5z" clipRule="evenodd" />
      </svg>
    </div>

    <div>
      <h3 class="font-medium">Contextual Intelligence</h3>
      <p class="text-sm opacity-75">Build smarter prompts that adapt based on your data context</p>
    </div>
  </div>

  <div class="flex items-center gap-3">
    <div class="bg-[#4F5DFF15] p-3 rounded-lg">
      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" class="w-6 h-6 text-[#4F5DFF]">
        <path d="M21.731 2.269a2.625 2.625 0 00-3.712 0l-1.157 1.157 3.712 3.712 1.157-1.157a2.625 2.625 0 000-3.712zM19.513 8.199l-3.712-3.712-12.15 12.15a5.25 5.25 0 00-1.32 2.214l-.8 2.685a.75.75 0 00.933.933l2.685-.8a5.25 5.25 0 002.214-1.32L19.513 8.2z" />
      </svg>
    </div>

    <div>
      <h3 class="font-medium">Workflow Automation</h3>
      <p class="text-sm opacity-75">Streamline complex processes with variable-driven templates</p>
    </div>
  </div>
</div>

## What is Custom Variable Resolution?

Think of Custom Variable Resolution as a smart way to "fill in the blanks" in your documents and templates. It's like having a personal assistant who knows exactly where to find all your information and can instantly place it wherever you need it.

### In Simple Terms

Custom Variable Resolution is a feature that lets you insert information from your data tables into your documents or messages by simply typing the '@' symbol followed by the name of the data you want to insert.

**Real-World Example:** It's similar to how mail merge works in word processors, but much more powerful. Instead of just inserting names and addresses, you can pull in any piece of information from any table in your workspace.

<div class="bg-blue-50 dark:bg-blue-900/20 p-4 rounded-lg mb-6">
  <h4 class="font-medium text-blue-700 dark:text-blue-300 mb-2">Everyday Analogy</h4>
  <p>Imagine you're writing a birthday card to a friend. Instead of writing "Happy Birthday" generically, you could write "Happy \[AGE] Birthday, \[NAME]!" Now imagine if those brackets automatically filled with the correct information for each friend. That's what Custom Variable Resolution does, but for all your business data.</p>
</div>

## Why Use Custom Variable Resolution?

Here's how Custom Variable Resolution helps you in everyday tasks:

1. **Save time** - Stop copying and pasting data between documents and tables
2. **Reduce errors** - Automatically insert accurate information without typos
3. **Personalize at scale** - Create customized documents for hundreds of contacts with a single template
4. **Keep information updated** - When your source data changes, all references update automatically
5. **Create smarter templates** - Build documents that adapt based on the data they contain

## How Custom Variable Resolution Works - Step by Step

<div class="bg-gradient-to-r from-[#4F5DFF08] to-transparent p-1 rounded-xl mb-6">
  <div class="flex flex-col md:flex-row gap-4 p-3">
    <div class="flex-1 border border-[#4F5DFF20] bg-white dark:bg-gray-900 rounded-lg p-4 relative overflow-hidden">
      <div class="absolute top-0 left-0 w-full h-1 bg-[#4F5DFF]" />

      <div class="flex items-center mb-2">
        <div class="bg-[#4F5DFF] text-white w-6 h-6 rounded-full flex items-center justify-center mr-3 text-sm font-semibold">1</div>
        <h3 class="font-medium">Type the '@' Symbol</h3>
      </div>

      <p class="text-sm pl-9">Start by typing the '@' symbol wherever you want to insert data from your tables. This tells Raycaster you want to reference some information.</p>
    </div>

    <div class="flex-1 border border-[#4F5DFF20] bg-white dark:bg-gray-900 rounded-lg p-4 relative overflow-hidden">
      <div class="absolute top-0 left-0 w-full h-1 bg-[#4F5DFF]" />

      <div class="flex items-center mb-2">
        <div class="bg-[#4F5DFF] text-white w-6 h-6 rounded-full flex items-center justify-center mr-3 text-sm font-semibold">2</div>
        <h3 class="font-medium">Choose What Data to Insert</h3>
      </div>

      <p class="text-sm pl-9">After typing '@', a helpful menu appears showing you all the tables and data fields you can choose from. Simply select the information you want to insert.</p>
    </div>
  </div>

  <div class="flex flex-col md:flex-row gap-4 p-3">
    <div class="flex-1 border border-[#4F5DFF20] bg-white dark:bg-gray-900 rounded-lg p-4 relative overflow-hidden">
      <div class="absolute top-0 left-0 w-full h-1 bg-[#4F5DFF]" />

      <div class="flex items-center mb-2">
        <div class="bg-[#4F5DFF] text-white w-6 h-6 rounded-full flex items-center justify-center mr-3 text-sm font-semibold">3</div>
        <h3 class="font-medium">Raycaster Fills in the Data</h3>
      </div>

      <p class="text-sm pl-9">When your document is used, Raycaster automatically replaces all the '@' references with the actual information from your tables.</p>
    </div>

    <div class="flex-1 border border-[#4F5DFF20] bg-white dark:bg-gray-900 rounded-lg p-4 relative overflow-hidden">
      <div class="absolute top-0 left-0 w-full h-1 bg-[#4F5DFF]" />

      <div class="flex items-center mb-2">
        <div class="bg-[#4F5DFF] text-white w-6 h-6 rounded-full flex items-center justify-center mr-3 text-sm font-semibold">4</div>
        <h3 class="font-medium">Your Document Changes with Your Data</h3>
      </div>

      <p class="text-sm pl-9">As your data changes in your tables, any document using that data through '@' references will automatically update to show the latest information.</p>
    </div>
  </div>
</div>

## How to Use the '@' Symbol - Simple Examples

Here are some basic ways to use the '@' symbol to pull in your data:

<div class="bg-slate-50 dark:bg-slate-800/50 p-4 rounded-lg mb-2">
  <p class="font-medium mb-1">What you type:</p>
  <p class="bg-white dark:bg-slate-700 p-2 rounded font-mono text-sm">I'm writing to @ <span class="text-green-500 italic">(search menu appears)</span> Company about your services.</p>

  <p class="font-medium mb-1 mt-4">What gets inserted in your document:</p>
  <p class="bg-white dark:bg-slate-700 p-2 rounded font-mono text-sm">I'm writing to {"{{"}Company{"}}"}  about your services.</p>

  <p class="font-medium mb-1 mt-4">What the AI sees:</p>
  <p class="bg-white dark:bg-slate-700 p-2 rounded font-mono text-sm">I'm writing to Acme Corporation about your services.</p>
</div>

<p class="text-sm text-slate-600 dark:text-slate-400 mt-2">
  When you type "@", a search menu appears, allowing you to find and select the variable you need. Once selected, it's displayed as {"{{"}Company{"}}"}  in your document, but will be replaced with the actual value when viewed.
</p>

<Frame>
  <img src="https://mintcdn.com/raycaster/dEhs8Du7OeRsZOdB/images/variable-resolution-panel.png?fit=max&auto=format&n=dEhs8Du7OeRsZOdB&q=85&s=872b894463076e3b18de326a4f0a55cc" alt="Variable resolution interface showing picker, values, and debugging tools" class="rounded-lg border border-gray-200 dark:border-gray-700" data-path="images/variable-resolution-panel.png" />
</Frame>

## Real-World Examples - How People Use Custom Variable Resolution

### Example 1: Research-Focused Patent Analysis

<div class="bg-slate-50 dark:bg-slate-800/50 p-4 rounded-lg mb-4">
  <p class="font-medium mb-2">Template:</p>

  <div class="bg-white dark:bg-slate-700 p-3 rounded">
    <p class="font-medium">Subject: Analysis of {"{{"}patent\_number{"}}"}  patent</p>
    <p class="mt-2">I need to analyze the {"{{"}patent\_number{"}}"}  patent titled "{"{{"}patent\_title{"}}"}" filed by {"{{"}inventor{"}}"}.</p>
    <p class="mt-2">This patent appears to cover innovations in the {"{{"}technology\_field{"}}"}  domain, particularly regarding {"{{"}key\_innovation{"}}"}.</p>
    <p class="mt-2">Please provide:</p>
    <p class="mt-1">1. A summary of the main claims in this patent</p>
    <p class="mt-1">2. An analysis of how this compares to similar patents in the {"{{"}technology\_field{"}}"}  space</p>
    <p class="mt-1">3. Potential applications beyond what's explicitly stated in the patent</p>
    <p class="mt-2">Please focus your analysis on how this might impact research in {"{{"}research\_focus{"}}"}.</p>
  </div>

  <p class="font-medium mt-4 mb-2">Filled Example:</p>

  <div class="bg-white dark:bg-slate-700 p-3 rounded">
    <p class="font-medium">Subject: Analysis of US10984584B2 patent</p>
    <p class="mt-2">I need to analyze the US10984584B2 patent titled "Method and system for neural network based image enhancement" filed by Sarah Chen.</p>
    <p class="mt-2">This patent appears to cover innovations in the computer vision domain, particularly regarding real-time image enhancement using adaptive neural networks.</p>
    <p class="mt-2">Please provide:</p>
    <p class="mt-1">1. A summary of the main claims in this patent</p>
    <p class="mt-1">2. An analysis of how this compares to similar patents in the computer vision space</p>
    <p class="mt-1">3. Potential applications beyond what's explicitly stated in the patent</p>
    <p class="mt-2">Please focus your analysis on how this might impact research in medical imaging diagnostics.</p>
  </div>
</div>

### Example 2: Academic Publication Research

<div class="bg-slate-50 dark:bg-slate-800/50 p-4 rounded-lg mb-4">
  <p class="font-medium mb-2">Template:</p>

  <div class="bg-white dark:bg-slate-700 p-3 rounded">
    <p class="font-medium text-lg">Research Analysis: {"{{"}publication\_title{"}}"}</p>
    <p class="mt-2">Authors: {"{{"}authors{"}}"}  </p>
    <p class="mt-2">Journal: {"{{"}journal\_name{"}}"}  ({"{{"}publication\_date{"}}"} )</p>
    <p class="mt-2">DOI: {"{{"}doi{"}}"}  </p>
    <p class="mt-2">Keywords: {"{{"}keywords{"}}"}  </p>
    <p class="mt-2"><strong>Research Questions:</strong></p>
    <p class="mt-1">1. How does the methodology in this paper compare to {"{{"}comparison\_paper{"}}"}?</p>
    <p class="mt-1">2. What are the key limitations identified in this study?</p>
    <p class="mt-1">3. How might these findings apply to {"{{"}application\_field{"}}"}?</p>
    <p class="mt-2"><strong>Synthesis Task:</strong></p>
    <p class="mt-1">Integrate these findings with our current understanding of {"{{"}research\_topic{"}}"}  and propose potential next research directions.</p>
  </div>

  <p class="font-medium mt-4 mb-2">Filled Example:</p>

  <div class="bg-white dark:bg-slate-700 p-3 rounded">
    <p class="font-medium text-lg">Research Analysis: Large Language Models as Zero-Shot Reasoners</p>
    <p class="mt-2">Authors: Kojima, T., Gu, S.S., Reid, M., Matsuo, Y. and Iwasawa, Y.</p>
    <p class="mt-2">Journal: Nature Machine Intelligence (2023)</p>
    <p class="mt-2">DOI: 10.1038/s42256-022-00593-2</p>
    <p class="mt-2">Keywords: large language models, reasoning, zero-shot learning, chain-of-thought</p>
    <p class="mt-2"><strong>Research Questions:</strong></p>
    <p class="mt-1">1. How does the methodology in this paper compare to Brown et al. (2020) on few-shot prompting?</p>
    <p class="mt-1">2. What are the key limitations identified in this study?</p>
    <p class="mt-1">3. How might these findings apply to medical diagnosis assistance?</p>
    <p class="mt-2"><strong>Synthesis Task:</strong></p>
    <p class="mt-1">Integrate these findings with our current understanding of prompt engineering techniques and propose potential next research directions.</p>
  </div>
</div>

## Getting Started Today

Ready to try Custom Variable Resolution? Here's how to get started:

1. **Start simple** - Begin by creating a basic template with just one or two '@' references
2. **Experiment** - Try different types of references to see how they work
3. **Create templates** - Once you're comfortable, create templates for your common tasks
4. **Share with your team** - Help others save time by sharing your useful templates

Custom Variable Resolution is one of the most powerful ways to save time and ensure consistency and scale your work with Raycaster. The '@' key is your gateway to smarter, more efficient documents.
