# 에이전트 스튜디오 - 라우터 도구 (AI 및 조건부 라우터)

## 에이전트 스튜디오 - 라우터 도구 (AI 및 조건부 라우터)

에이전트 스튜디오의 라우터는 에이전트 스튜디오 내에서 대화가 노드 간에 어떻게 이동하는지를 제어합니다. 이름에서 알 수 있듯이, 라우터는 특정 로직이나 조건에 따라 워크플로우를 한 노드에서 다음 노드로 안내합니다. 이 글에서는 AI 라우터, 조건부 라우터, 무조건 라우팅을 사용하여 의도, 로직 또는 항상 켜져 있는 전환을 기반으로 더 스마트한 대화 경로를 구축하는 방법을 설명합니다.

**목차**

* [에이전트 스튜디오의 라우터 도구란?](#에이전트-스튜디오의-라우터-도구란)
* [에이전트 스튜디오 라우터 도구의 주요 장점](#에이전트-스튜디오-라우터-도구의-주요-장점)
* [AI 라우터 사용하기](#ai-라우터-사용하기)
* [조건부 라우터 사용하기](#조건부-라우터-사용하기)
* [무조건 사용하기](#무조건-사용하기)
* [순차 노드 내에서 라우터 사용하기](#순차-노드-내에서-라우터-사용하기)
* [에이전트 스튜디오에서 라우팅 도구 사용 방법](#에이전트-스튜디오에서-라우팅-도구-사용-방법)
* [예시 플로우](#예시-플로우)
* [모범 사례](#모범-사례)
* [자주 묻는 질문](#자주-묻는-질문)
* [관련 문서](#관련-문서)

## 에이전트 스튜디오의 라우터 도구란?

에이전트 스튜디오 라우터는 대화 맥락이나 로직에 따라 에이전트가 한 노드에서 다른 노드로 이동하는 방식을 제어합니다. 그래프 내에서 유연한 경로를 만들어 사용자가 말하는 내용, 수집된 데이터, 또는 플로우가 항상 다음 노드로 계속되어야 하는지에 따라 다음 단계가 선택되도록 도와줍니다.

라우터는 세 가지 라우팅 방식을 지원합니다:

* AI 라우터: 자연어 의도를 사용하여 어떤 경로를 택할지 결정합니다.
* 조건부 라우터: 저장된 변수와 로직 규칙을 사용하여 다음 노드를 결정합니다.
* 무조건: 의도나 로직을 평가하지 않고 항상 연결된 다음 노드로 이동합니다.

라우터는 에이전트 플로우와 순차 노드 내에서 사용할 수 있으며, 이를 통해 선형 프로세스가 필요 시 분기한 후 계속 진행할 수 있습니다.

### **에이전트 스튜디오 라우터 도구의 주요 장점**

* **스마트한 분기**: 고정된 키워드가 아닌 사용자의 의도에 따라 사용자를 라우팅합니다.
* 더 많은 제어: 변수와 로직 규칙을 사용하여 연락처를 올바른 다음 단계로 이동시킵니다.
* 깔끔한 그래프 디자인: 모든 것을 하나의 경로로 강제하는 대신 의도적으로 노드를 연결합니다.
* 유연한 플로우 구축: 동일한 에이전트에서 AI 라우팅, 조건부 로직, 상시 라우팅을 결합합니다.
* 더 나은 사용자 경험: 불필요한 단계를 줄여 연락처가 더 빠르게 올바른 결과에 도달하도록 돕습니다.
* 더 고급 자동화 지원: 에이전트 스튜디오와 순차 노드 내에서 동적 의사결정을 추가합니다.

### AI 라우터 사용하기

AI 라우터는 다음 단계가 사용자가 자연어로 의미하는 바에 따라 달라질 때 가장 적합합니다. 정확한 값을 확인하는 대신, AI가 사용자의 메시지를 검토하고 사용자가 정의한 가장 적절한 의도와 매칭합니다.

**AI 라우터를 사용해야 하는 경우:**

* 사용자가 같은 의미로 다양한 방식으로 응답할 수 있을 때
* 관심도, 감정, 또는 대화 의도에 따라 분기하려고 할 때
* 저장된 변수 대신 자연어에서 경로를 선택해야 할 때

의도 예시:

* 사용자가 은 투자를 원함
* 사용자가 은 투자를 원하지 않음

이 설정에서 라우터는 사용자의 마지막 메시지를 평가하고 매칭되는 연결된 노드로 대화를 보냅니다.

![AI 라우터 설정](https://jumpshare.com/share/VI6v7INolYvCBP15V3pA+/Screen+Shot+2026-03-31+at+21.12.20.png)

### 조건부 라우터 사용하기

조건부 라우터는 라우팅이 대화에서 이미 수집된 알려진 값에 의존할 때 가장 적합합니다. 이는 도구, 폼 필드, 선택 또는 이전 노드가 로직으로 평가할 수 있는 값을 저장할 때 유용합니다.

조건부 라우터를 사용해야 하는 경우:

* 평가할 저장된 변수가 이미 있을 때
* 경로가 예, 아니오, 긍정적, 부정적과 같은 고정 값에 의존할 때
* AI 해석 대신 명시적인 규칙 기반 분기가 필요할 때

조건부 경로는 다음과 같은 로직 필드를 사용합니다:

* 변수
* 연산자
* 값

예시:

* 변수: {{runtime.userChoice\_eyro}}
* 연산자: equals (EQ)
* 값: Yes

해당 경로는 사용자를 진행 경로로 보낼 수 있으며, 다른 조건은 다른 노드로 보낼 수 있습니다.

![조건부 라우터 설정](https://jumpshare.com/share/wktANOfKtUOFcHZZWWcw+/Screen+Shot+2026-03-31+at+21.14.33.png)

### 무조건 사용하기

무조건은 의도나 로직을 평가하지 않고 라우터가 매번 앞으로 이동하기를 원할 때 유용합니다. 이는 항상 켜져 있는 경로를 만들며 더 큰 대화 플로우에서 단계 간의 다리 역할을 잘 수행합니다.

**무조건을 사용해야 하는 경우:**

* 다음 노드가 현재 노드 후에 항상 실행되어야 할 때
* 노드 간 간단한 전환을 원할 때
* 단계가 이미 필요한 정보를 수집했고 이제 자동으로 계속되어야 할 때

활성화되면 경로는 연결된 다음 노드로의 항상 경로로 작동합니다.

![무조건 설정](https://jumpshare.com/share/QinbbLPyNiYY12ZSIgGK+/Screen+Shot+2026-03-31+at+21.17.08.png)

### **순차 노드 내에서 라우터 사용하기**

라우터는 순차 노드 내에서도 사용할 수 있으며, 이를 통해 대부분 선형인 플로우가 필요 시 분기할 수 있습니다. 이는 시퀀스가 순서대로 계속되어야 하지만 앞으로 이동하기 전에 여전히 AI 기반 또는 로직 기반 결정이 필요할 때 도움이 됩니다.

**이 접근 방식이 잘 작동하는 경우:**

* 시퀀스가 다음 단계 전에 결정 지점이 필요할 때
* 사용자의 답변이 다른 결과로 리디렉션되어야 할 때
* 구조화된 플로우와 동적 라우팅을 결합하려고 할 때

![순차 노드 내 라우터](https://jumpshare.com/share/tJr24ofDTDJb2xhHjjnw+/GIF+Recording+2026-03-31+at+21.20.14.gif)

### **에이전트 스튜디오에서 라우팅 도구 사용 방법**

잘 구조화된 라우터 설정은 대화가 사용자 의도나 정의된 로직에 따라 지능적으로 이동하도록 보장합니다. 에이전트 내에서 AI 기반 및 규칙 기반 라우팅을 모두 구성하려면 아래 단계를 따르세요.

* 좌측 네비게이션 메뉴에서 \*\*AI Agents(AI 에이전트)\*\*를 클릭한 다음 페이지 상단의 **Agent Studio(에이전트 스튜디오)** 탭을 선택합니다.

![에이전트 스튜디오 접근](https://jumpshare.com/share/zexM4XYJb4ZN67edOpbJ+/Screen+Shot+2026-03-31+at+21.30.00.png)

* 새 \*\*Agent(에이전트)\*\*를 생성하거나 기존 \*\*Agent's name(에이전트명)\*\*을 **클릭**하여 **열기**합니다.

![에이전트 선택](https://jumpshare.com/share/b9AkqFZdviXcCjptrwI2+/Screen+Shot+2026-03-31+at+21.27.54.png)

* Chat Message(채팅 메시지) 또는 Form Submitted(폼 제출) 등과 같은 **트리거**를 **추가**합니다.
* \*\*AI Agent(AI 에이전트)\*\*를 추가하고 구성합니다.

![AI 에이전트 추가](https://jumpshare.com/share/lkDj473SlSXKIqrJKjAe+/GIF+Recording+2026-03-31+at+21.45.09.gif)

* 좌측의 **Flow Control(플로우 제어)** 패널에서 **Router(라우터) 노드를 캔버스에 드래그하여 대화 플로우에 결정 지점을 삽입**합니다.

![라우터 노드 추가](https://jumpshare.com/share/8tnlg7DSgrZXz9dweYr9+/Screen+Shot+2026-03-31+at+21.56.30.png)

* 배치되면 **Edit Router(라우터 편집) 패널이 우측에 열리며**, 여기서 **라우팅 모드**를 선택하고 대화가 어떻게 분기되어야 하는지 구성을 시작할 수 있습니다.
* 라우터 구성 패널에서 "**Router Type(라우터 유형)**" 섹션 아래의 **AI Router(AI 라우터)와 Conditional Router(조건부 라우터)** 중에서 선택합니다. 이 선택은 라우팅 결정이 AI 의도 감지 또는 규칙 기반 로직을 기반으로 할지를 결정합니다.

![라우터 유형 선택](https://jumpshare.com/share/FVms2LHqWAfQ9CtphNft+/Screen+Shot+2026-03-31+at+21.59.17.png)

* **라우터를 구성**합니다:

\*\*AI Router(AI 라우터)\*\*의 경우, 각 경로를 결정해야 하는 의도를 추가합니다. 각 의도는 AI가 사용자 메시지에서 매칭 의도를 감지할 때 대화가 따를 수 있는 분기를 나타냅니다.

![AI 라우터 구성](https://jumpshare.com/share/jW2IKGkLZ7iimOEMsozO+/GIF+Recording+2026-04-01+at+18.27.34.gif)

* \*\*Conditional Router(조건부 라우터)\*\*의 경우, 올바른 변수, 연산자, 값을 사용하여 하나 이상의 조건을 추가합니다.

자연어 해석 대신 구조화된 데이터를 기반으로 라우팅 결정을 내리려면 \*\*Conditional Router(조건부 라우터)\*\*로 전환합니다. 이 모드는 변수와 사전 정의된 로직을 평가하여 다음 단계를 결정합니다.

대화 그래프 내에서 식별할 수 있도록 조건 분기에 대한 명확한 \*\*Label(라벨)\*\*을 입력합니다. 이 라벨은 노드 연결에 나타나며 복잡한 플로우를 정리하는 데 도움이 됩니다.

\*\*Condition Type(조건 유형)\*\*을 선택하여 여러 규칙이 어떻게 평가되는지 정의합니다. 모든 조건이 일치해야 하는지(AND) 또는 하나의 조건만 일치하면 되는지(OR) 선택합니다.

조건 편집기에서 \*\*Variable(변수)\*\*를 선택하고, 적절한 \*\*Operator(연산자)\*\*를 선택하며, 예상되는 \*\*Value(값)\*\*를 정의합니다. 이는 라우터가 해당 분기로 진행하기 전에 정확히 어떤 데이터를 평가해야 하는지 알려줍니다.

![조건부 라우터 구성](https://jumpshare.com/share/7dDVSMoCgA6psjx5xIsb+/GIF+Recording+2026-04-01+at+18.21.02.gif)

* \*\*No Condition(무조건)\*\*의 경우, 경로가 항상 다음 노드로 계속되도록 토글을 활성화합니다.

![무조건 설정](https://jumpshare.com/share/gsL6cP1tnxBoh6dS8wV4+/Screen+Shot+2026-04-01+at+18.22.24.png)

* 각 **경로 출력**을 그래프의 올바른 **목적지 노드**에 **연결**합니다.

![경로 연결](https://jumpshare.com/share/6I7auL2jvAPr7ecotmTQ+/Screen+Shot+2026-04-01+at+18.30.36.png)

* 라우터 설정을 저장합니다.
* 각 경로가 올바른 다음 단계로 이어지는지 확인하기 위해 **대화를 테스트**합니다.
* 저장하고, 발행하며, 워크플로우를 **배포**합니다.

![워크플로우 배포](https://jumpshare.com/share/jHwppkWcAJJVItrnCIQh+/Screen+Shot+2026-04-01+at+18.33.03.png)

### **예시 플로우**

실제 예시는 하나의 에이전트에서 다양한 라우터 유형이 어떻게 함께 작동하는지 보기 쉽게 만들어줍니다. 아래 플로우는 AI 라우팅, 상시 라우팅, 조건 기반 라우팅이 완전한 사용자 여정을 지원하는 방법을 보여줍니다.

**예시 플로우:**

* 에이전트가 사용자에게 은 가격에 대해 묻고 \*\*Web Search(웹 검색)\*\*를 사용하여 정보를 제공합니다.
* 그 다음 에이전트가 사용자에게 은에 투자하고 싶은지 묻습니다.
* **AI 라우터**가 사용자의 응답을 평가합니다:

사용자가 투자를 원하면 플로우는 다음 노드로 이동합니다.

* 사용자가 투자를 원하지 않으면 플로우는 감사 노드로 라우팅됩니다.
* 다음 노드는 사용자의 이메일을 수집합니다.
* 무조건 경로는 항상 플로우를 확인 단계로 이동시킵니다.
* 단일 선택 노드가 사용자에게 진행하고 싶은지 묻습니다.
* **조건부 라우터**가 저장된 답변을 확인합니다:

값이 **Yes**와 같으면 플로우는 진행 경로로 이동합니다.

* 값이 **No**와 같으면 플로우는 다른 결과로 이동합니다.

### **모범 사례**

강력한 라우팅 디자인은 에이전트를 유지 관리하기 쉽게 만들고 테스트 중 오류를 줄이는 데 도움이 됩니다. 명확한 경로 라벨, 의도적인 로직, 현실적인 테스트 케이스는 사용자가 특정 경로에 도달한 이유를 이해하기 쉽게 만듭니다.

* 사용자 응답이 표현은 다를 수 있지만 같은 의도를 공유할 때는 **AI 라우터**를 사용하세요.
* 결정이 저장된 값에 의존할 때는 **조건부 라우터**를 사용하세요.
* 플로우가 항상 계속되어야 할 때는 **무조건**을 사용하세요.
* 각 분기를 이해하기 쉽게 경로 라벨을 명확하게 유지하세요.
* 에이전트를 발행하기 전에 각 경로를 테스트하세요.
* 경로가 변수나 다른 도구에 의존할 때 관련 설정 문서에 링크하세요.

### 자주 묻는 질문

Q: AI 라우터와 조건부 라우터의 차이점은 무엇인가요? A: AI 라우터는 자연어 의도를 평가하는 반면, 조건부 라우터는 변수, 연산자, 값과 같은 로직을 사용하여 저장된 값을 확인합니다.

Q: 언제 무조건을 사용해야 하나요? A: 의도나 로직을 평가하지 않고 플로우가 항상 연결된 다음 노드로 이동해야 할 때 무조건을 사용하세요.

Q: 순차 노드 내에서 라우터를 사용할 수 있나요? A: 네. 라우터는 순차 노드 내에서 사용할 수 있어 선형 플로우가 계속하기 전에 분기할 수 있습니다.

Q: AI 라우터에 변수가 필요한가요? A: 아니요. AI 라우터는 사용자의 자연어 응답과 사용자가 정의한 의도를 사용합니다.

Q: 조건부 라우터에 변수가 필요한가요? A: 네. 조건부 라우터는 값이 이미 수집되고 평가를 위해 저장되었을 때 가장 잘 작동합니다.

Q: 의도나 조건이 일치하지 않으면 어떻게 되나요? A: 각 경로가 올바른 다음 노드에 연결되어 있는지 확인하고 필요한 곳에 대체 경로를 포함하여 대화가 예상대로 계속될 수 있도록 하세요.

Q: 경로가 예상 노드로 가지 않으면 어떻게 해야 하나요? A: 경로 구성을 검토하고, 올바른 노드 연결을 확인하며, 의도나 조건이 올바르게 설정되었는지 확인하기 위해 대화를 다시 테스트하세요.

Q: 라우터가 추가 AI 메시지 비용을 발생시키나요? A: AI 라우터 실행만 LLM 청구에 포함됩니다. 조건부 및 무조건 모드는 무료입니다.

Q: 의도나 조건이 일치하지 않으면 어떻게 되나요? A: 플로우는 "Default" 에지를 따릅니다. 연결된 것이 없으면 대화는 오류 로그 항목과 함께 종료됩니다.

Q: 하나의 노드에서 AI 및 조건부 라우팅을 혼합할 수 있나요? A: 하나의 라우터 노드는 한 번에 하나의 모드만 지원하지만, 여러 라우터를 연달아 연결할 수 있습니다.

Q: 의도 학습이 필요한가요? A: 아니요. LLM이 의도 이름과 현재 대화 맥락에서 즉석에서 분류합니다.

Q: 잘못된 경로를 디버깅하려면 어떻게 하나요? A: 실행 로그 → 라우팅 탭을 열어 감지된 의도, 추론, 신뢰도 또는 평가된 조건 문자열을 확인하세요.

Q: 플로팅 패널이 에이전트 스튜디오의 모든 팝업을 대체하나요? A: 네, 미래의 노드 유형은 캔버스를 보이게 유지하기 위해 동일한 비모달 패널을 사용할 것입니다.

#### 관련 문서

* [에이전트 스튜디오 개요](/hyperclass-docs/ai-ai-employee/agent-studio-overview.md)
* [HighLevel에서 AI 에이전트 스튜디오 사용하기](/hyperclass-docs/ai-ai-employee/how-to-use-the-ai-agent-studio-in-highlevel.md)
* [Ask AI + 에이전트 스튜디오 연동](/hyperclass-docs/ai-ai-employee/ask-ai-agent-studio-integration.md)
* [실시간 시작을 위한 에이전트 스튜디오 트리거 설정하기](/hyperclass-docs/ai-ai-employee/how-to-set-up-agent-studio-triggers-for-real-time-starts.md)
* [에이전트 스튜디오에서 커스텀 값 및 변수 사용하기](/hyperclass-docs/ai-ai-employee/how-to-use-custom-values-and-variables-in-agent-studio.md)

***

*원문 최종 수정: Wed, 1 Apr, 2026 at 9:04 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/ai-ai-employee/agent-studio-router-tool-ai-conditional-router.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.