データベースノードの使い方（DB Updater）

このチュートリアルでは、AgentriaのDB Updaterノードの使い方をご案内します。DB Updaterノードは、データストレージ（Data Storage）に保存された既存のレコードを修正するノードです。まずDB Readerノードで修正対象のレコードを照会し、Pythonノードで更新データを構成してからDB Updaterノードに渡します。

このチュートリアルでは、顧客名でレコードを照会し、入力した新しい情報でその顧客データを修正するワークフローを完成させます。

事前準備

Agentriaのキャンバス（Canvas）への入り方は、🔗3ステップコアガイドをご参照ください。

DB Updaterノードを使用するには、データストレージを事前に構成しておく必要があります。🔗データストレージガイドをご参照ください。

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

1. DB Readerノードで修正対象のレコードを照会できます。

2. Pythonノードでdata_record_idを含む更新データを構成できます。

3. DB Updaterノードでデータストレージのレコードを修正できます。

ワークフロー概要

このチュートリアルの核心はDB Updaterノードです。

DB Updaterノードはdata_record_idで既存のレコードを識別し、新しい値で上書きします。レコードIDはDB Readerノードの照会結果に含まれており、PythonノードでそれをExtractして更新データを構成します。

DB Readerノードの詳しい使い方は、🔗DB Readerノードガイドをご参照ください。

ステップ1：アビリティの作成

Agentriaのキャンバスで新しいアビリティ（Ability）を作成します。

+ノード追加（Add Node）ボタンを使って、DB Reader（DB Reader）ノード、Python（Python）ノード、DB Updater（DB Updater）ノード、LLMノードをキャンバスに追加します。

ステップ2：インプット変数の宣言

インプットノード（Input Node）をダブルクリックして、ノードエディター（Node Editor）を開きます。

修正するストレージのカラム構造に合わせてインプット変数を宣言します。このチュートリアルで使用するストレージは顧客データです。

ステップ3：DB Readerノードの設定

DB Readerノードをダブルクリックして、ノードエディターを開きます。まず修正対象のレコードを照会します。

ストレージの選択

ストレージ選択ボタンをクリックすると画面が開きます。顧客データが入ったストレージを選択します。

検索条件とページ設定

ステップ4：Pythonノードの設定

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

Pythonノードでは、DB Readerノードが返したレコードリストからdata_record_idを抽出し、入力した新しい値で更新データを構成します。

以下のコードを入力します。各変数は左側のインプット領域からドラッグ＆ドロップ（Drag and Drop）で入力します。

data_records = {{data_records}}
phone = {{phone}}
memo = {{memo}}
grade = {{grade}}

record_items = [
    {
        "data_record_id": record.get("data_record_id"),
        "name": record.get("name", ""),
        "phone": phone,
        "grade": grade,
        "memo": memo
    }
    for record in data_records
    if record.get("data_record_id")
]

return {"output": record_items}

data_records = {{data_records}}
phone = {{phone}}
memo = {{memo}}
grade = {{grade}}

record_items = [
    {
        "data_record_id": record.get("data_record_id"),
        "name": record.get("name", ""),
        "phone": phone,
        "grade": grade,
        "memo": memo
    }
    for record in data_records
    if record.get("data_record_id")
]

return {"output": record_items}

data_records = {{data_records}}
phone = {{phone}}
memo = {{memo}}
grade = {{grade}}

record_items = [
    {
        "data_record_id": record.get("data_record_id"),
        "name": record.get("name", ""),
        "phone": phone,
        "grade": grade,
        "memo": memo
    }
    for record in data_records
    if record.get("data_record_id")
]

return {"output": record_items}

コードロジックの説明：

• data_records — DB Readerノードの照会結果（レコードリスト）

• data_record_id — 修正するレコードを識別する固有ID（DB Readerノードの出力に含まれる）

• name — 既存レコードの名前をそのまま保持

• phone、grade、memo — インプット変数から受け取った新しい値に置き換え

重要： Pythonノードのアウトプット領域で、output変数の型を**Array（配列）**に設定します。

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

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

DB Updaterノードは以下のオプションを提供します。

ストレージの選択

ストレージ選択ボタンをクリックすると画面が開きます。顧客データが入ったストレージを選択します。

record_itemsの設定

record_itemsアダプター変数に、Pythonノードのアウトプットoutputをドラッグ＆ドロップでバインドします。

ステップ6：LLMノードの設定（任意）

修正完了後に結果を案内メッセージとして出力するために、LLMノードにプロンプトを設定します。LLMノードをダブルクリックしてノードエディターを開き、システムプロンプト（System Prompt）に以下の内容を入力します。

LLMノードは任意です。省略する場合は、DB Updaterノードのアウトピンをアウトプットノードのインピンに直接接続します。

ステップ7：アウトプットノードの設定

アウトプットノード（Output Node）をダブルクリックして、ノードエディターを開きます。アウトプット領域（Output Section）に以下の変数を追加します。

LLMノードのアウトプット変数outputを、アウトプットノードのresultにドラッグ＆ドロップでバインドします。

エッジを接続します。

1. インプットノードのアウトピン → DB Readerノードのインピン

2. DB Readerノードのアウトピン → Pythonノードのインピン

3. Pythonノードのアウトピン → DB Updaterノードのインピン

4. DB Updaterノードのアウトピン → LLMノードのインピン

5. LLMノードのアウトピン → アウトプットノードのインピン

ステップ8：Run Test

キャンバス右下のRUN TESTボタンをクリックします。

照会基準の顧客名と修正する新しい情報を入力して実行すると、該当する顧客のデータが更新されます。

ステップ9：データストレージの確認

Agentriaのメニューからデータストレージを選択します。該当する顧客の情報が修正されていることを確認できます。

次のステップ

🎉 おめでとうございます！ Agentriaを使って「顧客データ修正」ワークフローを完成させました。

検索条件を変更して複数件を一度に修正したり、DB Deletorノードを追加して不要なレコードを削除するワークフローへ発展させることができます。

Agentriaは、アイデアを現実に変える可能性の空間です。

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

• より多くのアビリティ例が気になる方は 🔗アビリティガイド をご確認ください。

• エージェント例を見たい方は 🔗エージェントガイド をご確認ください。