Variable References in Agentic Designer - Smart Completion in ConvyAI
Overview
Agentic Designer provides a Smart Completion system for referencing node outputs and execution context variables in any field that supports dynamic values. Rather than writing references by hand, typing $ in a compatible field opens a contextual menu that shows the available data structures at that point in the flow.
Activating Smart Completion
Type $ in any field that supports dynamic references. The contextual menu appears immediately, showing the nodes and context variables available upstream of the current node.
Bracket notation is also supported for fields where standard dot notation cannot be used:
$input['<field name>']
$('<node name>').output['<field name>']
Disabled nodes do not appear in the menu and are not counted in the $input chain.
First level - choosing a source
| Reference | Points to |
|---|---|
$input | Quick access to the output of the node directly connected before the current node in the graph - no need to know or specify its name. |
$('<node_name>') | The output of a specific named node, referenced directly by name. |
Second level - accessing node data
Once a source node is selected, the menu expands to show two sub-objects:
| Sub-object | Contains |
|---|---|
context | Node metadata: id, name, start timestamp, end timestamp. |
output | The data produced by the node (structure varies by node type). |
Example - accessing the body from the immediately preceding Webhook Trigger (shorthand):
$input.request.body
Example - accessing the response from an AI Agent node named classifyIntent (explicit node reference):
$('classifyIntent').output.response
Global flow context variables
In addition to node outputs, the following variables are available anywhere in the flow:
| Variable | Description |
|---|---|
$context.execution_id | Unique identifier of the current run. |
$context.start_execution_timestamp | Timestamp of when the current run started. |
$context.agentic_flow_id | Unique identifier of the Agentic Flow currently executing. |
$context.agentic_flow_name | Name of the Agentic Flow currently executing. |
$context.active | Active state of the flow. |
$context.tenant_id | ID of the tenant this flow belongs to. |
Navigating the menu
- Type additional characters after
$to filter the menu by the text entered - If the number of available options exceeds the visible area, a scrollbar appears
- Selecting an item from the menu inserts the full reference into the field
Missing variables at runtime
If a referenced variable does not exist in the context at execution time (for example, because the upstream node did not produce the expected output), its value is substituted with null. The run is not interrupted - the downstream node receives null for that reference.
Key concepts
| Term | Definition |
|---|---|
| Smart Completion | The autocomplete system for variable and node output references in Agentic Designer fields. |
$input | Quick access to the output of the node directly connected before the current one in the execution graph. Use it when you need the predecessor's data without caring about its name. Use $('<node name>') instead when you need to reference a specific non-adjacent node. |
$context | Object exposing global execution variables for the current run. |