노드 사용법 익히기 - 슬립 카테고리 병합(Slip Merge Category) 노드

슬립 카테고리 병합(Slip Merge Category) 노드는 카테고리(색인) 슬립 두 개를 하나로 합치는 노드입니다. 한쪽 카테고리(흡수될 카테고리)의 자식 슬립을 모두 다른 쪽 카테고리(자식을 받을 카테고리) 아래로 옮기고, 흡수될 카테고리 자체는 삭제합니다. 옮겨진 자식 슬립들의 제목·본문은 전혀 건드리지 않으며, 소속 부모만 바뀝니다.

이 노드는 카테고리 하나를 영구적으로 삭제하는, 되돌릴 수 없는 조작입니다. 실제 콘텐츠에 바로 사용하기 전에 반드시 더미 카테고리로 먼저 동작을 확인해보시기 바랍니다. 이 노드는 에이전트에 도구로 연결해 활용하기도 좋지만, 이 튜토리얼에서는 가장 기본적인 사용법을 확인할 수 있도록 어빌리티에서 다룹니다. 에이전트에 연결하는 방법은 별도의 슬립박스 에이전트 통합 가이드에서 다룰 예정입니다. 이 튜토리얼에서는 에이전트리아 Docs 슬립박스에 테스트용 카테고리 두 개를 만들어 하나로 합치는 어빌리티 워크플로를 완성합니다.

사전 준비

이 튜토리얼을 시작하기 전에 프로젝트에 슬립박스가 구축되어 있어야 합니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다. 이 튜토리얼에서는 에이전트리아 Docs 슬립박스 안에 테스트용 카테고리 두 개를 새로 만들어 사용합니다.

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

1. 슬립 카테고리 병합 노드로 카테고리 두 개를 하나로 합칠 수 있습니다.

2. 슬립 카테고리 병합 노드의 각 입력 변수를 시작 노드의 입력값과 연결할 수 있습니다.

3. 흡수될 카테고리와 자식을 받을 카테고리를 올바르게 구분해 지정할 수 있습니다.

4. 런테스트와 디버그 로그로 카테고리가 정상적으로 합쳐졌는지 확인할 수 있습니다.

워크플로 개요

이 튜토리얼의 핵심은 슬립 카테고리 병합 노드입니다.

슬립 카테고리 병합 노드는 흡수될 카테고리와 자식을 받을 카테고리를 각각 UUID로 지정합니다. 흡수될 카테고리의 직계 자식 슬립을 모두 자식을 받을 카테고리 아래로 옮긴 뒤, 흡수될 카테고리 자체를 삭제합니다.

슬립 카테고리 병합 노드 기본 정보

슬립 카테고리 병합 노드는 아래 옵션을 제공합니다.

이 튜토리얼에서는 세 항목을 모두 사용합니다.

1단계: 어빌리티 생성

새 어빌리티를 생성합니다. 이름에 슬립 카테고리 병합 노드, 설명에 카테고리 두 개 합치기를 입력합니다. 슬립 카테고리 병합 노드를 사용해 합칠 두 카테고리를 이 어빌리티에서 직접 연결합니다. 어떤 카테고리를 대상으로 할지는 각자 알아서 정하면 되며, 이 튜토리얼에서는 에이전트리아 Docs 슬립박스에 만들어 둔 테스트용 카테고리 두 개를 대상으로 진행합니다.

2단계: 시작 노드 설정

시작 노드를 더블 클릭하여 노드 편집기로 진입합니다. 아래 두 변수를 추가합니다.

• uuid_source: 흡수될(삭제될) 카테고리의 UUID를 입력받습니다. (String)

• uuid_target: 자식을 받아 남을 카테고리의 UUID를 입력받습니다. (String)

3단계: 슬립 카테고리 병합 노드 추가

+노드 추가(Add Node) → 슬립박스(Slipbox) 카테고리에서 슬립 카테고리 병합 노드를 추가합니다.

4단계: 슬립 카테고리 병합 노드 설정

슬립 카테고리 병합 노드를 더블 클릭하여 노드 편집기로 진입합니다. 대상 슬립박스에서 사용할 슬립박스를 선택합니다 — 이 튜토리얼에서는 예시로 에이전트리아 Docs를 선택합니다. 이 값을 선택하지 않고 비워두면 노드 실행 시 error_code가 SLIPBOX_NOT_FOUND로 실패하니 반드시 확인합니다.

나머지 항목에는 아래와 같이 시작 노드의 입력값을 드래그 앤 드롭으로 바인딩합니다.

