슬립 본문 덧붙이기 노드
노드 사용법 익히기 - 슬립 본문 덧붙이기(Slip Append) 노드
슬립 본문 덧붙이기(Slip Append) 노드는 지정한 슬립의 본문 끝에 새 섹션을 덧붙이는 노드입니다. 기존 내용은 서버가 그대로 보존하므로 본문 전체를 다시 보낼 필요가 없고, 새로 추가할 내용만 전달하면 됩니다. 같은 제목의 슬립이 이미 있어 슬립 생성(Slip Create)이 거부됐을 때, 새로 만드는 대신 기존 슬립에 이어 쓰는 용도로 특히 유용합니다.
이 노드는 에이전트에 도구로 연결해 활용하기도 좋지만, 이 튜토리얼에서는 가장 기본적인 사용법을 확인할 수 있도록 어빌리티에서 다룹니다. 에이전트에 연결하는 방법은 별도의 슬립박스 에이전트 통합 가이드에서 다룰 예정입니다. 이 튜토리얼에서는 미리 만들어 둔 '문의 대응 기록' 슬립에, 새로 접수된 고객 문의 내용을 이어서 기록하는 어빌리티 워크플로를 완성합니다.
사전 준비
이 튜토리얼을 시작하기 전에 프로젝트에 슬립박스가 구축되어 있고, 내용을 덧붙일 대상 슬립이 이미 만들어져 있어야 합니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다.
이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.
슬립 본문 덧붙이기 노드로 기존 슬립의 본문 끝에 새 섹션을 추가할 수 있습니다.
슬립 본문 덧붙이기 노드의 각 입력 변수를 시작 노드의 입력값과 연결할 수 있습니다.
덧붙인 내용의 출처를 함께 기록할 수 있습니다.
런테스트와 디버그 로그로 내용이 정상적으로 덧붙여졌는지 확인할 수 있습니다.
워크플로 개요
이 튜토리얼의 핵심은 슬립 본문 덧붙이기 노드입니다.
슬립 본문 덧붙이기 노드는 대상 슬립의 공개 UUID로 슬립을 지정하고, 전달한 마크다운 섹션을 본문 끝에 추가합니다. 기존 본문은 전혀 건드리지 않으며, 덧붙일 때마다 슬립의 버전이 하나씩 올라갑니다.
슬립 본문 덧붙이기 노드 기본 정보
슬립 본문 덧붙이기 노드는 아래 옵션을 제공합니다.
옵션 | 필수 여부 | 설명 |
|---|---|---|
| 필수 | 덧붙일 슬립이 속한 슬립박스를 선택합니다. |
| 필수 | 덧붙일 대상 슬립의 UUID입니다. 검색·조회·읽기 노드 출력에서 받습니다. |
| 필수 | 본문 끝에 붙일 마크다운 섹션입니다. 새로 추가할 내용만 적습니다 — 기존 본문은 서버가 그대로 보존합니다. |
| 선택 | 덧붙인 내용의 출처(문서명·URL·발화자)입니다. 섹션 아래에 출처 한 줄로 기록됩니다. |
이 튜토리얼에서는 네 항목을 모두 사용합니다.
1단계: 어빌리티 생성
새 어빌리티를 생성합니다. 이름에 슬립 본문 덧붙이기 노드, 설명에 문의 대응 기록 이어쓰기를 입력합니다. 슬립 본문 덧붙이기 노드를 사용해 이미 만들어 둔 '문의 대응 기록' 슬립에 새 문의 내용을 이어서 기록하는 워크플로를 이 어빌리티에서 구성합니다.
2단계: 시작 노드 설정
시작 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 변수 세 개를 추가합니다.
uuid: 덧붙일 대상 슬립의 UUID를 입력받습니다. (String)text: 본문 끝에 덧붙일 마크다운 섹션을 입력받습니다. (String)ref: 덧붙인 내용의 출처를 입력받습니다. (String)
3단계: 슬립 본문 덧붙이기 노드 추가
+노드 추가(Add Node) → 슬립박스(Slipbox) 카테고리에서 슬립 본문 덧붙이기 노드를 추가합니다.
4단계: 슬립 본문 덧붙이기 노드 설정
슬립 본문 덧붙이기 노드를 더블 클릭하여 노드 편집기로 진입합니다. 대상 슬립박스에서 에이전트리아 Docs를 선택합니다.
나머지 항목에는 아래와 같이 시작 노드의 입력값을 드래그 앤 드롭으로 바인딩합니다.
어댑터 변수 | 바인딩 값 |
|---|---|
|
|
|
|
|
|
노드가 정상 실행되면 slip_public_uuid(덧붙인 슬립의 UUID), current_version(덧붙인 뒤의 버전 번호), error_code, error_message를 출력합니다.
5단계: 종료 노드 설정
종료 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 result 출력변수를 추가하고 슬립 본문 덧붙이기 노드의 error_code를 드래그 앤 드롭으로 바인딩합니다. 이렇게 하면 내용이 정상적으로 덧붙여졌는지 실패했는지를 출력값으로 확인할 수 있습니다.
6단계: 테스트 슬립 준비 및 UUID 복사
에이전트리아 Docs 슬립박스로 이동해 슬립 추가 버튼으로 테스트용 슬립을 하나 새로 만듭니다. 제목과 본문을 간단히 입력해 저장한 뒤, 우측 정보 패널에서 슬립의 공개 UUID를 복사해둡니다. 이 값은 런테스트에서 uuid 입력값으로 사용합니다.
7단계: 런테스트 실행
uuid에는 앞서 복사한 슬립의 공개 UUID를 붙여넣습니다. text에는 본문 끝에 덧붙일 내용을 마크다운 섹션으로 작성합니다.
ref에는 문서화 테스트를 입력하고 테스트 실행(RUN TEST)을 클릭합니다. result 출력값으로 SUCCESS가 나오면 성공입니다.
8단계: 디버그 로그 확인
슬립 본문 덧붙이기 노드의 디버그 로그를 확인하면 error_code가 SUCCESS로 반환된 세부 내역과, 함께 반환된 current_version 값을 확인할 수 있습니다. 덧붙이기 전 버전보다 1만큼 올라가 있습니다.
9단계: 슬립박스에서 결과 확인
에이전트리아 Docs 슬립박스로 이동해 방금 만든 테스트 슬립을 열어보면, 기존에 있던 내용은 그대로 남아있고 그 아래에 방금 작성한 ## 9월 22일 문의 섹션이 추가된 것을 확인할 수 있습니다. 섹션 바로 아래에는 출처 표기에 입력한 카카오톡 상담 - 홍길동이 이탤릭체로 한 줄 기록됩니다.
다음 단계
🎉 축하합니다! 에이전트리아를 사용해 '슬립에 내용 이어서 기록하기' 워크플로를 완성했습니다.
이 노드를 에이전트 루프 노드에 도구로 연결하면, 에이전트가 대화 중 필요하다고 판단할 때 슬립 내용을 스스로 이어서 기록하는 워크플로로도 확장할 수 있습니다.
에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.
당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.
더 많은 노드 활용 예제가 궁금하다면 🔗노드 사용법 페이지를 확인하세요.
자주 묻는 질문
슬립 본문 덧붙이기 노드는 무엇을 하는 노드인가요?
슬립 본문 덧붙이기 노드는 슬립박스(Slipbox)에 저장된 슬립의 본문 끝에 새 마크다운 섹션을 추가하는 노드입니다. 대상 슬립을 공개 UUID로 지정하고, 전달한 섹션만 덧붙이며 기존 본문은 서버가 그대로 보존합니다.
슬립 본문 덧붙이기 노드와 슬립 필드 수정 노드는 어떻게 다른가요?
슬립 필드 수정 노드는 제목·요약·본문 같은 필드 전체를 새 값으로 통째로 교체하므로, 바인딩한 필드의 기존 내용은 사라집니다. 반면 슬립 본문 덧붙이기 노드는 기존 본문을 전혀 건드리지 않고 그 끝에 새 섹션만 추가하므로, 이력을 남기며 계속 이어 쓰고 싶은 경우에 적합합니다.
출처 표기는 꼭 입력해야 하나요?
아니요, 선택 입력입니다. 입력하면 덧붙인 섹션 바로 아래에 출처가 한 줄로 기록되어 나중에 이 내용이 어디에서 왔는지 추적하기 좋습니다. 문서명·URL·발화자 등 내용의 출처를 짧게 적으면 됩니다.
같은 슬립에 여러 번 덧붙이면 어떻게 되나요?
덧붙일 때마다 새 섹션이 본문 끝에 계속 추가되고, 슬립의 버전(current_version)도 실행할 때마다 하나씩 올라갑니다. 이전에 덧붙인 내용도 모두 그대로 남아있으므로, 시간순으로 기록을 쌓아가는 용도에 적합합니다.