Extracted Variables

​

Types of Extraction

​

1. AI Extracted Variables (Conversation Nodes)

• Extraction Method: llm_function_calling
• Extraction Prompt: Natural language description of what to extract
• Data Type: string, number, boolean, array, or object
• Required: Whether the node depends on this extraction succeeding

Variable: customer_name
Extraction Prompt: "Extract the customer's full name from their response"
Data Type: string
Required: true

​

2. Toolpath Extracted Variables (Tool & Web Tool Nodes)

• User format: $.path.to.value (JSONPath)
• Backend format: result.path.to.value (converted automatically)
• Validation: Against actual (API) or expected (Web) response
• Response format: JSON object or plain string

$.data.user.email          → Nested field
$.items[0].name            → First item
$.results[*].id            → All IDs
$.data.prices[?(@.active)] → Filter
$                          → Entire response (for string)

1. Object (JSON): Use paths like $.data.user, $.data.items[0]
2. String: Use $ to get the full string

​

API Tool Nodes

1. Click Test Tool to run with real data
2. Use the path selector on the actual response
3. Browse the tree, click a field to set the JSONPath
4. Check the preview and save

​

Web Tool Nodes

1. Define expected response: Paste JSON object or string
2. Open the path selector and use that structure
3. Click fields to set paths and preview
4. Manually test the web tool to confirm the real response matches

{
  "cart": {
    "total": 149.99,
    "items": [{"name": "Product A", "price": 49.99}],
    "item_count": 2
  }
}

• API: Test first, then configure extraction; test success and error shapes
• Web: Define a realistic expected structure; document object vs string; test manually

​

3. DTMF Captured Variables (Conversation & Start Nodes)

• Enable DTMF Capture: Toggle in node settings
• Variable Name: Name for the captured value
• Sync: Automatically added to extracted variables

Variable: account_number
DTMF Capture: Enabled
Description: "DTMF captured input"

​

Extraction Availability

• ✅ Nodes that run after the node that created the variable
• ❌ Nodes that run before or in parallel
• ❌ Global nodes (isGlobal: true)