Riferimento Variabili in Agentic Designer - Smart Completion in ConvyAI
Overview
Agentic Designer offre un sistema di Smart Completion per referenziare gli output dei nodi e le variabili di contesto dell'esecuzione in qualsiasi campo che supporta valori dinamici. Invece di scrivere i riferimenti a mano, digitare $ in un campo compatibile apre un menu contestuale che mostra le strutture dati disponibili a quel punto del flusso.
Attivare Smart Completion
Digita $ in qualsiasi campo che supporta riferimenti dinamici. Il menu contestuale appare immediatamente, mostrando i nodi e le variabili di contesto disponibili a monte del nodo corrente.
È supportata anche la bracket notation per i campi in cui la dot notation standard non può essere usata:
$input['<nome campo>']
$('<nome nodo>').output['<nome campo>']
I nodi disabilitati non compaiono nel menu e non vengono conteggiati nella catena $input.
Primo livello - scelta della sorgente
| Riferimento | Punta a |
|---|---|
$input | Accesso rapido all'output del nodo direttamente collegato prima del nodo corrente nel grafo - senza bisogno di conoscerne o specificarne il nome. |
$('<nome_nodo>') | L'output di uno specifico nodo, referenziato direttamente per nome. |
Secondo livello - accesso ai dati del nodo
Una volta selezionata la sorgente, il menu si espande mostrando due sotto-oggetti:
| Sotto-oggetto | Contiene |
|---|---|
context | Metadati del nodo: id, name, timestamp di inizio e fine esecuzione. |
output | I dati prodotti dal nodo (la struttura varia per tipo di nodo). |
Esempio - accesso al body dell'immediato Webhook Trigger precedente (shorthand):
$input.request.body
Esempio - accesso alla risposta di un nodo AI Agent chiamato classifyIntent (riferimento esplicito al nodo):
$('classifyIntent').output.response
Variabili di contesto globale del flusso
Oltre agli output dei nodi, le seguenti variabili sono disponibili in qualsiasi punto del flusso:
| Variabile | Descrizione |
|---|---|
$context.execution_id | Identificatore univoco del run corrente. |
$context.start_execution_timestamp | Timestamp di avvio del run corrente. |
$context.agentic_flow_id | Identificatore univoco dell'Agentic Flow in esecuzione. |
$context.agentic_flow_name | Nome dell'Agentic Flow in esecuzione. |
$context.active | Stato di attivazione del flusso. |
$context.tenant_id | Identificatore della tenant di appartenenza del flusso. |
Navigazione nel menu
- Digita caratteri aggiuntivi dopo
$per filtrare le voci del menu in base al testo inserito - Se il numero di opzioni disponibili supera l'area visibile, appare una scrollbar
- Selezionare una voce dal menu inserisce il riferimento completo nel campo
Variabili mancanti a runtime
Se una variabile referenziata non esiste nel contesto al momento dell'esecuzione (ad esempio perché il nodo precedente non ha prodotto l'output atteso), il suo valore viene sostituito con null. Il run non viene interrotto - il nodo successivo riceve null per quel riferimento.
Concetti chiave
| Termine | Definizione |
|---|---|
| Smart Completion | Sistema di autocompletamento per riferimenti a variabili e output dei nodi nei campi di Agentic Designer. |
$input | Accesso rapido all'output del nodo direttamente collegato prima di quello corrente nel grafo di esecuzione. Usalo quando hai bisogno dei dati del predecessore senza dover specificarne il nome. Usa invece $('<nome nodo>') per referenziare un nodo specifico non adiacente. |
$context | Oggetto che espone le variabili di contesto globale dell'esecuzione corrente. |