Get Started
노드 사용법 익히기 - 슬립 페이지 읽기(Slip Page Read) 노드
슬립 페이지 읽기(Slip Page Read) 노드는 슬립박스(Slipbox)에 저장된 페이지를 UUID 기준으로 조회하여 페이지 내용을 워크플로에서 활용할 수 있게 해주는 노드입니다.
이 튜토리얼에서는 슬립박스에 시스템 프롬프트를 페이지로 저장해두고, 슬립 페이지 읽기 노드로 해당 내용을 불러와 고객 리뷰에 자동으로 답장 초안을 생성하는 '고객 리뷰 대응 봇' 어빌리티 워크플로를 완성합니다.
사전 준비
이 튜토리얼을 시작하기 전에 프로젝트에 슬립박스가 구축되어 있어야 합니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다.
이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.
슬립박스에 페이지를 만들고
페이지 ID를 확인할 수 있습니다.슬립 페이지 읽기 노드에 슬립박스를 연결할 수 있습니다.
슬립 페이지 읽기 노드의
slip_public_uuid에 페이지 ID를 바인딩할 수 있습니다.슬립 페이지 읽기 노드의 출력값
slip_content를 다른 노드에서 참조할 수 있습니다.노드 테스트로 슬립박스 기반 동적 프롬프트 워크플로를 확인할 수 있습니다.
워크플로 개요
이 튜토리얼의 핵심은 슬립 페이지 읽기 노드입니다.
슬립 페이지 읽기 노드는 지정한 슬립박스에서 UUID에 해당하는 페이지를 조회하여 본문(slip_content), 제목(title) 등을 출력합니다. 이 튜토리얼에서는 전역변수로 저장해 둔 페이지 ID를 바인딩하여, 슬립박스에 저장된 시스템 프롬프트를 동적으로 불러옵니다.
함께 등장하는 LLM 노드는 조회한 시스템 프롬프트와 고객 리뷰를 참조해 답장 초안을 생성하는 역할만 담당합니다.
1단계: 어빌리티 생성
새 어빌리티를 생성합니다. 이름에 슬립 페이지 읽기 노드, 설명에 시스템 프롬프트 관리를 입력합니다. 슬립박스로 시스템 프롬프트를 관리하며 고객 리뷰에 자동 응답하는 '고객 리뷰 대응 봇' 워크플로를 이 어빌리티에서 구성합니다.
2단계: 슬립박스 만들기
좌측 사이드바의 슬립박스 메뉴로 진입해 +슬립박스 만들기를 클릭합니다. 이름에 System Prompt를 입력하고 만들기를 클릭합니다.
슬립박스를 만드는 자세한 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다.
3단계: 슬립 페이지 작성 및 페이지 ID 복사
System Prompt 슬립박스에 고객 리뷰 대응 봇 페이지를 만들고, 고객 리뷰를 분석해 답장 초안을 생성하는 시스템 프롬프트 내용을 작성합니다.
왜 슬립박스로 관리할까요? 시스템 프롬프트는 정적인 값이라 어빌리티를 버전 배포하고 나면 수정이 어렵습니다. 슬립박스 페이지로 관리하면 배포 이후에도 내용을 손쉽게 업데이트할 수 있습니다.
우측 세부 정보 패널에서 페이지 ID 값을 복사해둡니다. 이 값은 다음 단계에서 사용합니다.
4단계: 전역변수 선언
전역 변수(Global Variable) 탭에서 String 타입의 slip_page_id 변수를 추가합니다. 기본값에 앞서 복사해 둔 페이지 ID를 붙여넣습니다.
5단계: 시작 노드 설정
시작 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 review_text 변수를 추가하고, 고객 리뷰 원문을 입력받도록 설정합니다.
6단계: 슬립 페이지 읽기 노드 설정
+노드 추가(Add Node) → 슬립박스(Slipbox) 카테고리에서 슬립 페이지 읽기 노드를 추가하고, 더블 클릭하여 노드 편집기로 진입합니다.
슬립 페이지 읽기 노드는 아래 옵션을 제공합니다.
옵션 | 필수 여부 | 설명 |
|---|---|---|
| 필수 | 읽을 슬립이 속한 대상 슬립박스를 선택합니다. |
| 필수 | 읽어올 슬립의 공개 UUID입니다. |
슬립박스 공개 UUID 항목에서 System Prompt 슬립박스를 선택합니다. slip_public_uuid 항목에는 slip_page_id 변수를 드래그 앤 드롭으로 바인딩합니다.
노드가 정상 실행되면 slip_content, title, page_type, tags, current_version, slip_public_uuid, error_code, error_message 를 출력합니다. 이 튜토리얼에서는 페이지 본문에 해당하는 slip_content를 사용합니다.
7단계: LLM 노드 설정
고객 리뷰 대응 봇(LLM 노드)을 더블 클릭하여 노드 편집기로 진입합니다. 사용할 크레덴셜을 선택합니다.
시스템 프롬프트 영역에는 슬립 페이지 읽기 노드의 slip_content를 드래그 앤 드롭으로 배치합니다. 사용자 프롬프트 영역에는 review_text를 드래그 앤 드롭으로 배치합니다.
이렇게 구성하면 슬립박스 관리를 통해 시스템 프롬프트값을 배포 이후에도 동적으로 관리할 수 있습니다.
8단계: 종료 노드 설정
종료 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 CS 출력변수를 추가하고, 고객 리뷰 대응 봇(LLM 노드)의 output을 드래그 앤 드롭으로 바인딩합니다.
9단계: 노드 테스트 실행
review_text에 사이즈가 잘못 왔어요. 교환해주세요.를 입력하고 테스트 실행(RUN TEST)을 클릭합니다. 리뷰의 감정을 부정으로 분석하고, 그에 맞는 답장 초안을 생성하는 것을 확인할 수 있습니다.
10단계: 디버그 로그 확인
슬립 페이지 읽기 노드의 디버그 로그를 확인하면 error_code가 SUCCESS로 반환되고, slip_content에 System Prompt 슬립박스에 작성해 둔 페이지 내용이 그대로 담겨 있는 것을 확인할 수 있습니다. 슬립박스에 저장한 페이지를 실제로 읽어와 워크플로에 활용했음을 알 수 있습니다.
다음 단계
🎉 축하합니다! 에이전트리아를 사용해 '고객 리뷰 대응 봇' 워크플로를 완성했습니다.
시스템 프롬프트뿐 아니라 안내 문구, 정책 문서 등 자주 업데이트되는 텍스트도 슬립박스 페이지로 관리하면 배포 이후에도 유연하게 수정할 수 있습니다.
에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.
당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.