노드 사용법 익히기 - 슬립 관계 조회(Follow Slip Links) 노드

슬립 관계 조회(Follow Slip Links) 노드는 기준 슬립 하나에 이미 설정되어 있는 관계들을 조회하는 노드입니다. 조회 방향(양쪽/나가는 관계/들어오는 관계)과 관계 타입, 업무 술어로 원하는 범위만 좁혀 가져올 수 있으며, 결과는 관계를 맺은 상대 슬립들의 정보로 반환됩니다.

이 노드는 에이전트에 도구로 연결해 활용하기도 좋지만, 이 튜토리얼에서는 가장 기본적인 사용법을 확인할 수 있도록 어빌리티에서 다룹니다. 에이전트에 연결하는 방법은 별도의 슬립박스 에이전트 통합 가이드에서 다룰 예정입니다. 이 튜토리얼에서는 에이전트리아 Docs 슬립박스 안에 이미 관계가 설정되어 있는 테스트 슬립 쌍을 조회하는 어빌리티 워크플로를 완성합니다.

사전 준비

이 튜토리얼을 시작하기 전에 프로젝트에 슬립박스가 구축되어 있어야 합니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다.

이 노드는 이미 존재하는 관계를 조회하는 노드이므로, 조회할 슬립에 관계가 최소 하나 설정되어 있어야 합니다. 아직 슬립 사이에 관계를 만든 적이 없다면 먼저 🔗슬립 관계 연결(Link Slips) 노드 튜토리얼을 참고해 관계를 하나 만들어 둡니다. 이 튜토리얼에서는 그 튜토리얼에서 에이전트리아 Docs 슬립박스에 만들어 둔 테스트 슬립 두 개 사이의 관계를 그대로 사용합니다.

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

1. 슬립 관계 조회 노드로 슬립에 설정된 관계를 조회할 수 있습니다.

2. 조회 방향을 지정해 나가는 관계·들어오는 관계·양쪽 중 원하는 방향만 가져올 수 있습니다.

3. 관계 타입 필터와 술어 필터로 조회 범위를 좁힐 수 있습니다.

4. 런테스트와 출력값으로 조회 결과(neighbors)의 구조를 확인할 수 있습니다.

워크플로 개요

이 튜토리얼의 핵심은 슬립 관계 조회 노드입니다.

슬립 관계 조회 노드는 기준 슬립을 UUID로 지정하고, 필요하면 조회 방향·관계 타입·업무 술어로 필터링해 조회합니다. 노드가 정상 실행되면 조건에 맞는 관계들이 상대 슬립 정보와 함께 목록으로 반환됩니다.

슬립 관계 조회 노드 기본 정보

슬립 관계 조회 노드는 아래 옵션을 제공합니다.

이 튜토리얼에서는 다섯 항목을 모두 시작 노드와 연결하지만, 런테스트에서는 먼저 기준 슬립 UUID만 입력해 기본 동작(방향 both, 필터 없음)을 확인합니다. 방향·필터 조합은 아래 FAQ에서 다룹니다.

1단계: 어빌리티 생성

새 어빌리티를 생성합니다. 이름에 슬립 관계 조회 노드, 설명에 슬립에 설정된 관계 조회하기를 입력합니다. 어떤 슬립을 조회할지는 각자 알아서 정하면 되며, 이 튜토리얼에서는 에이전트리아 Docs 슬립박스에 이미 관계가 설정되어 있는 테스트 슬립을 대상으로 진행합니다.

2단계: 시작 노드 설정

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

• uuid: 기준 슬립의 UUID를 입력받습니다. (String)

• direction: 조회 방향을 입력받습니다. (String)

• link_types: 관계 타입 필터를 입력받습니다. (Array)

• label: 술어 필터를 입력받습니다. (String)

link_types는 String이 아니라 Array 타입으로 추가해야 합니다.

3단계: 슬립 관계 조회 노드 추가

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

4단계: 슬립 관계 조회 노드 설정

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

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

노드가 정상 실행되면 neighbors(조건에 맞는 관계 목록), slip_public_uuid(조회한 기준 슬립의 UUID), error_code, error_message를 출력합니다.

5단계: 종료 노드 설정

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

