# Hyperclass에서 AI 에이전트 스튜디오 사용하는 방법

에이전트 스튜디오는 Hyperclass의 노코드/로우코드 플랫폼으로, AI 기반 에이전트를 쉽게 설계하고 관리하며 배포할 수 있습니다. 직관적인 드래그 앤 드롭 빌더와 강력한 툴 노드, 유연한 배포 옵션으로 고급 기술 지식 없이도 지능형 에이전트를 만들 수 있습니다. 대화 흐름을 구축하거나 API를 연결하거나 지식 베이스를 연결하든, 에이전트 스튜디오는 AI 솔루션을 빠르고 안정적으로 출시할 수 있도록 도와줍니다.

**목차**

* [에이전트 스튜디오란?](#에이전트-스튜디오란)
* [에이전트 스튜디오의 주요 장점](#에이전트-스튜디오의-주요-장점)
* [드래그 앤 드롭 에이전트 빌더](#드래그-앤-드롭-에이전트-빌더)
* [툴 노드](#툴-노드)
* [로직 및 흐름 제어](#로직-및-흐름-제어)
* [버전 관리](#버전-관리)
* [에이전트 내보내기 및 가져오기](#에이전트-내보내기-및-가져오기)
* [테스트 탭](#테스트-탭)
* [API 액세스](#api-액세스)
* [에이전트 스튜디오 설정 방법](#에이전트-스튜디오-설정-방법)
* [자주 묻는 질문](#자주-묻는-질문)

***

## **에이전트 스튜디오란?**

에이전트 스튜디오는 Hyperclass의 AI 기반 에이전트 생성을 위한 비주얼 플랫폼입니다. 드래그 앤 드롭 워크플로우, 다양한 툴 노드, 원활한 연동을 결합하여 지능적으로 응답하고 프로세스를 자동화하며 외부 데이터 소스와 연결되는 에이전트를 설계할 수 있습니다.

에이전트 스튜디오는 고객을 지원하고 운영을 간소화하며 기존 시스템에 통합할 수 있는 강력한 에이전트를 만드는 데 필요한 도구를 제공합니다.

> **참고**: 에이전트 스튜디오는 현재 에이전시 관리자와 에이전시 사용자만 사용할 수 있습니다.

## **에이전트 스튜디오의 주요 장점**

에이전트 스튜디오는 AI 에이전트 구축을 간단하고 강력하며 실제 사용 사례에 맞게 적응 가능하도록 설계되었습니다.

* **드래그 앤 드롭 빌더**: 직관적인 비주얼 캔버스로 워크플로우를 빠르게 생성
* **다양한 툴 노드**: 전용 노드 타입으로 인텔리전스, 지식, 연동 기능 추가
* **로직 및 흐름 제어**: 더 스마트한 자동화를 위한 분기, 조건, 변수 처리 관리
* **버전 관리**: 구조화된 생명주기 단계로 에이전트를 안전하게 개발, 테스트, 배포
* **내장 테스트**: 프로덕션 배포 전 에이전트 성능 검증
* **연동 유연성**: API, 지식 베이스, 웹에 연결하여 동적이고 상황 인식 응답 제공
* **내보내기/가져오기 기능**: 에이전트를 쉽게 공유, 백업, 마이그레이션
* **API 액세스**: 기존 워크플로우에 맞게 에이전트를 프로그래밍 방식으로 실행

## **드래그 앤 드롭 에이전트 빌더**

드래그 앤 드롭 빌더는 AI 에이전트 워크플로우를 생성하고 관리하는 비주얼 방법을 제공합니다. 노드를 연결하고 흐름 조건을 설정하여 복잡한 프로세스를 쉽게 설계할 수 있습니다.

이 빌더를 통해 다음이 가능합니다:

* 로직, 데이터, 인텔리전스를 위한 툴 노드 연결
* 코딩 없이 워크플로우를 시각적으로 구성
* 동적 응답을 위한 런타임 및 글로벌 변수 관리

![에이전트 스튜디오 빌더 인터페이스](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155051847732/original/5W_KZpJS2W_xGyJGw2cXw48l8Iq9Jmdp7w.png?1755545252)

## **툴 노드**

툴 노드는 에이전트 스튜디오의 핵심 구성 요소입니다. 각 노드 타입은 특정 기능을 추가하여 고유한 요구 사항에 맞는 에이전트를 설계할 수 있습니다.

### **LLM 노드**

LLM 노드는 고급 대규모 언어 모델을 활용하여 지능적이고 상황 인식 응답을 생성합니다. 워크플로우에 맞게 프롬프트, 매개변수, 출력 처리를 구성할 수 있습니다.

### **MCP 툴 노드**

MCP 툴 노드는 모델 컨텍스트 프로토콜을 통해 외부 도구를 통합하여 에이전트의 능력을 확장합니다. 외부 데이터 소스에 액세스하거나 작업을 트리거하는 데 유용합니다.

### **API 툴 노드**

API 툴 노드는 API를 통해 데이터를 송수신하여 타사 서비스에 직접 연결합니다. 이를 통해 에이전트가 외부 시스템과 동적으로 상호작용할 수 있습니다.

### **지식 베이스 툴 노드**

에이전트에 지식 베이스를 연결하여 업로드된 문서나 저장된 정보를 기반으로 응답할 수 있습니다. 이는 정확하고 일관된 답변을 보장합니다.

### **웹 검색 툴 노드**

에이전트가 인터넷에서 최신 정보를 검색할 수 있도록 합니다. 이를 통해 에이전트의 응답을 신선하고 관련성 있으며 정확하게 유지할 수 있습니다.

## **로직 및 흐름 제어**

로직 및 흐름 제어 기능을 통해 에이전트가 복잡한 시나리오를 처리하고 조건에 따라 결정을 내릴 수 있습니다.

* **엣지 조건을 통한 분기**: 변수 값이나 입력에 따라 다른 경로 정의
* **변수 관리**: 글로벌, 런타임 또는 입력 변수를 생성하여 상황 인식적이고 유연한 응답 보장

## **버전 관리**

에이전트 스튜디오는 초안(Draft), 스테이징(Staging), 프로덕션(Production) 모드로 구조화된 생명주기 관리를 지원합니다. 이를 통해 변경 사항이 실제 운영에 영향을 주기 전에 테스트되어 프로덕션 중단을 방지합니다.

에이전트 스튜디오는 실시간 대화에 영향을 주기 전에 변경 사항을 안전하게 테스트할 수 있도록 버전 관리를 사용합니다.

**스테이징**: 작업 중인 버전입니다. 저장하면 실시간 트래픽에 영향을 주지 않고 스테이징이 업데이트됩니다.

**프로덕션**: 실제 연락처에서 실행되는 실시간 버전입니다. 프로덕션 버전은 스테이징 버전을 \*\*승격(promote)\*\*할 때만 생성됩니다.

승격, 복원 및 여러 프로덕션 버전 작업에 대한 자세한 내용은 에이전트 스튜디오 버전 관리(스테이징, 프로덕션, 버전 기록)를 참조하세요.

## **에이전트 내보내기 및 가져오기**

내보내기/가져오기 기능으로 에이전트를 백업, 공유 또는 환경 간 이동할 수 있습니다. 이를 통해 에이전트를 처음부터 다시 구축하지 않고도 협업하거나 설정을 마이그레이션하기가 더 쉬워집니다.

## **테스트 탭**

내장된 테스트 탭을 통해 에이전트 워크플로우를 프로덕션으로 푸시하기 전에 시뮬레이션하고 검증할 수 있습니다. 이를 통해 오류를 식별하고 로직 경로를 확인하며 에이전트 성능을 개선할 수 있습니다.

## **API 액세스**

에이전트 스튜디오는 보안 API를 제공하여 에이전트를 프로그래밍 방식으로 실행할 수 있습니다. 이를 통해 에이전트를 기존 시스템이나 워크플로우에 쉽게 임베드할 수 있습니다.

## **에이전트 스튜디오 설정 방법**

적절한 설정을 통해 에이전트 스튜디오와 그 기능을 최대한 활용할 수 있습니다. 시작하려면 다음 단계를 따르세요:

* Hyperclass 대시보드에서 **AI Agents(AI 에이전트)** > \*\*Agent Studio(에이전트 스튜디오)\*\*로 이동합니다.
* \*\*Create Agent(에이전트 생성)\*\*를 클릭하여 드래그 앤 드롭 빌더를 엽니다.

![에이전트 스튜디오 생성 화면](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155051847840/original/pFVtm3nY83aETZK4qzFlUYel2jCBwVDYUw.png?1755545519)

* 워크플로우에 툴 노드(LLM, MCP, API, 지식 베이스 또는 웹 검색)를 추가합니다.
* 노드를 엣지로 연결하여 로직 경로를 정의합니다.
* 노드 간 데이터 전달을 위한 변수를 구성합니다.
* **테스트 탭**을 사용하여 에이전트의 흐름을 검증합니다.
* 에이전트를 저장하여 **스테이징 버전**을 생성/업데이트합니다. 실시간 운영 준비가 되면 스테이징 버전을 프로덕션으로 **승격**합니다.
* (선택사항) 필요한 경우 에이전트를 내보내거나 공유합니다.
* API 액세스를 사용하여 에이전트를 프로그래밍 방식으로 실행합니다.

***

## **자주 묻는 질문**

**Q: 에이전트 스튜디오와 대화 AI는 어떻게 다른가요?**

A: 에이전트 스튜디오는 대화 AI에 비해 여러 노드 타입을 갖춘 비주얼 빌더를 제공하여 더 복잡한 워크플로우와 연동이 가능합니다.

**Q: 에이전트 스튜디오에서 내 문서를 사용할 수 있나요?**

A: 네, 업로드된 문서와 함께 지식 베이스를 연결하여 에이전트가 정확한 답변을 제공할 수 있도록 할 수 있습니다.

**Q: MCP란 무엇이고 왜 사용해야 하나요?**

A: MCP(모델 컨텍스트 프로토콜)는 외부 도구와의 통합을 가능하게 하여 표준 노드를 넘어 에이전트의 기능을 확장합니다.

**Q: 에이전트를 만들 때 버전 관리가 필수인가요?**

A: 필수는 아니지만 에이전트를 프로덕션에 배포하기 전에 안전하게 테스트하고 스테이징하기 위해 버전 관리를 권장합니다.

**Q: 계정 간에 에이전트를 마이그레이션할 수 있나요?**

A: 네, 내보내기/가져오기 기능을 통해 환경 간에 에이전트를 공유하거나 이동할 수 있습니다.

**Q: 실시간 운영 전에 에이전트를 테스트하는 방법은?**

A: 내장된 테스트 탭을 사용하여 시뮬레이션을 실행하고 에이전트의 워크플로우를 검증하세요.

**Q: Hyperclass에서 누가 에이전트 스튜디오에 액세스할 수 있나요?**

A: 액세스는 계정 권한에 따라 다릅니다. 에이전시 관리자와 적절한 역할을 가진 사용자가 에이전트를 구축하고 관리할 수 있습니다.

**Q: 에이전트 스튜디오가 API 연동을 지원하나요?**

A: 네, API 툴 노드를 통해 외부 API에 연결하거나 보안 API 액세스를 통해 에이전트를 실행할 수 있습니다.

***

*원문 최종 수정: Wed, 25 Mar, 2026 at 2:27 PM* *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/how-to-use-the-ai-agent-studio-in-highlevel.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.