> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 공유 및 액세스 제어

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

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>베타</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                베타 기능. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        자세히 보기.
                    </a>
                </u>
            </span>
        </div>;
};

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

<div id="roles">
  ## 역할
</div>

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

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

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

<div id="resource-sharing">
  ## 리소스 공유
</div>

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

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

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

<div id="principals">
  ## 주체
</div>

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

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

조직 전체 공개 설정을 사용하면 [마켓플레이스](/ko/products/cloud/features/ai-ml/agents/marketplace)에서 리소스를 찾을 수 있습니다.

<div id="share-an-agent">
  ## 에이전트 공유하기
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/sharing/sharing.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=f46efe3ab7d11d0cfe7bfb5cacad492d" alt="공유 아이콘이 강조 표시되어 있고 하나의 공유된 주체를 나타내는 배지가 표시된 Agent Builder 패널 하단" size="sm" width="696" height="1934" data-path="images/cloud/agent-builder/sharing/sharing.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/XOOlYBuM8pBBOTzZ/images/cloud/agent-builder/sharing/share-agent-modal.webp?fit=max&auto=format&n=XOOlYBuM8pBBOTzZ&q=85&s=65818ba8c86d1b81fff9330b36473984" alt="사용자 및 그룹 권한 섹션, 검색 입력란, Owner 역할이 있는 기존 사용자, Share with everyone in ClickHouse 토글, Cancel 및 Save Changes 버튼이 있는 공유 모달" size="md" width="1544" height="824" data-path="images/cloud/agent-builder/sharing/share-agent-modal.webp" />

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

<div id="default-agent">
  ## 기본 에이전트
</div>

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

<div id="admin-operations">
  ## 관리자 작업
</div>

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

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

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

<div id="gotchas">
  ## 주의사항
</div>

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