🇮🇹 IT

🔄 Transform

Ristruttura i dati da qualsiasi passaggio precedente in una nuova struttura. Definisci un insieme di campi di output denominati, ciascuno con un'espressione di valore che può referenziare passaggi precedenti. Usa Transform per rinominare chiavi, combinare campi, estrarre valori annidati o preparare i dati esattamente nella forma che un passaggio successivo si aspetta.

Categoria: Recupero ed Elaborazione Dati · Identificatore tipo: transform

Panoramica

I dati reali raramente arrivano nella forma esatta di cui hai bisogno. Un'API potrebbe restituire un oggetto profondamente annidato quando ti servono solo due campi al livello superiore. Un trigger potrebbe portare nome e cognome separatamente quando ti servono combinati. Un passaggio potrebbe produrre una chiave chiamata user_identifier quando il passaggio successivo se la aspetta come id.

Il nodo Transform risolve tutti questi problemi. Dichiari un elenco di campi di output, dando a ciascuno un nome e un valore. Il valore può essere una stringa statica, un numero, un riferimento diretto a variabile di un campo di un passaggio precedente, o una combinazione di valori costruita con la sintassi delle variabili. L'output del nodo Transform è un oggetto pulito contenente esattamente i campi che hai definito.

Transform è puramente un passaggio di ristrutturazione dati — non effettua chiamate esterne, non esegue inferenza AI e non produce effetti collaterali. Riesce sempre, a condizione che le variabili referenziate esistano.

Configurazione

Il nodo Transform viene configurato tramite il suo elenco Fields. Ogni voce nell'elenco diventa una chiave nell'oggetto di output.

Sotto-campo	Descrizione
Name	Il nome della chiave per questo campo nell'oggetto di output. Usa nomi chiari e descrittivi in `snake_case` (es. `full_name`, `email_address`, `total_price`).
Type	Il tipo di dato a cui convertire il valore: `string`, `number`, `boolean`, `array` o `object`. Flusso converte il valore in questo tipo quando possibile.
Value	L'espressione di valore per questo campo. Può essere un valore statico (es. `active`), un riferimento diretto a variabile (es. `{{ api_call.output.body.user.email }}`), o un template che combina testo e variabili (es. `Hello, {{ trigger.output.first_name }} {{ trigger.output.last_name }}`).

Dati di Output

Il nodo Transform produce un singolo oggetto contenente tutti i campi che hai definito. Ogni chiave nell'oggetto di output corrisponde a una voce nell'elenco Fields.

// Se hai definito campi denominati: full_name, email, total_price {{ transform_step.output.full_name }} {{ transform_step.output.email }} {{ transform_step.output.total_price }}

Esempio di Utilizzo

Combinare nome e cognome in un nome completo

Il payload del trigger fornisce first_name e last_name separatamente. Un passaggio successivo (una notifica email) necessita di un campo full_name.

// Definizione del campo: Name: full_name Type: string Value: {{ trigger.output.first_name }} {{ trigger.output.last_name }} // Risultato nell'output del nodo Transform: {{ transform.output.full_name }} → "Jane Smith"

Estrarre campi annidati da una risposta API

Un HTTP Request restituisce una risposta JSON profondamente annidata. Vuoi un oggetto piatto con solo i campi di cui il tuo Agent ha bisogno.

// Struttura della risposta API (da api_call.output.body): { "data": { "user": { "profile": { "email": "jane@example.com", "display_name": "Jane Smith" }, "account": { "plan": "pro", "credits_remaining": 142 } } } } // Definizione dei campi Transform: Name: email Value: {{ api_call.output.body.data.user.profile.email }} Name: display_name Value: {{ api_call.output.body.data.user.profile.display_name }} Name: plan Value: {{ api_call.output.body.data.user.account.plan }} Name: credits Value: {{ api_call.output.body.data.user.account.credits_remaining }} Type: number // Output pulito accessibile nei passaggi successivi: {{ transform.output.email }} → "jane@example.com" {{ transform.output.credits }} → 142

Rinominare chiavi per un'API downstream

I tuoi dati hanno una chiave chiamata customer_identifier ma la prossima chiamata API si aspetta userId.

Name: userId Type: string Value: {{ previous_step.output.customer_identifier }}

Suggerimenti e Note

Usa Transform per ripulire prima di passare a un Agent. Gli Agent producono i migliori risultati quando il loro prompt contiene dati puliti e pertinenti. Usa Transform per eliminare i campi non necessari dalle risposte API prima di includerli in un prompt.
Conversione di tipo. Se un valore arriva come stringa come "142" ma deve essere un numero per un passaggio successivo, imposta il Type su number e Flusso lo convertirà automaticamente.
Combina con Set Variable per stato mutabile. Transform produce un'istantanea fissa. Se hai bisogno di accumulare o aggiornare valori attraverso più iterazioni (es. in un loop), usa un nodo Set Variable in aggiunta o in alternativa.
Puoi referenziare qualsiasi passaggio precedente. L'espressione di valore può referenziare qualsiasi passaggio già eseguito nel workflow — non solo il passaggio immediatamente precedente. Puoi estrarre campi dal trigger, da una chiamata API due passaggi indietro e dall'output precedente del passaggio corrente, tutto nello stesso nodo Transform.

Nodi Correlati

HTTP Request — recupera dati da un'API la cui risposta potresti voler trasformare.
Schema Extractor — usa un modello AI per estrarre dati strutturati da testo non strutturato.