노드가 정상 실행되면 moved_slip_ids(흡수될 카테고리에서 옮겨진 슬립 UUID 배열), error_code, error_message를 출력합니다.

5단계: 종료 노드 설정

종료 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 result 출력변수를 추가하고 슬립 카테고리 병합 노드의 error_code를 드래그 앤 드롭으로 바인딩합니다. 이렇게 하면 카테고리가 정상적으로 합쳐졌는지 실패했는지를 출력값으로 확인할 수 있습니다.

6단계: 테스트용 카테고리 두 개 준비

에이전트리아 Docs 슬립박스로 이동해 슬립 추가 버튼으로 테스트용 카테고리를 두 개 새로 만듭니다(예: 흡수될 카테고리, 자식을 받을 카테고리). 두 슬립의 타입은 모두 기본값인 색인을 그대로 사용합니다. 흡수될 카테고리 쪽에는 하위 페이지 영역의 + 버튼으로 하위 슬립을 한두 개 추가해둡니다 — 병합 후 이 슬립들이 정말 옮겨지는지 확인하기 위해서입니다. 마지막으로 우측 정보 패널에서 두 카테고리 슬립의 공개 UUID를 각각 복사해둡니다. 이 값들은 런테스트에서 uuid_source와 uuid_target의 입력값으로 사용합니다.

7단계: 런테스트 실행

uuid_source에는 흡수될 카테고리의 공개 UUID를, uuid_target에는 자식을 받을 카테고리의 공개 UUID를 붙여넣습니다. 테스트 실행(RUN TEST)을 클릭합니다. result 출력값으로 SUCCESS가 나오면 성공입니다.

8단계: 디버그 로그 확인

슬립 카테고리 병합 노드의 디버그 로그를 확인하면 error_code가 SUCCESS로 반환된 세부 내역과, 함께 반환된 moved_slip_ids 값을 확인할 수 있습니다. 흡수될 카테고리 아래에 있던 자식 슬립들의 UUID가 배열로 담겨 있습니다.

9단계: 슬립박스에서 결과 확인

에이전트리아 Docs 슬립박스로 이동해 확인해보면, 흡수될 카테고리로 지정했던 슬립은 더 이상 목록에 보이지 않습니다(삭제됨). 자식을 받을 카테고리를 열어보면 원래 있던 자식들에 더해 흡수될 카테고리에 있던 자식 슬립들까지 모두 하위 페이지로 들어와 있는 것을 확인할 수 있습니다. 옮겨진 슬립들의 제목과 본문은 그대로 유지됩니다.

다음 단계

🎉 축하합니다! 에이전트리아를 사용해 '카테고리 두 개 합치기' 워크플로를 완성했습니다.

이 노드를 에이전트 루프 노드에 도구로 연결하면, 에이전트가 대화 중 중복되거나 너무 잘게 나뉜 카테고리를 발견했을 때 스스로 하나로 정리하는 워크플로로도 확장할 수 있습니다.

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

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

• 더 많은 노드 활용 예제가 궁금하다면 🔗노드 사용법 페이지를 확인하세요.

자주 묻는 질문

슬립 카테고리 병합 노드는 무엇을 하는 노드인가요?

슬립 카테고리 병합 노드는 카테고리(색인) 슬립 두 개를 하나로 합치는 노드입니다. 흡수될 카테고리의 직계 자식 슬립을 모두 자식을 받을 카테고리 아래로 옮긴 뒤, 흡수될 카테고리 자체를 삭제합니다.

흡수될 카테고리 자체는 병합 후 어떻게 되나요?

삭제됩니다. 흡수될 카테고리 UUID로 지정한 카테고리 슬립은 자식을 모두 넘긴 뒤 완전히 제거되며, 이 동작은 되돌릴 수 없습니다. 반드시 더미 카테고리로 먼저 검증한 뒤 실제 콘텐츠에 사용하시기 바랍니다.

자식을 받을 카테고리가 흡수될 카테고리의 하위 카테고리이면 어떻게 되나요?

노드가 요청을 거부합니다. 자식을 받을 카테고리가 흡수될 카테고리 아래에 있으면 병합 과정에서 트리 구조 자체가 끊어지기 때문에, 이런 조합은 지원하지 않습니다.

일반 슬립(색인이 아닌 슬립)도 흡수될 카테고리나 받을 카테고리로 지정할 수 있나요?

아니요. 흡수될 카테고리 UUID와 자식을 받을 카테고리 UUID 모두 반드시 색인 타입의 슬립만 지정할 수 있습니다.