Learning to Use Nodes — Set Value Node

This tutorial walks you through the Set Value node in Agentria. The Set Value node sets a global variable value using an expression. Enter an expression in the Set Value field and select a global variable in the to field — the result of the expression is stored in the selected global variable.

In this tutorial, you will build a "+1 Counter" workflow that starts the global variable num at 0, increments it by 1 using the Set Value node, and returns the final value once num reaches 10. The Loop node is used alongside to verify that the Set Value node correctly updates the global variable on each iteration.

Before You Begin

For instructions on how to enter the Agentria Canvas, refer to the 🔗3-Step Core Guide.

After completing this tutorial, you will be able to:

1. Configure the Set Value (expression) and to fields of the Set Value node.

2. Build a workflow that updates a global variable value using an expression.

3. Set multiple global variables at once using +Add Item.

Workflow Overview

The core of this tutorial is the Set Value node.

The Set Value node evaluates the num + 1 expression on every iteration and stores the result in the global variable num. Without the Set Value node updating the global variable, the Loop node would always evaluate the condition against the initial value and the loop would never end. By updating num each iteration, the Loop node can check the latest value.

For detailed usage of the Loop node used in this tutorial, refer to the 🔗Loop Node Guide.

Step 1: Create an Ability

Create a new Ability on the Agentria Canvas.

Step 2: Arrange and Connect the Workflow

Add the following nodes to the Canvas and arrange them as shown in the image.

• Set Value node: Click +Add Node → select from the Data category.

• Loop node: Click +Add Node → select from the Flow Control category.

Once arranged, connect the edges in the following order.

1. Out-Pin of Start Node → In-Pin of Set Value node

2. Out-Pin of Set Value node → In-Pin of Loop node

3. pass pin of Loop node → In-Pin of End Node

4. loop pin of Loop node → In-Pin of Set Value node

Step 3: Open the Global Variables Tab

Open the left side panel on the Canvas and navigate to the Global Variables tab. Click + to start adding a global variable.

Step 4: Declare a Global Variable

Configure the global variable as follows.

num is the counter's starting value. This tutorial uses the global variable's default value (0) as the counter's initial value.

Step 5: Configure the Set Value Node

Double-click the Set Value node to open the Node Editor.

The Set Value node provides the following options.

Setting the Expression

Enter the following expression in the Set Value field. Drag and drop num from Ability Variables on the left to complete it.

num + 1 adds 1 to the current value of the global variable num.

Setting the Target Variable (to)

Select the global variable num in the to field. With this configuration, the result of the num + 1 expression is stored in the global variable num on every iteration.

Setting Multiple Variables at Once

Click +Add Item in the Node Editor to add a new Set Value / to row. This lets you update multiple global variables in a single node.

Step 6: Configure the Loop Node

Double-click the Loop node to open the Node Editor.

The Loop node checks the condition against the global variable num updated by the Set Value node.

Enter the following expression in the Loop Condition field. Drag and drop num from Ability Variables to complete it.

While num < 10 is true, the flow returns to the Set Value node via the loop pin. When num reaches 10, the condition becomes false and the flow proceeds to the End Node via the pass pin.

Step 7: Check the Start Node

This tutorial uses the global variable's default value (0) as the counter's initial value, so no Input variables need to be declared in the Start Node. Leave the Start Node as is.

Step 8: Configure the End Node

Double-click the End Node to open the Node Editor.

Add the following variable in the Output Section.

Drag and drop num from Ability Variables to bind it to result.

Step 9: Run the Ability Test

Click the Run Test button in the bottom-right corner of the Canvas. Proceed through Run Test → Run Test → Run to execute the full test.

The global variable num starts at 0. The Set Value node evaluates num + 1 and updates num, then the Loop node checks the num < 10 condition. When num reaches 10, the condition becomes false and the flow proceeds to the End Node via the pass pin.

Confirm that result: 10 is returned.

Step 10: Review Execution Results

In the Execution Monitor panel of the test window, review the step-by-step execution results of each node.

Next Steps

🎉 Congratulations! You've successfully built the "+1 Counter" workflow using Agentria.

Try updating multiple global variables at once using +Add Item, or change the expression to build more complex state management workflows.

Agentria is a place where ideas become reality—your workflow can expand infinitely with your creativity.

• For more Ability examples, visit the 🔗Ability Guide.

• For Agent-based examples, visit the 🔗Agent Guide.