노드 사용법 익히기 - DB 업데이터(DB Updater) 노드

이 튜토리얼에서는 에이전트리아(Agentria) 의 DB 업데이터(DB Updater) 노드 사용법을 안내합니다. DB 업데이터 노드는 데이터 스토리지(Data Storage)에 저장된 기존 레코드를 수정하는 노드입니다. 먼저 DB 리더 노드로 수정 대상 레코드를 조회한 뒤, 파이썬 노드로 업데이트할 데이터를 구성하여 DB 업데이터 노드에 전달합니다.

이 튜토리얼에서는 고객 이름으로 레코드를 조회하고, 입력한 새 정보로 해당 고객의 데이터를 수정하는 워크플로를 완성합니다.

사전 준비

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

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

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

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

2. 파이썬 노드로 data_record_id를 포함한 업데이트 데이터를 구성할 수 있습니다.

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

워크플로 개요

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

DB 업데이터 노드는 data_record_id로 기존 레코드를 식별하고 새 값으로 덮어씁니다. 레코드 ID는 DB 리더 노드의 조회 결과에 포함되어 있으며, 파이썬 노드에서 이를 추출하여 업데이트 데이터를 구성합니다.

DB 리더 노드의 자세한 사용법은 🔗DB 리더 노드 가이드를 참고하시기 바랍니다.

1단계: 어빌리티 생성

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

캔버스에 +노드 추가(Add Node) 버튼을 사용해 DB 리더(DB Reader) 노드, 파이썬(Python) 노드, DB 업데이터(DB Updater) 노드, LLM 노드를 추가합니다.

2단계: 인풋 변수 선언

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

수정할 스토리지의 컬럼 구조에 맞게 인풋 변수를 선언합니다. 이 튜토리얼에서 사용하는 스토리지는 고객 데이터입니다.

3단계: DB 리더 노드 설정

DB 리더 노드를 더블 클릭하여 노드 편집기를 엽니다. 수정할 레코드를 먼저 조회합니다.

스토리지 선택

스토리지 선택 버튼을 클릭하여 스토리지를 선택합니다.

검색 조건 및 페이지 설정

4단계: 파이썬 노드 설정

파이썬 노드를 더블 클릭하여 노드 편집기를 엽니다.

파이썬 노드에서는 DB 리더 노드가 반환한 레코드 목록에서 data_record_id를 추출하고, 입력받은 새 값으로 업데이트 데이터를 구성합니다.

아래 코드를 입력합니다. 각 변수는 좌측 인풋 영역에서 드래그 앤 드롭으로 가져옵니다.

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 리더 노드의 조회 결과(레코드 목록)

• data_record_id — 수정할 레코드를 식별하는 고유 ID (DB 리더 노드 출력에 포함)

• name — 기존 레코드의 이름을 그대로 유지

• phone, grade, memo — 인풋 변수에서 받은 새 값으로 교체

중요: 파이썬 노드의 아웃풋 영역에서 output 변수의 자료형을 Array(배열) 로 설정합니다.

5단계: DB 업데이터 노드 설정

DB 업데이터 노드를 더블 클릭하여 노드 편집기를 엽니다.

DB 업데이터 노드는 아래 옵션을 제공합니다.

스토리지 선택

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

record_items 설정

record_items 어댑터 변수에 파이썬 노드의 아웃풋 output을 드래그 앤 드롭으로 바인딩합니다.

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

수정 완료 후 결과를 안내 메시지로 출력하기 위해 LLM 노드에 프롬프팅합니다. LLM 노드를 더블 클릭하여 노드 편집기를 열고, 시스템 프롬프트(System Prompt)에 아래 내용을 입력합니다.

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

7단계: 아웃풋 노드 설정

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

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

엣지를 연결합니다.

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

2. DB 리더 노드의 아웃핀 → 파이썬 노드의 인핀

3. 파이썬 노드의 아웃핀 → DB 업데이터 노드의 인핀

4. DB 업데이터 노드의 아웃핀 → LLM 노드의 인핀

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

8단계: 런테스트

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

조회 기준 고객 이름과 수정할 새 정보를 입력하고 실행하면 해당 고객의 데이터가 업데이트됩니다.

9단계: 데이터 스토리지 확인

에이전트리아 메뉴에서 데이터 스토리지를 선택합니다. 해당 고객의 정보가 수정된 것을 확인할 수 있습니다.

다음 단계

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

검색 조건을 변경해 여러 건을 한 번에 수정하거나, DB 딜리터(DB Deletor) 노드를 추가해 불필요한 레코드를 삭제하는 워크플로로 확장할 수 있습니다.

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

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

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

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