Loop

​

What does it do?

Loops let you conditionally repeat parts of your WordApp. You can use them to create complex interactions, like asking the user for input until they give you the right answer, or generating content until it meets a certain criteria.

Loops are a powerful tool for creating dynamic, interactive WordApps. They let you build complex logic into your WordApp, and can help you create more engaging and useful experiences. They also let you take advantage of the full power of AI, by allowing you to iterate on the content it generates. This pattern lives at the core of every agent.

We’ve got some examples of how to make the most of loops in our recipes, specifically the chatbot recipe.

​

How do I use it?

A loop has two parts, a condition and an action. The condition determines how long to repeat the action, and the action is what you want to repeat.

To create a loop, type /loop in the editor, and hit Enter. You’ll be prompted to fill in a name and the condition and action for the loop.

​

Options

A number of options appear in the attributes editor when you create a loop. Here’s what they mean:

​

Label

The name of the loop. You’ll need this later if you want to @mention the output of the loop.

As with a generation, this can be edited in the attributes editor:

Or in the main editor:

​

Loop Type

There are three types of condition you can use to determine when to stop the loop:

Condition type	How it works
Count	Stops after a fixed number of iterations
List	Loops once for every element in a list, giving the action each such element, one at a time
Expression	Choose a condition when the loop should stop repeating, e.g. @user_input = "done"

​

Outputs

Loops produce a list-type output, containing all the outputs produced from the action of the loop.