​
개요

Clova Studio Gov는 역할 기반 접근 제어(RBAC)를 통해 리소스에 대한 접근을 관리합니다. 사용자 역할에 따라 모델, 지식, 에이전트에 대한 권한이 달라집니다.

​
사용자 역할

​
역할 유형

배포된 에이전트와 지식을 사용하는 일반 사용자입니다.할 수 있는 것:
  • ✅ 배포된 에이전트 사용
  • ✅ 배포된 지식 조회
  • ✅ 개인 대화 기록 조회
할 수 없는 것:
  • ❌ 에이전트 생성
  • ❌ 지식 업로드
  • ❌ 개발 중인 리소스 접근
  • ❌ API 사용
에이전트와 지식을 생성하고 관리하는 개발자입니다.할 수 있는 것:
  • ✅ 에이전트 생성 및 테스트
  • ✅ 지식 컬렉션 생성 및 관리
  • ✅ 배포 검토 요청 제출
  • ✅ 개발 중 리소스 삭제
  • ✅ API 키 발급 및 API 사용
할 수 없는 것:
  • ❌ 배포된 리소스 삭제
  • ❌ 배포 승인 권한
배포를 승인하고 시스템을 운영하는 관리자입니다.할 수 있는 것:
  • ✅ 배포 승인 및 반려
  • ✅ 모든 상태의 리소스 관리
  • ✅ 배포된 리소스 삭제
  • ✅ 사용자 권한 관리
  • ✅ API 키 발급 및 API 사용
책임: 배포 검토, 품질 관리, 시스템 운영

​
역할 비교

기능일반 사용자개발자관리자
배포된 에이전트 사용✅✅✅
개발 중 에이전트 테스트❌✅✅
에이전트 생성❌✅✅
배포 검토 요청❌✅✅
배포 승인❌❌✅
배포된 리소스 삭제❌❌✅
API 키 발급❌✅✅
API 사용 (모델/에이전트)❌✅✅

​
배포 상태와 접근 권한

에이전트와 지식 컬렉션은 배포 상태에 따라 접근 권한이 다릅니다.

​
배포 상태별 접근 권한

  • 개발 중 (Draft)
  • 배포 검토 요청 (Pending Review)
  • 배포됨 (Deployed)
설명: 리소스를 생성하고 설정을 조정하는 작업 단계입니다.접근 가능:
  • ✅ 개발자 (생성자 및 동일 팀)
  • ✅ 관리자
접근 불가:
  • ❌ 일반 사용자
가능한 작업:
  • 설정 수정
  • 테스트
  • 삭제
  • 배포 검토 요청 제출

배포 상태 자세히 보기

에이전트와 지식의 배포 프로세스에 대해 자세히 알아보세요:

​
API 접근 권한

​
API 키 발급 및 사용

API를 통해 모델이나 에이전트를 사용하려면 개발자 또는 관리자 권한이 필요합니다.

개발자 / 관리자

가능한 작업:
  • API 키 발급
  • API를 통한 모델 호출
  • API를 통한 에이전트 실행
  • API 사용량 모니터링
접근 메뉴: 정보시스템 관리자 메뉴 > API 키 관리

일반 사용자

제한:
  • API 키 발급 불가
  • API 사용 불가
  • 웹 인터페이스만 사용 가능
일반 사용자는 대화하기 메뉴에서만 에이전트를 사용할 수 있습니다.

​
API 키 발급 절차

1

정보시스템 관리자 메뉴 접속

개발자 또는 관리자 권한으로 로그인한 후, 정보시스템 관리자 메뉴로 이동합니다.
2

API 키 관리 메뉴 선택

좌측 사이드바에서 “API 키 관리” 메뉴를 클릭합니다.
3

새 API 키 발급

“새 API 키 발급” 버튼을 클릭하고 키 이름과 설명을 입력합니다.
4

API 키 저장

발급된 API 키를 안전한 곳에 저장합니다. 보안상 API 키는 한 번만 표시되므로 반드시 복사하여 저장하세요.
API 키 보안:
  • API 키는 절대 공개 저장소나 클라이언트 코드에 포함하지 마세요
  • 주기적으로 API 키를 재발급하여 보안을 강화하세요
  • 불필요한 API 키는 즉시 삭제하세요

​
API로 사용 가능한 기능

  • 모델 API
  • 에이전트 API
  • 지식 검색 API
