슬립박스 올인원 에이전트 만들기

슬립박스는 사실 사람이 직접 탐색하는 것보다 에이전트가 읽고 실행하도록 설계된 기능에 가깝습니다. 이 튜토리얼에서는 슬립박스를 다루는 노드 11개를 에이전트 루프(Agent Loop) 노드의 도구(Tool)로 모두 연결해, 사용자의 자연어 요청 한마디만으로 슬립박스를 검색·조회·생성·수정·연결·정리까지 전부 처리하는 "슬립박스 올인원 에이전트"를 만듭니다.

슬립 탐색, 슬립 키워드 검색, 슬립 읽기, 슬립 생성, 슬립 필드 수정, 슬립 텍스트 치환, 슬립 본문 덧붙이기, 슬립 관계 조회, 슬립 관계 연결, 슬립 카테고리 분할, 슬립 카테고리 병합까지 11개 슬립박스 노드를 에이전트 루프 노드에 도구로 연결합니다. 각 노드의 자세한 사용법은 이미 개별 튜토리얼로 다뤘으므로, 이 튜토리얼에서는 "여러 도구를 에이전트에 한 번에 연결해 자율적으로 조합해 쓰게 만드는 방법"에 집중합니다. 완성하면 사용자가 "이런 문서 있어?", "이 내용 수정해줘"처럼 자연어로 요청할 때, 에이전트가 상황에 맞는 도구를 스스로 선택하고 조합해 실행합니다.

사전 준비

이 튜토리얼을 시작하기 전에 프로젝트에서 에이전트(Agent)를 생성하고 캔버스(Canvas)에 진입해야 합니다. 캔버스 진입 방법은 🔗3단계 핵심 가이드를 참고하시기 바랍니다.

또한 이 튜토리얼은 슬립박스를 다루는 도구들을 연결하므로, 프로젝트에 슬립박스가 미리 구축되어 있어야 합니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다.

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

1. 에이전트 루프 노드에 슬립박스 관련 노드 11개를 도구로 한 번에 연결할 수 있습니다.

2. 페르소나와 지침(Instructions)으로 에이전트가 도구를 올바른 순서로 선택하도록 유도할 수 있습니다.

3. 각 도구 노드의 입력값을 일일이 바인딩하지 않고도, 에이전트가 상황에 맞는 값을 스스로 채워 호출하게 할 수 있습니다.

4. 챗 테스트와 디버거로 에이전트가 실제로 어떤 도구를 몇 번, 어떤 순서로 호출했는지 확인할 수 있습니다.

이 튜토리얼에서 도구로 연결하는 노드는 다음과 같습니다. 각 노드의 필드와 단독 사용법은 아래 문서를 참고하세요.

• 🔗슬립 탐색(Slip Query) 노드

• 🔗슬립 키워드 검색(Slip Keyword Search) 노드

• 🔗슬립 읽기(Slip Read) 노드

• 🔗슬립 생성(Slip Create) 노드

• 🔗슬립 필드 수정(Slip Field Update) 노드

• 🔗슬립 텍스트 치환(Slip Text Replace) 노드

• 🔗슬립 본문 덧붙이기(Slip Append) 노드

• 🔗슬립 관계 조회(Follow Slip Links) 노드

• 🔗슬립 관계 연결(Link Slips) 노드

• 🔗슬립 카테고리 분할(Slip Split Category) 노드

• 🔗슬립 카테고리 병합(Slip Merge Category) 노드

• 🔗에이전트 루프(Agent Loop) 노드 — 이 노드의 기본 옵션 전체는 이 문서를 참고하세요.

워크플로 개요

각 노드는 다음과 같은 역할을 합니다.

• 에이전트 루프 노드: 사용자 요청을 분석해 지금 필요한 도구를 스스로 선택·조합해 실행하는 이 워크플로의 핵심 노드입니다.

• 슬립박스 도구 노드 11개: 각각 슬립박스를 검색·조회·생성·수정·연결·정리하는 전용 도구입니다. 자세한 사용법은 위 "사전 준비"의 링크를 참고하세요.

• LLM 노드: 에이전트 루프 노드와 슬립 탐색 노드가 내부적으로 사용할 모델을 지정합니다. 슬립 탐색 노드는 관련 슬립을 찾는 과정에서 자체적으로 LLM을 사용하므로, 에이전트 루프 노드와는 별도의 LLM 노드 연결이 필요합니다. 자세한 내용은 🔗LLM 노드 문서를 참고하세요.

도구 여러 개를 연결할 때 알아야 할 것

에이전트 루프 노드 자체의 전체 옵션(최대 스텝 수, 최대 실행 시간 등)은 🔗에이전트 루프 노드 문서에서 이미 다뤘으므로, 여기서는 도구를 여러 개 연결할 때 특히 중요한 설정만 짚고 넘어갑니다.

