# Agent Studio에서 폴더 생성 및 관리하는 방법

## Agent Studio에서 폴더 생성 및 관리하는 방법

Hyperclass Agent Studio의 새로운 폴더 관리 도구로 대규모 AI 직원 라이브러리를 빠르게 정리하고, 검색하고, 관리하세요. 폴더, 일괄 작업, 서버 사이드 페이지네이션, 유연한 뷰를 통해 가장 큰 작업공간도 깔끔하고 빠르게 유지할 수 있습니다.

***

**목차**

* [Agent Studio의 폴더 관리란?](#agent-studio의-폴더-관리란)
* [Agent Studio 폴더 관리의 주요 이점](#agent-studio-폴더-관리의-주요-이점)
* [폴더 구성](#폴더-구성)
* [폴더 설정 및 관리 방법](#폴더-설정-및-관리-방법)
* [새 폴더 만들기](#새-폴더-만들기)
* [정렬 및 그룹화](#정렬-및-그룹화)
* [AI 직원 검색](#ai-직원-검색)
* [일괄 작업](#일괄-작업)
* [점 세 개 메뉴](#점-세-개-메뉴)
* [폴더 관리](#폴더-관리)
* [페이지 크기 조정](#페이지-크기-조정)
* [자주 묻는 질문](#자주-묻는-질문)

***

## **Agent Studio의 폴더 관리란?**

폴더 관리는 Agent Studio 목록 페이지에 전용 폴더 계층을 추가합니다. AI 직원을 폴더별로 그룹화하고 일괄 이동/삭제, 상태 라벨, API 기반 페이지네이션과 같은 강력한 기능을 제공하여 소수의 테스트 봇에서 수백 개의 프로덕션 AI 직원까지 확장해도 아무것도 놓치지 않고 관리할 수 있습니다.

***

### Agent Studio 폴더 관리의 주요 이점

* **시각적 구조**: 실험용과 라이브 버전을 분리하거나 팀, 고객, 프로젝트별로 분류할 수 있습니다.
* **빠른 정리**: 원클릭 일괄 작업으로 반복 작업을 대폭 줄입니다.
* **즉시 상태 파악**: 초안 vs 발행됨 라벨로 추측 작업을 없앱니다.
* **대용량 성능**: 서버 사이드 페이지네이션과 조정 가능한 행 수로 목록을 빠르게 유지합니다.
* **커스터마이즈 가능한 뷰**: 폴더 우선 또는 AI 직원 우선 그룹화를 선택하고 이름이나 최근 업데이트순으로 정렬합니다.
* **실수 방지**: 명확한 확인 대화상자로 실수로 인한 삭제를 방지합니다.

***

### 폴더 구성

필요한 만큼 상위 레벨 폴더를 만들고, AI 직원을 폴더 간에 드래그하거나 일괄 이동할 수 있습니다. 언제든지 폴더 이름을 바꾸거나 삭제할 수 있으며, 기본 AI 직원은 그대로 유지됩니다.

### 일괄 작업

여러 AI 직원이나 폴더를 선택하고 다음 중 선택하세요:

* **일괄 삭제**: 선택한 항목을 영구 삭제합니다.
* **일괄 이동**: 많은 AI 직원을 한 번에 다른 폴더로 이동합니다.
* **폴더 일괄 삭제**: 사용하지 않는 그룹을 정리합니다(내부 AI 직원은 직접 삭제할 때까지 유지됩니다).

이러한 작업은 사용자 권한을 존중하며 영향을 받는 정확한 수와 함께 확인 메시지를 표시합니다.

![폴더 관리 데모](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066049302/original/Wk2jpP5kcHA1urfpeb5se_garvUg4IslgQ.gif?1772503843)

***

### 폴더 설정 및 관리 방법

다음 간단한 단계를 따라 작업공간 정리를 시작하세요:

#### 새 폴더 만들기

* Agent Studio 우상단의 **새 폴더(New Folder)** 버튼을 클릭하여 폴더 생성 모달을 엽니다.
* **폴더 이름(Folder Name)** 필드에 명확하고 설명적인 이름을 입력합니다.
* (선택사항) **연결된 AI 직원(Associated Agents)** 드롭다운을 열고 이 폴더에 포함하고 싶은 그룹화되지 않은 AI 직원을 선택합니다.
* \*\*저장(Save)\*\*을 클릭하여 폴더를 생성하면 선택한 AI 직원이 목록 뷰에서 해당 폴더 아래 즉시 그룹화되어 나타납니다.

![새 폴더 만들기 데모](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066049289/original/n4FqSj8jib0DCRSthOCkQU8iCF6Cc_6bNA.gif?1772503741)

#### 정렬 및 그룹화

**정렬 기준(Sort by)** 드롭다운을 클릭하여 AI 직원 표시 방식을 조정합니다. **AI 직원 우선(Agent First)** 또는 **폴더 우선(Folder First)** 간에 전환하고, **이름(Name)**, **최근 업데이트(Last Updated)**, 또는 \*\*생성일(Created Date)\*\*별로 정렬할 수 있습니다.

![정렬 및 그룹화 옵션](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066049312/original/Ft4l6JVh6shTZIxxQceA8KT7DoXH2CzZBg.png?1772503900)

#### AI 직원 검색

우상단의 **검색(Search)** 바를 사용하여 이름으로 AI 직원을 빠르게 필터링하세요. 결과가 즉시 업데이트되어 대규모 라이브러리에서도 특정 AI 직원을 쉽게 찾을 수 있습니다.

![검색 기능](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066049320/original/wbMIb7vuB0lZwJr7t8aK-WpGf5t0cCt19g.png?1772503946)

#### 일괄 작업

목록에서 하나 이상의 AI 직원 옆 체크박스를 클릭하여 일괄 작업을 활성화합니다. 선택된 수가 상단 근처에 표시되어 다음 작업으로 영향받을 AI 직원 수를 확인할 수 있습니다.

**일괄 작업 선택**

* AI 직원을 선택한 후 우상단의 **일괄 작업(Bulk Actions)** 드롭다운을 클릭합니다. 여기서 **폴더로 이동(Move to Folder)** 또는 \*\*삭제(Delete)\*\*를 선택하여 선택한 모든 항목에 한 번에 변경사항을 적용할 수 있습니다.
* AI 직원을 선택하고 폴더로 이동 또는 삭제를 선택한 후 확인 모달이 나타납니다. 선택한 AI 직원을 이동할 대상 폴더를 선택하거나 AI 직원 삭제를 클릭하여 선택한 AI 직원의 일괄 삭제 작업을 확인합니다.

![일괄 작업 인터페이스](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066049336/original/I59ny1ZPaUmXSQ9ah0M-bhJch9vrDcdsgA.png?1772504007)

#### 점 세 개 메뉴

AI 직원 행의 점 세 개(**⋮**) 메뉴를 클릭하여 개별 작업에 액세스합니다. 여기서 세부사항을 **편집**하거나, AI 직원을 폴더로 **이동**하거나, **삭제**할 수 있습니다.

![점 세 개 메뉴](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066049608/original/T0N2msAVoeePoCZXsJZfEwa11MUz-uujHQ.png?1772504612)

#### 폴더 관리

폴더 행은 폴더 아이콘을 표시하여 AI 직원과 시각적으로 구별됩니다. 폴더의 점 세 개 메뉴를 클릭하면 폴더 세부사항을 편집하거나 폴더 자체를 삭제할 수 있습니다.

![폴더 관리 인터페이스](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066049435/original/aR3pwTyNb6zJt7LgJaIAHFwHjXAUIzSigw.jpeg?1772504076)

#### 페이지 크기 조정

목록 하단의 **페이지당 행 수(Rows per page)** 드롭다운을 사용하여 화면에 나타날 AI 직원 수를 조절합니다. 작업공간 선호도에 맞게 10, 25, 50, 또는 100개 행 중에서 선택하세요.

![페이지 크기 조정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066048190/original/2y0uat-uGzkLy5OqzEczz5l-_Ip1idj6TA.png?1772499872)

***

### 자주 묻는 질문

**Q: 폴더를 삭제하면 그 안의 AI 직원도 삭제되나요?**

아닙니다. AI 직원은 \*\*"미분류(Unfiled)"\*\*로 이동하며 별도로 삭제하기 전까지 계속 접근 가능합니다.

**Q: 폴더를 중첩할 수 있나요?**

첫 번째 릴리스는 한 단계 폴더 레벨을 지원합니다. 중첩 폴더는 향후 업데이트에서 계획되어 있습니다.

**Q: 일괄 작업이 사용자 역할을 존중하나요?**

예, 삭제/이동 권한이 있는 사용자만 해당 작업을 볼 수 있으며, 이는 워크플로우 일괄 작업과 유사합니다.

**Q: 서버 사이드 페이지네이션이 기존 필터를 변경하나요?**

아닙니다. 결과를 페이지별로 탐색하면서 필터는 계속 적용됩니다.

**Q: 지난주에 발행한 AI 직원에 "초안"이 표시되는 이유는?**

발행하면 라이브 버전이 생성됩니다. 나중에 다시 발행하지 않고 편집하면 다시 발행할 때까지 작업 복사본이 초안으로 표시됩니다.

**Q: 두 사용자가 동시에 같은 AI 직원을 이동하면 어떻게 되나요?**

마지막으로 저장된 변경사항이 적용되며, 뷰가 오래된 경우 충돌 알림을 받게 됩니다.

***

*원문 최종 수정: 2026-03-02* *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-create-and-manage-folders-in-agent-studio.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.