슬립 관계 연결 노드
노드 사용법 익히기 - 슬립 관계 연결(Link Slips) 노드
슬립 관계 연결(Link Slips) 노드는 슬립 하나(출발 슬립)에서 다른 슬립 하나 이상(대상 슬립)으로 향하는 구조적 관계를 만드는 노드입니다. 관계에는 닫힌 어휘로 정해진 관계 타입(예: 분류 관계, 구성 관계 등)을 지정하며, 필요하면 그 위에 업무 관계명을 덧붙일 수 있습니다. 만들어진 관계는 각 슬립의 참고자료 영역에서 확인할 수 있습니다.
이 노드는 에이전트에 도구로 연결해 활용하기도 좋지만, 이 튜토리얼에서는 가장 기본적인 사용법을 확인할 수 있도록 어빌리티에서 다룹니다. 에이전트에 연결하는 방법은 별도의 슬립박스 에이전트 통합 가이드에서 다룰 예정입니다. 이 튜토리얼에서는 에이전트리아 Docs 슬립박스에 테스트용 슬립 두 개를 만들어 그 사이에 관계를 연결하는 어빌리티 워크플로를 완성합니다.
사전 준비
이 튜토리얼을 시작하기 전에 프로젝트에 슬립박스가 구축되어 있어야 합니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다. 이 튜토리얼에서는 에이전트리아 Docs 슬립박스 안에 테스트용 슬립 두 개를 새로 만들어 사용합니다.
이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.
슬립 관계 연결 노드로 슬립 사이에 구조적 관계를 만들 수 있습니다.
슬립 관계 연결 노드의 각 입력 변수를 시작 노드의 입력값과 연결할 수 있습니다.
관계 타입과 업무 술어를 상황에 맞게 구분해 지정할 수 있습니다.
런테스트와 디버그 로그로 관계가 정상적으로 만들어졌는지 확인할 수 있습니다.
워크플로 개요
이 튜토리얼의 핵심은 슬립 관계 연결 노드입니다.
슬립 관계 연결 노드는 출발 슬립을 UUID로 지정하고, 대상 슬립 UUID 목록과 관계 타입을 전달합니다. 노드가 정상 실행되면 출발 슬립에서 각 대상 슬립으로 향하는 나가는 관계가 만들어지며, 모든 대상은 같은 타입·술어로 연결됩니다.
슬립 관계 연결 노드 기본 정보
슬립 관계 연결 노드는 아래 옵션을 제공합니다.
옵션 | 필수 여부 | 설명 |
|---|---|---|
| 필수 | 관계가 출발하는 슬립의 UUID입니다. 수정 대상이므로 이 슬립에 편집 권한이 필요합니다. |
| 필수 | 구조 관계 타입입니다. 닫힌 어휘 13종 중 하나이며, 가장 좁은 타입을 고릅니다(분류는 |
| 필수 | 관계를 걸 대상 슬립의 UUID 목록입니다. 모두 같은 타입·술어로 연결됩니다. 이 슬립박스에 실재하지 않는 UUID는 건너뛰고 결과에 알려 줍니다. |
| 선택 | 구조 타입 위에 얹는 업무 관계명입니다(소문자 snake_case, 예: |
| 필수 | 이 노드가 다룰 슬립박스입니다. 빌더에서 선택해 고정합니다. |
이 튜토리얼에서는 다섯 항목을 모두 사용합니다.
관계 타입 13종 전체 목록
관계 타입에 넣을 수 있는 닫힌 어휘 13종은 아래와 같습니다. 표기가 같은 두 슬립이라도 상황에 따라 더 좁고 명확한 타입을 고르는 것이 좋으며, 딱 들어맞는 타입이 없을 때만 연관을 씁니다.
관계 타입 | 값( | 설명 |
|---|---|---|
연관 |
| 두 슬립이 서로 참고가 되는 느슨한 관계입니다. |
동일 실체 |
| 표기가 달라도 같은 대상을 가리킵니다. (대칭) |
분류 |
| 이 슬립이 타겟의 사례이거나 하위 분류입니다. |
구성 |
| 이 슬립이 타겟의 한 부분입니다. (컬럼→테이블, 조항→계약) |
의존 |
| 이 슬립이 성립하려면 타겟이 필요합니다. |
사용 |
| 이 슬립이 타겟을 가져다 씁니다. |
확장 |
| 이 슬립이 타겟을 넓히거나 덧붙입니다. |
파생 |
| 이 슬립이 타겟에서 만들어졌습니다. |
뒷받침 |
| 이 슬립이 타겟의 근거가 됩니다. |
검증 |
| 이 슬립이 타겟으로 검증됩니다. |
규율 |
| 이 슬립(정책)이 타겟을 규율합니다. |
대체 |
| 이 슬립이 타겟을 대체합니다. |
반박 |
| 이 슬립과 타겟이 서로 어긋납니다. (대칭) |
노드로 만든 관계는 항상 출발 슬립에서 대상 슬립으로 향하는 나가는 관계입니다. 관계를 만든 뒤 방향을 바꾸고 싶다면, 슬립박스 UI에서 해당 슬립의 참고자료 항목에 있는 방향 설정 버튼으로 나가는 관계·들어오는 관계·상호 관계 중에서 수동으로 다시 지정할 수 있습니다.
1단계: 어빌리티 생성
새 어빌리티를 생성합니다. 이름에 슬립 관계 연결 노드, 설명에 슬립 사이에 관계 연결하기를 입력합니다. 슬립 관계 연결 노드를 사용해 관계를 연결할 슬립들을 이 어빌리티에서 직접 연결합니다. 어떤 슬립을 대상으로 할지는 각자 알아서 정하면 되며, 이 튜토리얼에서는 에이전트리아 Docs 슬립박스에 만들어 둔 테스트용 슬립 두 개를 대상으로 진행합니다.
2단계: 시작 노드 설정
시작 노드를 더블 클릭하여 노드 편집기로 진입합니다. 아래 네 변수를 추가합니다.
uuid: 출발 슬립의 UUID를 입력받습니다. (String)link_type: 관계 타입을 입력받습니다. (String)to_slip_public_uuids: 대상 슬립들의 UUID 목록을 입력받습니다. (Array)label: 업무 술어를 입력받습니다. (String)
to_slip_public_uuids는 String이 아니라 Array 타입으로 추가해야 합니다.
3단계: 슬립 관계 연결 노드 추가
+노드 추가(Add Node) → 슬립박스(Slipbox) 카테고리에서 슬립 관계 연결 노드를 추가합니다.
4단계: 슬립 관계 연결 노드 설정
슬립 관계 연결 노드를 더블 클릭하여 노드 편집기로 진입합니다. 대상 슬립박스에서 사용할 슬립박스를 선택합니다 — 이 튜토리얼에서는 예시로 에이전트리아 Docs를 선택합니다. 이 값을 선택하지 않고 비워두면 노드 실행 시 error_code가 SLIPBOX_NOT_FOUND로 실패하니 반드시 확인합니다.
나머지 항목에는 아래와 같이 시작 노드의 입력값을 드래그 앤 드롭으로 바인딩합니다.
어댑터 변수 | 바인딩 값 |
|---|---|
|
|
|
|
|
|
|
|
노드가 정상 실행되면 linked_count(연결된 슬립 수), skipped_slip_ids(존재하지 않아 건너뛴 UUID 배열), slip_public_uuid(수정된 출발 슬립의 UUID), error_code, error_message를 출력합니다.
5단계: 종료 노드 설정
종료 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 result 출력변수를 추가하고 슬립 관계 연결 노드의 error_code를 드래그 앤 드롭으로 바인딩합니다. 이렇게 하면 관계가 정상적으로 만들어졌는지 실패했는지를 출력값으로 확인할 수 있습니다.
6단계: 테스트용 슬립 두 개 준비
에이전트리아 Docs 슬립박스로 이동해 슬립 추가 버튼으로 테스트용 슬립을 두 개 새로 만듭니다(예: 출발 슬립, 대상 슬립). 마지막으로 우측 정보 패널에서 두 슬립의 공개 UUID를 각각 복사해둡니다. 이 값들은 런테스트에서 uuid와 to_slip_public_uuids의 입력값으로 사용합니다.
7단계: 런테스트 실행
uuid에는 출발 슬립의 공개 UUID를 붙여넣습니다. link_type에는 RELATED_TO를 입력합니다.
label에는 test_relation을 입력하고 to_slip_public_uuids에는 대상 슬립의 공개 UUID를 담은 JSON 배열을 작성합니다.
테스트 실행(RUN TEST)을 클릭합니다. result 출력값으로 SUCCESS가 나오면 성공입니다.
8단계: 디버그 로그 확인
슬립 관계 연결 노드의 디버그 로그를 확인하면 error_code가 SUCCESS로 반환된 세부 내역과, 함께 반환된 linked_count(1), skipped_slip_ids(빈 배열), slip_public_uuid(출발 슬립의 UUID) 값을 확인할 수 있습니다.
9단계: 슬립박스에서 결과 확인
에이전트리아 Docs 슬립박스로 이동해 출발 슬립을 열어보면, 참고자료 개수가 1로 늘어난 것을 확인할 수 있습니다. 새로 생긴 참고자료 항목을 보면 관계 타입 배지가 연관(RELATED_TO)으로, 라벨이 test_relation으로, 방향이 나가는 관계로, 대상이 방금 만든 대상 슬립으로 정확히 표시되어 있습니다.
다음 단계
🎉 축하합니다! 에이전트리아를 사용해 '슬립 사이에 관계 연결하기' 워크플로를 완성했습니다.
이 노드를 에이전트 루프 노드에 도구로 연결하면, 에이전트가 대화 중 슬립 사이의 구조적 관계를 스스로 파악해 연결하는 워크플로로도 확장할 수 있습니다.
에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.
당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.
더 많은 노드 활용 예제가 궁금하다면 🔗노드 사용법 페이지를 확인하세요.
자주 묻는 질문
슬립 관계 연결 노드는 무엇을 하는 노드인가요?
슬립 관계 연결 노드는 출발 슬립 하나에서 대상 슬립 하나 이상으로 향하는 구조적 관계를 만드는 노드입니다. 관계 타입은 닫힌 어휘 중에서 지정하며, 필요하면 업무 술어를 추가로 붙일 수 있습니다. 만들어진 관계는 출발 슬립의 참고자료에서 확인할 수 있습니다.
관계 타입에는 어떤 값을 쓸 수 있나요?
닫힌 어휘 13종 중 하나를 씁니다. 노드 필드 설명에 예시로 나와 있는 값은 IS_A(분류), PART_OF(구성), GOVERNS(규율), SAME_AS(동일 대상), RELATED_TO(단순 연관)입니다. 이 중 RELATED_TO는 다른 타입으로 표현하기 애매할 때만 쓰고, 의미가 더 좁고 명확한 타입이 있다면 그쪽을 우선 고르는 것이 좋습니다.
업무 술어는 꼭 입력해야 하나요?
아니요, 선택 입력입니다. 관계 타입이 구조적인 의미(분류·구성 등)를 담당한다면, 업무 술어는 그 위에 업무 맥락을 얹는 역할을 합니다. customer_of, approves처럼 소문자 snake_case로 작성하며, 구조 타입만으로 이미 뜻이 충분하다면 비워 둬도 됩니다.
대상 슬립 UUID 목록에 존재하지 않는 UUID를 넣으면 어떻게 되나요?
노드 전체가 실패하지 않고, 존재하지 않는 UUID만 건너뛴 뒤 skipped_slip_ids 출력값으로 알려줍니다. 나머지 유효한 대상들과는 정상적으로 관계가 만들어집니다.