> For the complete documentation index, see [llms.txt](https://runyourai.gitbook.io/userguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://runyourai.gitbook.io/userguide/runyour-agent/admin/undefined-2.md).

# 그룹 관리

**그룹**은 멤버·지식·크레딧을 배분하는 조직 단위입니다. 기관 관리자는 그룹을 생성·조회·설정합니다.

#### 접근 경로

좌측 사이드바의 **그룹** 메뉴를 클릭하면 그룹 목록이 표시됩니다. (일반 사용자는 본인 그룹 상세로 바로 이동합니다.)

<div data-with-frame="true"><figure><img src="/files/oQF5Jr4jP7gyET118WXV" alt=""><figcaption><p><strong>그룹 목록</strong> — 그룹 카드와 크레딧 사용 현황을 봅니다</p></figcaption></figure></div>

#### 그룹 생성

좌측 상단의 **그룹 생성하기** 카드를 클릭하면 3단계 온보딩 흐름이 시작됩니다. 각 단계에서 \[취소]나 닫기(X)를 누르면 이전 단계까지 저장된 채 흐름이 종료됩니다. 동일 기관 내 그룹명은 중복될 수 없습니다(인라인 오류).

{% stepper %}
{% step %}

### 그룹 생성하기

그룹명을 입력하고 **생성하기**를 클릭하면 그룹이 목록에 추가되고, 곧바로 크레딧 지급 모달이 팝업됩니다.
{% endstep %}

{% step %}

### **그룹에 크레딧 지급하기**

방금 만든 그룹에 금액을 입력해 **지급하기**를 누르거나 **취소**로 건너뜁니다. 이어서 멤버 추가 모달이 팝업됩니다.
{% endstep %}

{% step %}

### 멤버 추가하기

기존 멤버를 검색해 선택하거나 새 이메일을 입력하고 **완료**를 클릭합니다.
{% endstep %}
{% endstepper %}

#### 그룹 상세

그룹 카드를 클릭하면 상세 페이지가 열립니다. 상단에는 요약 카드 3종(보유 크레딧·멤버·모델별 사용 현황)이 고정되고, 하단은 3개 탭으로 구성됩니다.&#x20;

<table><thead><tr><th width="147.01171875">탭</th><th>내용</th></tr></thead><tbody><tr><td>멤버 목록</td><td>그룹 멤버 조회·추가·권한 변경·내보내기</td></tr><tr><td>지식 베이스</td><td>그룹 공용 컬렉션 목록 조회 및 편집 진입</td></tr><tr><td>사용 분석</td><td>월별 필터 기반 사용 추이·크레딧 현황·호출 이력</td></tr></tbody></table>

<div data-with-frame="true"><figure><img src="/files/BcLcf94IRashhT3zEQPZ" alt=""><figcaption><p><strong>그룹 상세</strong> — 요약 카드와 멤버·지식·분석 탭으로 구성됩니다</p></figcaption></figure></div>

#### 그룹 멤버 관리 (멤버 목록 탭)

* **멤버 추가**: 우측 상단 **`그룹 멤버 추가`** 버튼 클릭 → 타 그룹 소속 멤버를 선택하면 확인 후 이동 편입되고, 미가입 이메일은 초대 후 '가입 대기 중'으로 할당됩니다.
* **매니저 지정/해제**: 멤버 행의 더보기(⋯) 메뉴에서 **매니저 부여하기 / 매니저 해제하기**를 클릭해 역할을 변경합니다.
* **그룹에서 내보내기**: 더보기 메뉴에서 실행하면 멤버는 그룹에서 제외되며 '소속 없음' 상태로 전환됩니다. 그룹 지식 베이스에 올린 자료는 원작자 표기와 함께 유지되지만, 해당 멤버가 발급한 **API 키는 함께 삭제**됩니다.
* **검색**: 상단 검색창에 이름·이메일을 입력하면 부분 일치로 필터링됩니다.

#### 그룹 설정·삭제

* 우측 상단 **그룹 설정**을 클릭해 그룹명·설명을 수정하고 **저장하기**를 누릅니다.
* 같은 모달의 **그룹 삭제**를 선택하고 경고 모달에서 최종 승인하면 그룹이 삭제됩니다.

{% hint style="danger" %}
그룹을 삭제하면 하위 자산(지식 베이스·에이전트)이 **영구 파기**되고, 소속 멤버는 '소속 없음'으로 전환되며, **잔여 크레딧은 기관 미배정 예치금으로 회수**됩니다. 되돌릴 수 없으니 신중히 진행하세요.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://runyourai.gitbook.io/userguide/runyour-agent/admin/undefined-2.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.