Skip to main content

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​

ReferencePoints to
$inputQuick 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-objectContains
contextNode metadata: id, name, start timestamp, end timestamp.
outputThe 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:

VariableDescription
$context.execution_idUnique identifier of the current run.
$context.start_execution_timestampTimestamp of when the current run started.
$context.agentic_flow_idUnique identifier of the Agentic Flow currently executing.
$context.agentic_flow_nameName of the Agentic Flow currently executing.
$context.activeActive state of the flow.
$context.tenant_idID of the tenant this flow belongs to.
  • 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​

TermDefinition
Smart CompletionThe autocomplete system for variable and node output references in Agentic Designer fields.
$inputQuick 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.
$contextObject exposing global execution variables for the current run.