> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 공유 및 액세스 제어

> ClickHouse Agents의 권한 모델 및 액세스 제어

[베타 기능](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

Agents는 계층형 권한 모델을 사용합니다. 역할은 사용자가 어떤 기능을 아예 사용할 수 있는지를 제어하고, 리소스 수준 액세스 목록은 특정 에이전트 또는 기타 리소스를 누가 사용할 수 있는지를 제어하며, 관리자 권한은 전체 관리를 누가 수행할 수 있는지를 제어합니다.

## 역할

역할은 하나 이상의 사용자에게 할당되는 기능 권한의 묶음입니다. 기본 역할은 다음과 같습니다.

* **사용자** - 에이전트를 실행하고 채팅할 수 있습니다. 에이전트를 빌드할 수 있는지, 스킬을 생성할 수 있는지, 리소스를 공유할 수 있는지 등은 해당 역할의 기능별 토글 설정에 따라 달라집니다.
* **관리자** - 사용자의 모든 권한에 더해 조직 수준의 제어 권한이 있습니다. 예: 사용자 관리, 마켓플레이스 구성, 권한 부여.

관리자는 더 세밀한 제어를 위해 자체 토글이 있는 사용자 지정 역할을 만들 수 있습니다.

## 리소스 공유

에이전트, 프롬프트, 스킬에는 각각 액세스 목록이 있습니다. 각 주체마다 3가지 액세스 수준이 있습니다:

* **Viewer** - 리소스를 사용할 수 있지만 수정할 수는 없습니다.
* **Editor** - 리소스의 구성(지침, 연결된 도구, 모델 등)을 변경할 수 있습니다.
* **Owner** - Editor 권한에 더해 리소스를 삭제하거나 공유 설정을 변경할 수 있습니다.

리소스를 생성하면 기본적으로 해당 리소스의 소유자가 됩니다. 명시적으로 공유하지 않은 항목은 모두 본인에게만 공개됩니다.

## 주체

다음 대상에 액세스 권한을 부여할 수 있습니다.

* **개별 사용자** - 한 번에 사용자 1명씩 부여합니다.
* **그룹** - 팀 또는 조직 단위입니다. 이후 사용자가 그룹에 가입하거나 탈퇴하면 액세스 권한이 자동으로 업데이트됩니다.
* **조직 전체** - 조직의 모든 사용자가 리소스를 볼 수 있습니다. 이 옵션은 이를 허용하는 역할 수준 토글의 적용을 받습니다.

조직 전체 공개 설정을 사용하면 [마켓플레이스](https://clickhouse.com/docs/ko/agents/marketplace.md)에서 리소스를 찾을 수 있습니다.

## 에이전트 공유하기

Agent Builder 하단의 **공유** 아이콘을 클릭합니다. 아이콘의 배지에는 현재 액세스 권한이 있는 사용자 또는 그룹 수가 표시됩니다.

![공유 아이콘이 강조 표시되어 있고 하나의 공유된 주체를 나타내는 배지가 표시된 Agent Builder 패널 하단](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/sharing/sharing.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=f181e1ae813ac0990bf8cc01024ae91d)

**공유** 모달이 열립니다. 이름이나 이메일로 사용자 또는 그룹을 검색하고, 액세스 수준(**Viewer**, **Editor**, 또는 **Owner**)을 선택한 다음 **Save Changes**를 클릭합니다. 조직 전체에 공유하려면 **Share with everyone in ClickHouse** 토글을 활성화합니다.

![사용자 및 그룹 권한 섹션, 검색 입력란, Owner 역할이 있는 기존 사용자, Share with everyone in ClickHouse 토글, Cancel 및 Save Changes 버튼이 있는 공유 모달](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/sharing/share-agent-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=483d3eb9d915d7c467c50d4b6e517ae4)

공유받은 사용자는 다음에 새로 고침할 때 사용 가능한 에이전트 목록에서 해당 에이전트를 볼 수 있습니다. 액세스 권한을 취소하려면 같은 모달에서 해당 행을 제거합니다. 액세스 권한은 즉시 사라지지만, 진행 중인 대화는 마무리되며 새 대화는 열 수 없습니다.

## 기본 에이전트

에이전트 하나를 기본값으로 지정할 수 있습니다. 다른 에이전트를 선택하지 않으면 새 대화는 해당 에이전트로 시작됩니다. 사용자가 직접 기본 에이전트를 선택하지 않은 경우, 관리자는 조직 전체에 적용되는 기본값을 설정할 수도 있습니다.

## 관리자 작업

관리자만 수행할 수 있는 작업은 다음과 같습니다:

* 역할 생성 및 편집
* 마켓플레이스 카테고리 구성 및 추천 에이전트 선별
* 조직 수준에서 기능(메모리, 웹 검색, 코드 인터프리터, 마켓플레이스 등) 활성화 또는 비활성화
* 다른 사용자에게 관리자 권한 부여

ClickHouse Cloud에서는 조직 관리자에게 관리자 패널이 제공됩니다. 관리자 패널이 보이지 않으면 조직 관리자 또는 ClickHouse Cloud 지원팀에 문의하여 액세스를 요청하십시오.

## 주의사항

* **에이전트를 삭제하면 모든 공유가 끊어집니다.** 공유받은 사용자는 접근 권한을 잃습니다. 에이전트와의 저장된 대화는 계속 읽을 수 있지만, 이어서 진행할 수는 없습니다.
* **공유된 에이전트를 편집하면 이를 사용하는 모든 사용자에게 영향을 줍니다.** 다른 사용자에게 영향을 주지 않고 실험해야 한다면 복사본을 사용하십시오.
* **사용자의 역할을 회수해도 사용자가 만든 리소스는 삭제되지 않습니다.** 해당 사용자의 에이전트, 프롬프트, 스킬은 액세스 목록에 그대로 남아 있으므로, 완전히 오프보딩하기 전에 소유권을 이전하십시오.