Chat Completions API언어 모델과 직접 대화하거나 텍스트 생성 작업을 수행할 수 있습니다.권한:
  • 개발자 ✅
  • 관리자 ✅
  • 일반 사용자 ❌

API 문서 보기

Chat Completions API 사용 방법을 자세히 알아보세요.

​
역할별 주요 작업

​
개발자 워크플로우

1

리소스 생성

정보시스템 관리자 메뉴에서 에이전트 또는 지식 컬렉션을 생성합니다. 생성된 리소스는 개발 중(Draft) 상태입니다.
2

개발 및 테스트

  • 에이전트 설정 조정
  • 지식 문서 업로드
  • 대화하기에서 개발 중 에이전트 테스트
  • 충분히 검증
3

배포 검토 요청

정보시스템 관리자 메뉴에서 “배포 검토 요청” 버튼을 클릭합니다. 상태가 배포 검토 요청으로 변경됩니다.
4

승인 대기

관리자의 검토 및 승인을 기다립니다. 필요 시 요청을 취소하고 다시 수정할 수 있습니다.
중요: 배포된 리소스는 개발자가 삭제할 수 없습니다. 삭제가 필요한 경우 관리자에게 배포 취소를 요청하세요.

​
관리자 워크플로우

1

배포 검토 요청 확인

정보시스템 관리자 메뉴 > 에이전트/지식 관리에서 “배포 검토 요청” 필터를 선택합니다.
2

리소스 검토

  • 에이전트 설정 확인
  • 연결된 지식 컬렉션 확인
  • 테스트 실행
3

배포 승인 또는 반려

승인: “배포하기” 버튼 클릭 → 상태가 배포됨으로 변경반려: “반려” 버튼 클릭 → 상태가 개발 중으로 되돌아감
4

배포 후 관리

필요 시 배포된 리소스를 배포 취소하거나 삭제할 수 있습니다.

​
상태별 삭제 권한

리소스의 배포 상태에 따라 삭제 권한이 다릅니다.

개발자

삭제 가능:
  • ✅ 개발 중 (Draft)
  • ✅ 배포 검토 요청 (Pending Review)
삭제 불가:
  • ❌ 배포됨 (Deployed)

관리자

삭제 가능:
  • ✅ 모든 상태 (개발 중, 배포 검토 요청, 배포됨)
배포된 리소스도 삭제할 수 있습니다.
배포된 에이전트나 지식을 삭제해야 하는 경우, 개발자는 관리자에게 배포 취소를 요청한 후 삭제할 수 있습니다.

​
대화하기에서의 권한

​
에이전트 선택 권한

대화하기 메뉴에서 에이전트를 선택할 때 역할에 따라 노출되는 에이전트가 다릅니다.
에이전트 상태일반 사용자개발자관리자
개발 중 (Draft)❌ 미노출✅ 테스트 가능✅ 테스트 가능
배포 검토 요청 (Pending Review)❌ 미노출✅ 테스트 가능✅ 테스트 가능
배포됨 (Deployed)✅ 사용 가능✅ 사용 가능✅ 사용 가능
개발자와 관리자는 대화하기 메뉴에서 개발 중인 에이전트를 선택하여 테스트할 수 있습니다. 에이전트 이름 옆에 “개발 중” 또는 “배포 검토 요청” 라벨이 표시됩니다.

​
메뉴별 접근 권한

​
일반 메뉴

메뉴일반 사용자개발자관리자
대화하기✅✅✅
플레이그라운드✅✅✅
에이전트✅ (배포됨만)✅ (전체)✅ (전체)
지식 저장소✅ (배포됨만)✅ (전체)✅ (전체)

​
정보시스템 관리자 메뉴

메뉴일반 사용자개발자관리자
에이전트 관리❌✅✅
지식 저장소 관리❌✅✅
API 키 관리❌✅✅
정보시스템 관리자 메뉴는 개발자 이상의 권한이 필요합니다. 이 메뉴에서 에이전트와 지식 컬렉션을 생성, 수정, 삭제하고 배포 상태를 관리할 수 있습니다.

​
자주 묻는 질문

