🇮🇹 IT

🔽 Filter

Filtra un array per conservare solo gli elementi che corrispondono a una condizione. Usalo dopo una query RAG, una richiesta HTTP o un Loop che produce una lista, per restringere i risultati prima di passarli a un altro step.

Categoria: Manipolazione Dati · Identificatore tipo: filter

Panoramica

Quando un workflow riceve un grande array di elementi — risultati di ricerca, ordini, utenti, voci di log — spesso ne serve solo un sottoinsieme. Il nodo Filter permette di ridurre quell'array ai soli elementi rilevanti usando una semplice condizione, prima di passarlo a un Loop, un Agent o qualsiasi step successivo.

Si specifica un nome di proprieta su ogni elemento dell'array e lo si confronta con un valore usando uno degli operatori integrati. La condizione viene valutata una volta per elemento. Gli elementi per cui risulta vera vengono conservati; tutti gli altri vengono scartati. Il risultato filtrato e i conteggi degli elementi sono poi disponibili per gli step successivi tramite la sintassi standard di output dello step.

Configurazione

Campo	Stato	Descrizione
Array	Obbligatorio	Riferimento all'array da filtrare, ad es. `{{ search.output.results }}`.
Condition Field	Obbligatorio	Il nome della proprieta su ogni elemento dell'array da valutare, ad es. `score`.
Operator	Obbligatorio	Operatore di confronto — `equals`, `not_equals`, `greater_than`, `less_than`, `contains`, `not_contains`, `is_null`, `is_not_null`, `is_empty`, `is_not_empty`.
Value	Opzionale	Il valore con cui confrontare. Non necessario per `is_null`, `is_not_null`, `is_empty`, `is_not_empty`.

Dati di Output

Il nodo Filter espone i seguenti campi nel suo output dello step:

Campo	Tipo	Descrizione
`items`	array	Array filtrato contenente solo gli elementi che corrispondono alla condizione.
`count`	number	Numero di elementi nell'array filtrato.
`excluded_count`	number	Numero di elementi rimossi dal filtro.

Esempio di Utilizzo

Aggiungi un nodo RAG (chiave step: search) che restituisce un array di oggetti risultato, ciascuno con una proprieta score.
Aggiungi un nodo Filter. Imposta Array su {{ search.output.results }}, Condition Field su score, Operator su greater_than e Value su 0.8.
Aggiungi un Logic Gate dopo il filtro per verificare che {{ filter.output.count }} sia greater_than 0 prima di continuare.
Aggiungi un nodo Agent sul ramo true e passagli {{ filter.output.items }} — l'agent ora elabora solo corrispondenze ad alta affidabilita.

Suggerimenti e Note

Filtra prima di iterare. Posizionare un Filter prima di un Loop riduce il numero di iterazioni e mantiene il corpo del loop piu semplice rispetto a controllare le condizioni al suo interno.
Un risultato vuoto e valido. Se nessun elemento corrisponde, items e un array vuoto e count e 0. Usa un Logic Gate dopo il Filter per gestire il caso di risultato vuoto in modo appropriato.
Operatori null-safe. Usa is_null o is_not_null per filtrare gli elementi dove un campo potrebbe essere assente, evitando errori che si verificherebbero con un confronto diretto.
Concatenare i filtri. Puoi posizionare piu nodi Filter in sequenza per applicare diverse condizioni indipendenti — ciascuno restringe ulteriormente l'array.

Nodi Correlati

Loop — itera sull'array filtrato per elaborare ogni elemento rimanente.
Logic Gate — verifica il conteggio del filtro prima di procedere, o applica condizioni a livello di riga all'interno di un loop.
Set Variable — memorizza o trasforma i dati prima di filtrare.
RAG — fonte comune di array che beneficiano del filtraggio basato sul punteggio.