또 하나 중요한 차이점은 입력값 바인딩 방식입니다. 지금까지의 "핵심 노드 1개" 튜토리얼에서는 노드의 모든 입력을 시작 노드 변수에 드래그 앤 드롭으로 직접 연결했습니다. 하지만 도구로 연결된 노드는 다릅니다 — 슬립 공개 UUID처럼 호출마다 값이 달라지는 입력은 바인딩하지 않고 비워 둡니다. 빈 칸은 화면에 Parameter라는 배지와 함께 표시되며, 이는 "에이전트가 호출 시점에 이 값을 직접 채운다"는 뜻입니다. 반대로 대상 슬립박스처럼 실행마다 바뀌지 않는 값은 지금까지와 동일하게 설계 시점에 미리 선택해 둡니다.

비워 둔 입력 필드

1단계: 에이전트 생성

새 에이전트를 생성합니다. 이름에 슬립박스 올인원 에이전트, 설명에 슬립박스를 검색·조회·생성·수정·관리하는 에이전트를 입력합니다.

2단계: 에이전트 입력(Agent Input) 노드 확인

Agent Input 노드를 더블 클릭해 노드 편집기를 엽니다. input_message, input_files, metadata, session_id 네 입력 변수가 고정되어 있습니다. 이 튜토리얼에서는 사용자가 채팅으로 입력한 메시지가 담기는 input_message를 그대로 사용합니다.

3단계: 에이전트 루프 노드 추가 및 페르소나·지침 작성

+노드 추가(Add Node)로 에이전트 루프 노드를 캔버스에 배치합니다. 노드 편집기에서 사용자 입력에 input_message를 드래그 앤 드롭으로 바인딩합니다.

변수 추가 버튼으로 에이전트 페르소나와 에이전트 지침 입력을 추가합니다. 에이전트 페르소나에는 아래와 같이 에이전트의 정체성을 적습니다.

당신은 **Slipbox Master**

당신은 **Slipbox Master**

당신은 **Slipbox Master**

에이전트 지침에는 도구 선택 기준과 작업 순서 규칙을 적습니다.

마지막으로 프롬프트 내 최대 도구 수를 11로 수정합니다(기본값 10 → 11, 연결할 도구가 정확히 11개이므로).

4단계: LLM 노드 추가 및 연결

+노드 추가로 LLM 노드를 캔버스에 배치하고 LLM 모델에서 Anthropic-claude-4.6-sonnet을 선택합니다. 이 LLM 노드를 에이전트 루프 노드의 LLM Model 연결 포인트에 연결합니다.

슬립 탐색 노드는 관련 슬립을 찾는 과정에서 내부적으로 LLM을 사용하므로, 같은 방식으로 LLM 노드를 하나 더 추가해 슬립 탐색 노드의 LLM Model 연결 포인트에도 연결합니다(같은 LLM 노드를 재사용해도 되고, 새로 추가해도 됩니다 — 이 튜토리얼에서는 동일한 모델로 별도 LLM 노드를 하나 더 둡니다). Fallback LLM Model은 이 튜토리얼에서 연결하지 않습니다.

5단계: 슬립박스 도구 노드 11개 추가 및 연결

11개 도구 노드는 모두 같은 패턴을 따릅니다.

1. +노드 추가로 슬립박스(Slipbox) 카테고리에서 노드를 캔버스에 배치합니다.

2. 노드 편집기에서 대상 슬립박스를 선택합니다 — 이 튜토리얼에서는 예시로 Slipbox Master를 선택합니다. 이 값만은 모든 도구 노드에서 미리 선택해 둬야 합니다.

3. 나머지 입력(검색어, 슬립 UUID, 본문 등)은 바인딩하지 않고 비워 둡니다. 에이전트가 호출 시점에 알아서 채웁니다.

4. 에이전트 루프 노드 하단의 Tools 연결 포인트에서 이 노드의 인핀(In-Pin)으로 엣지를 연결합니다.

이 패턴을 아래 11개 노드에 반복합니다.

✅ 여기까지 확인: 캔버스에 도구 노드 11개가 모두 배치되어 있고, 각 노드의 대상 슬립박스가 비어 있지 않으며, 모든 노드가 에이전트 루프 노드의 Tools에 연결되어 있는지 확인하세요. 하나라도 대상 슬립박스가 비어 있으면 해당 도구를 호출할 때 실패합니다.

6단계: 에이전트 출력(Agent Output) 노드 설정

Agent Output 노드를 더블 클릭해 노드 편집기를 엽니다. output_message에 에이전트 루프 노드의 final_answer를 드래그 앤 드롭으로 바인딩합니다.

7단계: 챗 테스트로 워크플로 전체 실행

채팅 테스트(CHAT TEST) 버튼을 클릭하고, 채팅 입력창에 아래와 같이 조회성 질문을 입력해 실행합니다.

