Add loops to steps
Running a step in a loop
By default, when running a Tool, each tool step is executed once. However, Relevance supports running a step multiple times in a loop as well.
Loops
Imagine a scenario where we wish to run a step across a set of items. For instance, a list of topics, for each we need to generate a description using a large language model. Or a list of movie names for each we want to generate a summary.
- Access loops under the three-dot menu on the top right of steps. Click on Enable foreach.
Run this transformation multiple times
is the input field that expects a list of items (e.g. list of movie names). Provide the input list manually or activate the variable mode as shown in the image below.
and use {{variable-name}}
to access an existing variable in the Tool, for instance {{movies}}
.
- Access every single item from your input list within a step via
{{ foreach.item }}
or/and{{ foreach.index }}
. In the image below, there is a Python step returning a list of items. We wish to run a large language model on each of the elements with the instruction “Write me a … ”.
After enabling Foreach, under Run this transformation multiple times
, we enable the variable mode and access
the Python step output via {{python.transformed}}
- note that the name of the step is python
in our example.
Next, we use {{foreach.item}}
to access each of the elements in the list.
After running the step, we will have as many output tabs as the number of elements in the input list.