개발자: 정보시스템 관리자 메뉴 > 에이전트 관리에서 해당 에이전트를 선택하고 삭제 버튼을 클릭하세요.주의: 배포된(Deployed) 에이전트는 개발자가 삭제할 수 없습니다. 관리자에게 배포 취소를 요청한 후 삭제하세요.
네, 가능합니다.정보시스템 관리자 메뉴에서 해당 리소스를 선택하고 “배포 요청 취소” 버튼을 클릭하면 상태가 다시 **개발 중(Draft)**으로 변경됩니다.취소 후 다시 수정하고 재요청할 수 있습니다.
배포된 리소스는 읽기 전용이므로 직접 수정할 수 없습니다.수정 절차:
  1. 관리자에게 배포 취소 요청
  2. 관리자가 배포 취소 (Deployed → Draft)
  3. 개발자가 수정 작업 수행
  4. 다시 배포 검토 요청 제출
  5. 관리자 승인 후 재배포
아니요, 개발 중이거나 배포 검토 요청 상태의 에이전트는 일반 사용자에게 노출되지 않습니다.개발자와 관리자만 대화하기 메뉴에서 개발 중인 에이전트를 선택하여 테스트할 수 있습니다.
관리자(Team Admin) 역할을 가진 사용자만 배포를 승인하거나 반려할 수 있습니다.관리자는 정보시스템 관리자 메뉴에서 배포 검토 요청 상태의 리소스를 확인하고 검토할 수 있습니다.
아니요, 일반 사용자는 API 키를 발급받을 수 없으며 API를 사용할 수 없습니다.API 사용이 필요한 경우 관리자에게 개발자 권한을 요청하세요. 개발자 권한을 받으면 정보시스템 관리자 메뉴에서 API 키를 발급받을 수 있습니다.
네, 개발자와 관리자는 API를 통해 개발 중(Draft) 상태의 에이전트도 테스트할 수 있습니다.배포되지 않은 에이전트의 ID를 사용하여 API를 호출하면 테스트 목적으로 실행됩니다. 일반 사용자는 배포된(Deployed) 에이전트만 사용할 수 있습니다.
Agent ID는 API를 통해 에이전트를 호출할 때 필수로 필요한 고유 식별자입니다.확인 방법:
  1. 정보시스템 관리자 메뉴 > 에이전트 관리 클릭
  2. 에이전트 목록에서 에이전트 ID 열 확인
  3. ID 우측의 복사 아이콘을 클릭하여 복사
자세한 내용은 Agents API 문서를 참조하세요.
아니요, API 키는 보안상 생성 시 한 번만 표시되며 이후에는 다시 확인할 수 없습니다.API 키를 분실한 경우:
  1. 정보시스템 관리자 메뉴 > API 키 관리로 이동
  2. 분실한 API 키를 삭제
  3. 새로운 API 키를 발급받아 안전하게 저장
API 키는 반드시 발급 직후 안전한 곳(환경 변수, 비밀 관리 시스템)에 보관하세요.
현재 Clova Studio Gov에서 제공하는 모델 ID는 HCX-GOV-THINK (전부 대문자)입니다.API 요청 예시:
{
  "model": "HCX-GOV-THINK",
  "messages": [...]
}
다른 모델에 대한 자세한 정보는 언어 모델 종류 문서를 참조하세요.
messageId는 에이전트 API(A2A 프로토콜)에서 각 메시지를 고유하게 식별하기 위한 필수 필드입니다.사용 예시:
{
  "jsonrpc": "2.0",
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "messageId": "msg-123456",
      "parts": [{"text": "질문"}]
    },
    "metadata": {
      "chat_session_id": 123
    }
  },
  "id": "req-12345"
}
타임스탬프나 UUID를 사용하여 고유한 ID를 생성하는 것을 권장합니다. 자세한 내용은 Agents API 문서를 참조하세요.
네, 정확히 그렇게 설계되어 있습니다!에이전트 워크플로우:
  1. 생성 (웹): 정보시스템 관리자 메뉴에서 에이전트 생성 및 구성
  2. 배포 (웹): 관리자 승인을 통해 에이전트 배포
  3. 사용: 두 가지 방식 선택
    • 웹 UI: 대화하기 메뉴에서 대화형으로 사용
    • API: 프로그래밍 방식으로 에이전트 호출 및 자동화
중요: 에이전트 생성 및 설정은 웹에서만 가능하며, API는 이미 생성된 에이전트를 실행하는 용도입니다. 자세한 내용은 Agents API 문서를 참조하세요.

​
다음 단계

에이전트 배포

에이전트 배포 프로세스 자세히 알아보기

지식 배포

지식 컬렉션 배포 프로세스 자세히 알아보기

에이전트 생성

첫 에이전트 만들어보기

API 인증

API 키 발급 및 인증 방법