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

このチュートリアルでは、AgentriaのDB Readerノードの使い方をご案内します。DB Readerノードは、データストレージ（Data Storage）に保存されたデータを照会するノードです。検索条件を設定すると、条件に一致するレコードを返します。

このチュートリアルでは、顧客名を入力として受け取り、顧客データストレージから該当する顧客情報を照会して出力するワークフローを完成させます。

事前準備

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

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

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

1. DB Readerノードでデータストレージからレコードを照会できます。

2. $カラム名 == @変数名形式で検索条件を記述できます。

3. ページサイズとページ番号で照会範囲を設定できます。

4. 照会結果をLLMノードで加工して出力できます。

ワークフロー概要

[

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

DB Readerノードは、指定したストレージから検索条件に一致するレコードを照会します。$はストレージのカラムを、@はインプット変数を参照する短縮記号で、この2つの記号を組み合わせて条件式を記述します。

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

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

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

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

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

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

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

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

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

このチュートリアルではstorage、query、page_size、page_numberを設定します。

ストレージの選択

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

検索条件の記述

query入力欄に条件式を記述します。名前で検索する場合は以下のように入力します。

• $ — データストレージのカラムを参照します

• @ — インプット変数を参照します

ページ設定

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

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

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

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

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

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

エッジを接続します。

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

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

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

ステップ6：Run Test

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

nameの入力欄に照会したい顧客名を入力して実行すると、該当する顧客情報が出力されます。

次のステップ

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

複数の検索条件を組み合わせたり、照会結果をDB Updaterノードに渡して編集するワークフローへ発展させることができます。

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

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

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

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