에이전트가 스스로 키워드 검색 → 슬립 탐색 → 슬립 읽기 세 도구를 순서대로 호출해 슬립박스 구조를 파악한 뒤 답변을 생성하면 정상 동작하는 것입니다.

이어서 여러 도구를 동시에 써야 하는 복합 요청도 입력해봅니다.

이 요청 하나로 에이전트는 슬립 생성, 슬립 본문 덧붙이기, 슬립 관계 연결 세 도구를 상황에 맞게 조합해 호출합니다. 모든 작업이 끝나면 "✅ 작업 완료 요약"과 함께 생성된 슬립 ID, 추가된 섹션, 연결된 관계가 표로 정리되어 돌아옵니다.

8단계: 디버거로 실행 과정 확인

우측 디버거 패널에서 에이전트가 호출한 도구들을 순서대로 확인할 수 있습니다. 각 생각 단계 다음에 실행 - [도구명] 항목이 나오는데, 같은 단계에 항목이 여러 개 나란히 있다면 그 도구들을 한 턴에 동시에(병렬로) 호출했다는 뜻입니다. 예를 들어 위 복합 요청에서는 슬립 본문 덧붙이기와 슬립 관계 연결이 같은 턴에 함께 호출됩니다.

도구 호출이 실패하는 경우도 디버거에서 그대로 확인할 수 있습니다. 예를 들어 사용자가 "참고"라는 한글 라벨로 관계를 만들어 달라고 요청하면, 슬립 관계 연결 노드가 error_code: INVALID_INPUT, error_message: "invalid label '참고'. must be lowercase snake_case..."를 반환하며 실패합니다. 디버거에서 이 실패를 확인한 에이전트는 다음 턴에 라벨을 영문 snake_case(reference)로 바꿔 스스로 재시도하며, 최종 답변에서도 이 사실을 사용자에게 투명하게 설명합니다.

다음 단계

🎉 축하합니다! 에이전트리아를 사용해 '슬립박스 올인원 에이전트' 워크플로를 완성했습니다.

슬립박스 노드 외에도 웹 검색이나 다른 어빌리티를 도구로 함께 연결하면, 하나의 에이전트가 슬립박스 관리를 넘어 더 폭넓은 업무를 상황에 맞게 스스로 처리하도록 확장할 수 있습니다.

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

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

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

자주 묻는 질문

도구를 여러 개 연결하는 방식은 언제 사용해야 하나요?

하나의 데이터 소스(이 경우 슬립박스)에 대해 검색·생성·수정처럼 서로 다른 성격의 작업을 사용자가 자연어로 자유롭게 요청할 것으로 예상될 때 적합합니다. 요청마다 어떤 노드를, 어떤 순서로 실행할지 미리 정해둘 수 없는 대화형 시나리오에서, 고정된 워크플로 대신 에이전트가 매번 상황에 맞는 도구를 선택하게 할 수 있습니다.

도구로 연결하는 방식은 어빌리티에서 노드를 직접 바인딩하는 방식과 어떻게 다른가요?

어빌리티에서는 각 노드의 모든 입력을 시작 노드 변수에 미리 드래그 앤 드롭으로 연결해야 합니다. 반면 에이전트 루프 노드의 도구로 연결하면, 슬립 공개 UUID처럼 호출마다 달라지는 입력은 바인딩하지 않고 비워 둬도 되며 에이전트가 호출 시점에 직접 채웁니다. 대상 슬립박스처럼 실행마다 바뀌지 않는 값만 설계 시점에 미리 선택해 두면 되므로, 설정할 것이 훨씬 적습니다.

에이전트는 여러 도구를 어떤 순서로 호출하나요?

에이전트 루프 노드는 사용자 요청을 분석해 필요한 도구를 판단하고, 도구 실행 결과를 관찰한 뒤 추가로 필요한 도구가 있으면 다시 호출하는 과정을 반복합니다(생각 → 실행 → 관찰 반복). 여러 도구를 같은 턴에 동시에 호출할 수도 있습니다 — 실제로 "섹션을 추가하고 새 슬립을 만들어 연결해줘"처럼 복합적인 요청에서는 슬립 본문 덧붙이기와 슬립 관계 연결이 한 턴에 함께 호출되는 것을 디버거에서 확인할 수 있습니다.

도구 호출이 실패하면 어떻게 되나요?

도구가 error_code와 함께 실패를 반환하면, 에이전트는 다음 턴에 이 정보를 참고해 입력값을 스스로 수정하고 재시도합니다. 예를 들어 슬립 관계 연결 노드에 한글 라벨을 전달해 INVALID_INPUT 오류가 나면, 에이전트가 라벨을 영문 snake_case로 바꿔 다시 호출해 성공시키고, 이 과정을 최종 답변에서 사용자에게 설명합니다.