6단계: 관계가 있는 테스트 슬립 준비

이 노드는 이미 존재하는 관계를 조회하는 노드이므로, 조회 대상 슬립에 관계가 최소 하나 설정되어 있어야 합니다. 이 튜토리얼에서는 🔗슬립 관계 연결 노드 튜토리얼에서 만든 기준 슬립("관계 연결 테스트 - 출발")과 대상 슬립("관계 연결 테스트 - 대상") 사이의 연관(RELATED_TO) 관계를 그대로 사용합니다.

에이전트리아 Docs 슬립박스로 이동해 기준 슬립을 열고, 우측 정보 패널에서 공개 UUID를 복사해둡니다. 이 값은 런테스트에서 uuid의 입력값으로 사용합니다.

7단계: 런테스트 실행

uuid에는 기준 슬립의 공개 UUID를 붙여넣습니다. direction·link_types·label은 비워 둔 채(기본값 both, 필터 없음) 테스트 실행(RUN TEST)을 클릭합니다. result 출력값으로 SUCCESS가 나오면 성공입니다.

8단계: 디버그 로그 확인

슬립 관계 조회 노드의 디버그 로그를 확인하면 error_code가 SUCCESS로 반환된 세부 내역과, neighbors 배열에 담긴 상대 슬립 정보(slip_public_uuid, title, summary, relation, label, link_type, direction)를 확인할 수 있습니다. slip_public_uuid(노드 출력값)는 입력한 기준 슬립의 UUID와 동일합니다.

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

에이전트리아 Docs 슬립박스로 이동해 기준 슬립을 열어보면, 참고자료에 표시된 항목이 neighbors 출력값과 정확히 일치하는 것을 확인할 수 있습니다 — 관계 타입 배지 연관(RELATED_TO), 라벨 test_relation, 방향 나가는 관계, 대상 "관계 연결 테스트 - 대상".

다음 단계

🎉 축하합니다! 에이전트리아를 사용해 '슬립에 설정된 관계 조회하기' 워크플로를 완성했습니다.

이 노드를 에이전트 루프 노드에 도구로 연결하면, 에이전트가 대화 중 슬립 사이의 관계를 스스로 조회해 답변에 활용하는 워크플로로도 확장할 수 있습니다.

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

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

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

자주 묻는 질문

슬립 관계 조회 노드는 무엇을 하는 노드인가요?

슬립 관계 조회 노드는 기준 슬립 하나에 이미 설정되어 있는 관계들을 조회하는 노드입니다. 조회 방향·관계 타입·업무 술어로 범위를 좁힐 수 있으며, 결과는 관계를 맺은 상대 슬립들의 정보(neighbors)로 반환됩니다. 관계를 새로 만드는 기능은 없으며, 조회 전용입니다.

조회 방향의 both·out·in은 각각 어떻게 다른가요?

out은 기준 슬립이 직접 선언한(만든) 관계만, in은 다른 슬립이 기준 슬립을 대상으로 만든 관계만 가져옵니다. both(기본값)는 둘 다 가져옵니다. 예를 들어 이 튜토리얼의 기준 슬립은 자신이 선언한 나가는 관계만 있고 받은 관계는 없으므로, direction을 in으로 지정하면 neighbors가 빈 배열로 반환됩니다.

관계 타입 필터에 여러 값을 넣을 수 있나요?

네. Array 타입이므로 ["IS_A", "PART_OF"]처럼 여러 관계 타입을 한 번에 넣을 수 있으며, 그중 하나라도 일치하는 관계는 모두 결과에 포함됩니다(OR 조건). 목록에 없는 타입 이름을 넣어도 오류 없이 무시됩니다.

술어 필터는 부분 일치도 되나요?

아니요, 정확 일치(exact match)만 지원합니다. 예를 들어 실제 라벨이 test_relation인 관계는 test_relation을 그대로 입력해야 조회되며, 다른 문자열을 넣으면 결과에서 제외됩니다.

이 노드로 관계를 새로 만들 수 있나요?

아니요. 이 노드는 조회 전용입니다. 관계를 새로 만들려면 🔗슬립 관계 연결(Link Slips) 노드를 사용해야 합니다.