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

역할

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

리소스 공유

에이전트, 프롬프트, 스킬에는 각각 액세스 목록이 있습니다. 각 주체마다 3가지 액세스 수준이 있습니다:
  • Viewer - 리소스를 사용할 수 있지만 수정할 수는 없습니다.
  • Editor - 리소스의 구성(지침, 연결된 도구, 모델 등)을 변경할 수 있습니다.
  • Owner - Editor 권한에 더해 리소스를 삭제하거나 공유 설정을 변경할 수 있습니다.
리소스를 생성하면 기본적으로 해당 리소스의 소유자가 됩니다. 명시적으로 공유하지 않은 항목은 모두 본인에게만 공개됩니다.

주체

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

에이전트 공유하기

Agent Builder 하단의 공유 아이콘을 클릭합니다. 아이콘의 배지에는 현재 액세스할 수 있는 사용자 또는 그룹 수가 표시됩니다. 공유 모달이 열립니다. 이름이나 이메일로 사용자 또는 그룹을 검색하고, 액세스 수준(Viewer, Editor, 또는 Owner)을 선택한 다음 Save Changes를 클릭합니다. 조직 전체에 공유하려면 Share with everyone in ClickHouse 토글을 활성화합니다. 공유받은 사용자는 다음에 새로 고침할 때 사용 가능한 에이전트 목록에서 해당 에이전트를 볼 수 있습니다. 액세스를 취소하려면 같은 모달에서 해당 행을 제거합니다. 액세스 권한은 즉시 사라지지만, 진행 중인 대화는 마무리되며 새 대화는 열 수 없습니다.

기본 에이전트

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

관리자 작업

관리자만 수행할 수 있는 작업은 다음과 같습니다:
  • 역할 생성 및 편집
  • 마켓플레이스 카테고리 구성 및 추천 에이전트 선별
  • 조직 수준에서 기능(메모리, 웹 검색, 코드 인터프리터, 마켓플레이스 등) 활성화 또는 비활성화
  • 다른 사용자에게 관리자 권한 부여
ClickHouse Cloud에서는 조직 관리자에게 관리자 패널이 제공됩니다. 관리자 패널이 보이지 않으면 조직 관리자 또는 ClickHouse Cloud 지원팀에 문의하여 액세스를 요청하십시오.

주의사항

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