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

このチュートリアルでは、AgentriaのDB Deletorノードの使い方をご案内します。DB Deletorノードは、データストレージ（Data Storage）に保存されたレコードを削除するノードです。DB Readerノードで削除対象を照会し、PythonノードでレコードIDを抽出してからDB Deletorノードに渡します。

このチュートリアルでは、顧客名でレコードを照会し、該当する顧客データを削除するワークフローを完成させます。

事前準備

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

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

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

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

2. Pythonノードでdata_record_idのリストを抽出できます。

3. DB Deletorノードでデータストレージのレコードを削除できます。

ワークフロー概要

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

DB Deletorノードはdata_record_idの配列を受け取り、該当するレコードをすべて削除します。レコードIDはDB Readerノードの照会結果に含まれており、PythonノードでIDのみを抽出して渡します。

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

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

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

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

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

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

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

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

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

ストレージの選択

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

検索条件とページ設定

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

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

Pythonノードでは、DB Readerノードが返したレコードリストからdata_record_idのみを抽出し、削除するIDリストを作成します。

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

data_records = {{data_records}}

data_record_ids = list(
    filter(
        None,
        map(lambda record: record.get("data_record_id"), data_records)
    )
)

return {"output": data_record_ids}

data_records = {{data_records}}

data_record_ids = list(
    filter(
        None,
        map(lambda record: record.get("data_record_id"), data_records)
    )
)

return {"output": data_record_ids}

data_records = {{data_records}}

data_record_ids = list(
    filter(
        None,
        map(lambda record: record.get("data_record_id"), data_records)
    )
)

return {"output": data_record_ids}

コードロジックの説明：

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

• map(...) — 各レコードからdata_record_idを抽出

• filter(None, ...) — IDが存在しない項目（None）を除去

• output — 削除するレコードIDのリストを返す

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

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

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

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

ストレージの選択

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

data_record_idsの設定

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

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

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

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

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

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

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

エッジを接続します。

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

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

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

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

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

ステップ8：Run Test

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

削除したい顧客の名前をname入力欄に入力して実行すると、該当する顧客データが削除されます。

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

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

次のステップ

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

検索条件を変更して複数件を一度に削除したり、DB Writerノードと組み合わせて古いレコードを整理しながら新しいデータを追加するワークフローへ発展させることができます。

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

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

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

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