Get Started

데이터 베이스 노드 사용하기 (Deletor)

데이터 베이스 노드 사용하기 (Deletor)

데이터 베이스 노드 사용하기 (Deletor)

노드 사용법 익히기 - DB 딜리터(DB Deletor) 노드

이 튜토리얼에서는 에이전트리아(Agentria) 의 DB 딜리터(DB Deletor) 노드 사용법을 안내합니다. DB 딜리터 노드는 데이터 스토리지(Data Storage)에 저장된 레코드를 삭제하는 노드입니다. DB 리더 노드로 삭제 대상을 조회하고, 파이썬 노드로 레코드 ID를 추출한 뒤 DB 딜리터 노드에 전달합니다.

이 튜토리얼에서는 고객 이름으로 레코드를 조회하고 해당 고객 데이터를 삭제하는 워크플로를 완성합니다.

사전 준비

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

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

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

  1. DB 리더 노드로 삭제 대상 레코드를 조회할 수 있습니다.

  2. 파이썬 노드로 data_record_id 목록을 추출할 수 있습니다.

  3. DB 딜리터 노드로 데이터 스토리지의 레코드를 삭제할 수 있습니다.

워크플로 개요

이 튜토리얼의 핵심은 DB 딜리터 노드입니다.
DB 딜리터 노드는 data_record_id 배열을 받아 해당하는 레코드를 모두 삭제합니다. 레코드 ID는 DB 리더 노드의 조회 결과에 포함되어 있으며, 파이썬 노드에서 ID만 추출해 전달합니다.
DB 리더 노드의 자세한 사용법은 🔗DB 리더 노드 가이드를 참고하시기 바랍니다.
1단계: 어빌리티 생성
에이전트리아 캔버스에서 새 어빌리티(Ability)를 생성합니다.
캔버스에 +노드 추가(Add Node) 버튼을 사용해 DB 리더(DB Reader) 노드, 파이썬(Python) 노드, DB 딜리터(DB Deletor) 노드, LLM 노드를 추가합니다.
2단계: 인풋 변수 선언
인풋 노드를 더블 클릭하여 노드 편집기(Node Editor)를 엽니다.
스토리지 컬럼 구조에 맞게 인풋 변수를 선언합니다. 이 튜토리얼에서 사용하는 스토리지는 고객 데이터입니다.
변수명
자료형
설명
name
String
조회 기준 고객 이름
phone
String
연락처
grade
String
고객 등급
memo
String
메모
3단계: DB 리더 노드 설정
DB 리더 노드를 더블 클릭하여 노드 편집기를 엽니다. 삭제할 레코드를 먼저 조회합니다.
스토리지 선택
스토리지 선택 버튼을 클릭하면 화면이 열립니다. 고객 데이터가 담긴 스토리지를 선택합니다.
검색 조건 및 페이지 설정
옵션
값
설명
query
$name == @name
고객 이름으로 삭제 대상 레코드 조회
page_size
10
한 번에 조회할 최대 건수
page_number
0
첫 번째 페이지
4단계: 파이썬 노드 설정
파이썬 노드를 더블 클릭하여 노드 편집기를 엽니다.
파이썬 노드에서는 DB 리더 노드가 반환한 레코드 목록에서 data_record_id만 추출하여 삭제할 ID 목록을 만듭니다.
아래 코드를 입력합니다. data_records 변수는 좌측 인풋 영역에서 드래그 앤 드롭으로 가져옵니다.
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 리더 노드의 조회 결과(레코드 목록)
  • map(...) — 각 레코드에서 data_record_id를 추출
  • filter(None, ...) — ID가 없는 항목(None)을 제거
  • output — 삭제할 레코드 ID 목록 반환

중요: 파이썬 노드의 아웃풋 영역에서 output 변수의 자료형을 Array(배열) 로 설정합니다.
5단계: DB 딜리터 노드 설정
DB 딜리터 노드를 더블 클릭하여 노드 편집기를 엽니다.
DB 딜리터 노드는 아래 옵션을 제공합니다.
옵션
필수 여부
설명
storage
필수
삭제할 레코드가 있는 스토리지 선택
data_record_ids
필수
삭제할 레코드 ID 목록 (Array 타입)
스토리지 선택
스토리지 선택 버튼을 클릭하면 화면이 열립니다. 고객 데이터가 담긴 스토리지를 선택합니다.
data_record_ids 설정
data_record_ids 어댑터 변수에 파이썬 노드의 아웃풋 output을 드래그 앤 드롭으로 바인딩합니다.
6단계: LLM 노드 설정 (선택 사항)
삭제 완료 후 결과를 안내 메시지로 출력하기 위해 LLM 노드에 프롬프팅합니다. LLM 노드를 더블 클릭하여 노드 편집기를 열고, 시스템 프롬프트(System Prompt)에 아래 내용을 입력합니다.
LLM 노드는 선택 사항입니다. 생략하면 DB 딜리터 노드의 아웃핀을 아웃풋 노드에 직접 연결합니다.
7단계: 아웃풋 노드 설정
아웃풋 노드를 더블 클릭하여 노드 편집기를 엽니다. 아웃풋 영역(Output Section)에 아래 변수를 추가합니다.
변수명
자료형
result
String
LLM 노드의 아웃풋 output 변수를 드래그 앤 드롭으로 아웃풋 노드의 result에 바인딩합니다.
엣지를 연결합니다.
  1. 인풋 노드의 아웃핀 → DB 리더 노드의 인핀
  2. DB 리더 노드의 아웃핀 → 파이썬 노드의 인핀
  3. 파이썬 노드의 아웃핀 → DB 딜리터 노드의 인핀
  4. DB 딜리터 노드의 아웃핀 → LLM 노드의 인핀
  5. LLM 노드의 아웃핀 → 아웃풋 노드의 인핀
8단계: 런테스트
캔버스 오른쪽 하단의 테스트 실행(RUN TEST) 버튼을 클릭합니다.
삭제할 고객의 이름을 name 입력란에 입력하고 실행하면 해당 고객의 데이터가 삭제됩니다.
9단계: 데이터 스토리지 확인
에이전트리아 메뉴에서 데이터 스토리지를 선택합니다. 해당 고객의 데이터가 삭제된 것을 확인할 수 있습니다.
다음 단계
🎉 축하합니다! 에이전트리아를 사용해 '고객 데이터 삭제' 워크플로를 완성했습니다.
검색 조건을 수정해 여러 건을 한 번에 삭제하거나, DB 라이터 노드와 조합하여 데이터를 정리하고 새로 추가하는 워크플로로 확장할 수 있습니다.
에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.
당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.