Agentria is a collaborative, automation-focused development platform designed for organizations that need workflow automation. Its intuitive interface allows both developers and non-developers to build AI agents easily.

What are the key advantages of Agentria?

Agentria provides enterprise-grade AI agent-building capabilities, including built-in data storage, API deployment, and RAG-based workflows optimized for corporate environments.

What can you build with Agentria?

With Agentria, you can build conversational AI agents, workflow automation agents, evaluation and review agents, and domain-specific business agents — a wide range of agentic AI systems.

Get Started

データノードの使い方 (Set Value)

ノードの使い方 — 値設定（Set Value）ノード

このチュートリアルでは、Agentriaの値設定（Set Value）ノードの使い方を説明します。値設定ノードは、グローバル変数の値を設定するノードです。グローバル変数項目で更新するグローバル変数を選択し、設定値欄に値または式を入力すると、結果がグローバル変数に反映されます。

このチュートリアルでは、グローバル変数numを0からスタートし、値設定ノードで1ずつ増加させ、numが10に達したら最終値を返す「+1カウンター」ワークフローを完成させます。ループ（Loop）ノードは、値設定ノードがグローバル変数を更新していることを確認するために併用します。

事前準備

Agentriaキャンバスへの進入方法については、🔗3ステップコアガイドをご参照ください。

このチュートリアルを完了すると、以下のことができるようになります。

値設定ノードのグローバル変数と設定値項目を設定できます。
表現式でグローバル変数の値を更新するワークフローを構成できます。
+項目追加で複数のグローバル変数を一度に設定できます。

ワークフロー概要

このチュートリアルの中心は値設定ノードです。

値設定ノードは毎回の繰り返しで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`

numはカウンターの開始値です。このチュートリアルでは、グローバル変数の初期値（0）をカウンターの開始値として使用します。

ステップ5：値設定ノードの設定

値設定ノードをダブルクリック（Double Click）してノードエディター（Node Editor）を開きます。

値設定ノードは以下の項目を提供します。

項目	必須/任意	説明
`グローバル変数`	必須	更新するグローバル変数を選択
`設定値`	必須	グローバル変数に設定する値または式を入力。左側の`Ability Variables`の変数をドラッグ＆ドロップで持ってきて式を完成できます

グローバル変数の設定

グローバル変数項目でグローバル変数numを選択します。

設定値の入力

設定値入力欄に以下の表現式を入力します。左側のAbility Variablesにあるnumをドラッグ＆ドロップで持ってきて式を完成できます。

num + 1はグローバル変数numの現在の値に1を加える表現式です。この設定により、num + 1の表現式の結果が毎回の繰り返しでグローバル変数numに保存されます。

複数のグローバル変数を同時に設定

ノードエディターで+項目追加をクリックすると、新しいグローバル変数 / 設定値の行が追加されます。この方法で複数のグローバル変数を一度に設定できます。

`設定値`で使用できる関数と表現式

値設定ノードの設定値では、四則演算だけでなく、以下の組み込み関数と定数を表現式として使用できます。変数と組み合わせることで、平均計算・四捨五入・並べ替え・長さ取得などの処理をノード1つで行うことができます。

使用できる関数と定数

分類	関数/定数	説明	使用例
型変換	`str()`	文字列に変換	`str(123)` → `"123"`
	`int()`	整数に変換	`int("42")` → `42`
	`float()`	実数に変換	`float("3.14")` → `3.14`
	`bool()`	ブール値に変換	`bool(0)` → `False`
	`list()`	リストに変換	`list("abc")` → `['a','b','c']`
	`dict()`	辞書に変換	`dict(a=1, b=2)` → `{'a':1,'b':2}`
	`tuple()`	タプルに変換	`tuple([1,2])` → `(1, 2)`
	`set()`	集合に変換	`set([1,1,2])` → `{1, 2}`
数学/集計	`len()`	長さ	`len(items)` → `3`
	`abs()`	絶対値	`abs(-5)` → `5`
	`min()`	最小値	`min(3, 7, 1)` → `1`
	`max()`	最大値	`max(a, b, c)`
	`sum()`	合計	`sum(scores)`
	`round()`	四捨五入	`round(price * 1.1, 2)`
シーケンス操作	`sorted()`	並べ替え	`sorted(items, reverse=True)`
	`reversed()`	逆順	`list(reversed(items))`
	`enumerate()`	インデックス+値	`list(enumerate(items))`
	`zip()`	まとめる	`list(zip(keys, vals))`
	`range()`	数値の範囲	`list(range(5))` → `[0,1,2,3,4]`
定数	`True`	真	`bool(x) == True`
	`False`	偽	`flag or False`
	`None`	Null値	`value or None`

活用例

複数の関数を組み合わせることで、よく使う処理をコードノードなしに1行の表現式で記述できます。

目的	表現式
平均計算	`sum(scores) / len(scores)`
税込み価格	`round(price * 1.1, 2)`
重複除去後の件数	`len(set(items))`
降順並べ替え	`sorted(values, reverse=True)`
最大値-最小値の差	`max(nums) - min(nums)`
文字列を数値に変換して+1	`int(text_value) + 1`

上記リストにない関数は使用できません。複雑なロジックが必要な場合は、🔗コードノード（Python）をご使用ください。

ステップ6：ループノードの設定

ループノードをダブルクリックしてノードエディターを開きます。

ループノードは、値設定ノードが更新したグローバル変数numを基準に条件を確認します。

オプション	値
`Loop Condition`	`num < 10`
最大繰り返し回数	`20`

Loop Condition入力欄に以下の条件式を入力します。Ability Variablesのnumをドラッグ＆ドロップで持ってきて条件式を完成できます。

num < 10が真の間はloopピンを通じて値設定ノードへ戻り繰り返します。numが10に達すると条件が偽になり、passピンを通じてエンドノードへ進みます。

ステップ7：スタートノードの確認

このチュートリアルではグローバル変数の初期値（0）をカウンターの開始値として使用するため、スタートノードにインプット（Input）変数を別途宣言する必要はありません。スタートノードはデフォルトの状態のままにします。

ステップ8：エンドノードの設定

エンドノードをダブルクリックしてノードエディターを開きます。

アウトプット領域（Output Section）に以下の変数を追加します。

変数名	型
`result`	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は、アイデアを現実に変える可能性の空間です。

あなたのアイデア次第で、ワークフローは無限に広がります。

より多くのアビリティ例が気になる方は 🔗アビリティガイドをご確認ください。
エージェント例を見たい方は 🔗エージェントガイドをご確認ください。