Get Started
ノードの使い方 — 値設定（Set Value）ノード
このチュートリアルでは、Agentriaの値設定（Set Value）ノードの使い方を説明します。値設定ノードは、表現式を使ってグローバル変数の値を設定するノードです。Set Value欄に表現式を入力し、to項目で保存先のグローバル変数を選択すると、表現式の結果がグローバル変数に反映されます。
このチュートリアルでは、グローバル変数numを0からスタートし、値設定ノードで1ずつ増加させ、numが10に達したら最終値を返す「+1カウンター」ワークフローを完成させます。ループ（Loop）ノードは、値設定ノードがグローバル変数を更新していることを確認するために併用します。
事前準備
Agentriaキャンバスへの進入方法については、🔗3ステップコアガイドをご参照ください。
このチュートリアルを完了すると、以下のことができるようになります。
値設定ノードの
Set Value（式）とto項目を設定できます。表現式でグローバル変数の値を更新するワークフローを構成できます。
+項目追加で複数のグローバル変数を一度に設定できます。
ワークフロー概要
このチュートリアルの中心は値設定ノードです。
値設定ノードは毎回の繰り返しでnum + 1の表現式を評価し、グローバル変数numに結果を保存します。値設定ノードがグローバル変数を更新しないと、ループノードは常に初期値を基準に条件を評価してしまい、ループが終了しません。値設定ノードがnumを更新することで、ループノードは毎回最新の値を基準に条件を確認できます。
このチュートリアルで使用するループノードの詳しい使い方は、🔗ループノードガイドをご参照ください。
ステップ1：アビリティの作成
Agentriaキャンバスで新しいアビリティ（Ability）を作成します。
ステップ2：ワークフローの配置と接続
キャンバスに以下のノードを追加し、画像のように配置します。
値設定（Set Value）ノード：
+ノード追加（Add Node）→データカテゴリから追加します。ループ（Loop）ノード：
+ノード追加（Add Node）→フロー制御カテゴリから追加します。
配置が完了したら、以下の順序でエッジ（Edge）を接続します。
スタートノード（Start Node）のアウトピン（Out-Pin）→ 値設定ノードのインピン（In-Pin）
値設定ノードのアウトピン → ループノードのインピン
ループノードの passピン → エンドノード（End Node）のインピン
ループノードの loopピン → 値設定ノードのインピン
ステップ3：グローバル変数タブを開く
キャンバス左のサイドパネルを開き、グローバル変数タブへ進みます。+をクリックしてグローバル変数の追加を開始します。
ステップ4：グローバル変数の宣言
以下のようにグローバル変数を設定します。
項目 | 値 |
|---|---|
データ型 | Integer（整数） |
名前 |
|
初期値 |
|
numはカウンターの開始値です。このチュートリアルでは、グローバル変数の初期値（0）をカウンターの開始値として使用します。
ステップ5：値設定ノードの設定
値設定ノードをダブルクリック（Double Click）してノードエディター（Node Editor）を開きます。
値設定ノードは以下の項目を提供します。
項目 | 必須/任意 | 説明 |
|---|---|---|
| 必須 | グローバル変数に設定する表現式。左側の |
| 必須 | 表現式の結果を保存するグローバル変数を選択 |
Set Value（式）の設定
Set Value入力欄に以下の表現式を入力します。左側のAbility Variablesにあるnumをドラッグ＆ドロップで持ってきて式を完成できます。
num + 1はグローバル変数numの現在の値に1を加える表現式です。
to（保存先変数）の設定
to項目でグローバル変数numを選択します。この設定により、num + 1の表現式の結果が毎回の繰り返しでグローバル変数numに保存されます。
複数のグローバル変数を同時に設定
ノードエディターで+項目追加をクリックすると、新しいSet Value / toの行が追加されます。この方法で複数のグローバル変数を一度に設定できます。
ステップ6：ループノードの設定
ループノードをダブルクリックしてノードエディターを開きます。
ループノードは、値設定ノードが更新したグローバル変数numを基準に条件を確認します。
オプション | 値 |
|---|---|
|
|
最大繰り返し回数 |
|
Loop Condition入力欄に以下の条件式を入力します。Ability Variablesのnumをドラッグ＆ドロップで持ってきて条件式を完成できます。
num < 10が真の間はloopピンを通じて値設定ノードへ戻り繰り返します。numが10に達すると条件が偽になり、passピンを通じてエンドノードへ進みます。
ステップ7：スタートノードの確認
このチュートリアルではグローバル変数の初期値（0）をカウンターの開始値として使用するため、スタートノードにインプット（Input）変数を別途宣言する必要はありません。スタートノードはデフォルトの状態のままにします。
ステップ8：エンドノードの設定
エンドノードをダブルクリックしてノードエディターを開きます。
アウトプット領域（Output Section）に以下の変数を追加します。
変数名 | 型 |
|---|---|
| Integer（整数） |
Ability Variablesのnumをドラッグ＆ドロップでresultにバインドします。
ステップ9：アビリティテストの実行
キャンバス右下のテスト実行ボタンをクリックします。テスト実行 → テスト実行 → 実行の順に進めると、全体のランテストが実行されます。
グローバル変数numは0からスタートします。値設定ノードがnum + 1を評価してnumを更新し、ループノードがnum < 10の条件を確認します。numが10に達すると条件が偽になり、passピンを通じてエンドノードへ進みます。
繰り返し | num（条件確認前） | 値設定（num + 1） | num（更新後） | 条件（num < 10） |
|---|---|---|---|---|
1回目 | 0 | +1 | 1 | 真（loop） |
2回目 | 1 | +1 | 2 | 真（loop） |
3回目 | 2 | +1 | 3 | 真（loop） |
4回目 | 3 | +1 | 4 | 真（loop） |
5回目 | 4 | +1 | 5 | 真（loop） |
6回目 | 5 | +1 | 6 | 真（loop） |
7回目 | 6 | +1 | 7 | 真（loop） |
8回目 | 7 | +1 | 8 | 真（loop） |
9回目 | 8 | +1 | 9 | 真（loop） |
10回目 | 9 | +1 | 10 | 真（loop） |
11回目 | 10 | — | — | 偽（pass） |
最終結果としてresult: 10が返されることを確認します。
ステップ10：実行結果の確認
テスト実行画面の実行モニターで、各ノードの実行結果をステップごとに確認できます。
次のステップ
🎉 おめでとうございます！ Agentriaを使って「+1カウンター」ワークフローを完成させました。
+項目追加で複数のグローバル変数を同時に更新したり、表現式を変更することで、より複雑な状態管理ワークフローを構成できます。
Agentriaは、アイデアを現実に変える可能性の空間です。
あなたのアイデア次第で、ワークフローは無限に広がります。