노드 사용법 익히기 - DB 리더(DB Reader) 노드

이 튜토리얼에서는 에이전트리아(Agentria) 의 DB 리더(DB Reader) 노드 사용법을 안내합니다. DB 리더 노드는 데이터 스토리지(Data Storage)에 저장된 데이터를 조회하는 노드입니다. 검색 조건을 설정하면 조건에 맞는 레코드를 반환합니다.

이 튜토리얼에서는 고객 이름을 입력받아 고객 데이터 스토리지에서 해당 고객의 정보를 조회하고 출력하는 워크플로를 완성합니다.

사전 준비

에이전트리아 캔버스 진입 방법은 🔗3단계 핵심 가이드를 참고하시기 바랍니다.

DB 리더 노드를 사용하려면 데이터 스토리지가 먼저 구성되어 있어야 합니다. 🔗데이터 스토리지 가이드를 참고하시기 바랍니다.

이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.

1. DB 리더 노드로 데이터 스토리지에서 레코드를 조회할 수 있습니다.

2. $컬럼명 == @변수명 형식으로 검색 조건을 작성할 수 있습니다.

3. 페이지 크기와 페이지 번호로 조회 범위를 설정할 수 있습니다.

4. 조회 결과를 LLM 노드로 가공하여 출력할 수 있습니다.

워크플로 개요

이 튜토리얼의 핵심은 DB 리더 노드입니다.

DB 리더 노드는 지정된 스토리지에서 검색 조건에 맞는 레코드를 조회합니다. $는 스토리지 컬럼을, @는 인풋 변수를 참조하는 단축어로, 이 두 기호를 조합해 조건식을 작성합니다.

1단계: 어빌리티 생성

에이전트리아 캔버스에서 새 어빌리티(Ability)를 생성합니다.

캔버스에 +노드 추가(Add Node) 버튼을 사용해 DB 리더(DB Reader) 노드와 LLM 노드를 추가합니다.

2단계: 인풋 변수 선언

인풋 노드를 더블 클릭하여 노드 편집기(Node Editor)를 엽니다.

이 튜토리얼에서 사용하는 스토리지는 고객 데이터로, 아래와 같은 컬럼 구조를 가집니다. 검색에 활용할 컬럼들을 인풋 변수로 선언합니다.

3단계: DB 리더 노드 설정

DB 리더 노드를 더블 클릭하여 노드 편집기를 엽니다.

DB 리더 노드는 아래 옵션을 제공합니다.

이 튜토리얼에서는 storage, query, page_size, page_number를 설정합니다.

스토리지 선택

스토리지 선택 버튼을 클릭하면 화면이 열립니다. 고객 데이터가 담긴 스토리지를 선택합니다.

검색 조건 작성

query 입력란에 조건식을 작성합니다. 이름으로 검색하는 경우 아래와 같이 입력합니다.

• $ — 데이터 스토리지의 컬럼을 참조합니다

• @ — 인풋 변수를 참조합니다

페이지 설정

4단계: LLM 노드 설정 (선택 사항)

조회된 데이터를 자연스러운 안내 메시지로 출력하기 위해 LLM 노드에 프롬프팅합니다. LLM 노드를 더블 클릭하여 노드 편집기를 열고, 시스템 프롬프트(System Prompt)에 아래 내용을 입력합니다.

LLM 노드는 선택 사항입니다. 생략하면 DB 리더 노드의 아웃핀을 아웃풋 노드에 직접 연결합니다.

5단계: 아웃풋 노드 설정

아웃풋 노드를 더블 클릭하여 노드 편집기를 엽니다. 아웃풋 영역(Output Section)에 아래 변수를 추가합니다.

LLM 노드의 아웃풋 output 변수를 드래그 앤 드롭으로 아웃풋 노드의 result에 바인딩합니다.

엣지를 연결합니다.

1. 인풋 노드의 아웃핀 → DB 리더 노드의 인핀

2. DB 리더 노드의 아웃핀 → LLM 노드의 인핀

3. LLM 노드의 아웃핀 → 아웃풋 노드의 인핀

6단계: 런테스트

캔버스 오른쪽 하단의 테스트 실행(RUN TEST) 버튼을 클릭합니다.

name 입력란에 조회할 고객 이름을 입력하고 실행하면 해당 이름에 대한 고객 정보가 출력됩니다.

다음 단계

🎉 축하합니다! 에이전트리아를 사용해 '고객 데이터 조회' 워크플로를 완성했습니다.

검색 조건을 다양하게 조합하거나, 조회된 결과를 DB 업데이터(DB Updater) 노드로 수정하는 확장 워크플로로 발전시킬 수 있습니다.

에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.

당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.

• 더 많은 어빌리티 예제가 궁금하다면 🔗어빌리티 가이드 페이지를 확인하세요.

• 에이전트 예제를 원한다면 🔗에이전트 가이드 페이지를 확인하세요.