시스템 관리
시스템 관리는 관리 권한이 있는 멤버를 위한 기능으로, 조직 멤버, 시스템 사용량, 비용 제한, 샌드박스 리소스를 관리하여 팀이 통제 가능한 권한, 사용량, 실행 환경 안에서 Agent를 사용할 수 있도록 합니다.
대상 독자: 슈퍼 관리자, Agent 관리자. 이 문서에서는 조직 수준의 관리를 소개합니다. 워크스페이스 내 멤버와 공용 기능 설정은 새 공간 생성하기를 참고하십시오.
검색 키워드: System settings, 시스템 관리, Agent 멤버, 관리자 권한, 시스템 사용량, 비용 관리, 할당량, 샌드박스 관리, 공유 샌드박스.
시스템 관리로 해결할 수 있는 문제
팀에서 Agent를 사용하기 시작하면 여기에서 어떤 멤버가 사용할 수 있는지 결정하고, 사용량이 어디에서 발생하는지 파악하고, 사용 제한을 설정하고, 개인 또는 공유 공간의 실행 환경을 관리할 수 있습니다.
- 멤버 등록 및 관리: Agent 멤버를 추가하고 활성화 상태, 관리자 역할, 사용자 제한 규칙을 조정합니다.
- 사용 현황 분석: 모델 소비와 도구 호출을 확인하여 주의가 필요한 사용자, 모델 또는 제품을 찾습니다.
- 사용량 제어: 회사 한도와 사용자 제한 규칙을 설정하고 잔액, 사용량 진행률, 한도 도달 사용자를 확인합니다.
- 실행 환경 보장: 샌드박스의 사용 가능 상태, 공유 공간 리소스, 샌드박스 도구를 관리합니다.
진입 방법: 워크벤치 사이드바의 플랫폼 제품 영역에서 시스템 관리를 선택하여 Agent 시스템 관리로 들어간 후, 목적에 따라 Agent 멤버, 시스템 사용량, 비용 관리 또는 샌드박스 관리를 선택합니다. 진입점이 없거나 권한이 없다는 안내가 표시되면 슈퍼 관리자 또는 Agent 관리자에게 계정 권한 확인을 요청하십시오.
권한 경계: 공간 Owner라고 해서 시스템 관리 권한이 자동으로 부여되지는 않습니다. 시스템 관리의 공유 공간 리소스 관리 권한이 있어도 해당 공간의 콘텐츠 접근 권한이 자동으로 부여되지는 않습니다. 공유 공간에 들어가려면 여전히 멤버 자격이 있어야 하고 공간이 사용 가능한 상태여야 합니다.
모델 설정은 모델에서, 메시지 채널 연동은 채널 관리에서 통합 관리합니다.
Agent 멤버 관리
Agent 멤버에 들어가면 멤버를 검색하고 활성화됨 또는 비활성화 상태로 필터링할 수 있습니다. 목록에는 멤버의 사용 가능 모델, 한도와 주기, 기간 내 사용 금액, 상태가 표시됩니다.
멤버 추가
- 멤버 추가를 클릭하고 선택 가능한 멤버 중에서 Agent 사용 권한을 부여할 회사 멤버를 선택합니다.
- 필요에 따라 제한 규칙 연결을 선택합니다. 이 항목은 선택 사항이며, 아직 규칙이 없으면 먼저 비용 관리에서 규칙을 추가할 수 있습니다.
- 개인 실행 환경도 함께 만들어야 하면 구성원에게 샌드박스 생성에 체크합니다. 남은 할당량이 부족하면 이 선택으로 제출할 수 없습니다.
- 일괄 추가를 클릭하고 작업 결과를 확인한 후, 멤버 상태, 제한 규칙, 샌드박스가 예상대로인지 다시 확인합니다.
일부 성공 안내가 표시되면 멤버는 이미 추가되었지만 제한 규칙 연결이나 샌드박스 생성이 아직 완료되지 않았을 수 있습니다. 먼저 성공한 항목을 확인한 후 실패한 항목을 각각 보완하십시오. 전체 작업이 완전히 실패한 것으로 보고 멤버를 다시 추가하지 마십시오.
상태, 역할 및 사용량 관리
활성화 또는 비활성화: 멤버 상태 스위치를 사용합니다. 비활성화하기 전에 확인이 필요하며, 비활성화하면 해당 멤버는 Agent 시스템을 사용할 수 없습니다. 사용을 일시 중지해야 할 때는 비활성화로 목적을 달성할 수 있는지 먼저 검토하십시오.
관리자 역할 조정: 멤버의 더보기 메뉴에서 관리자로 설정 또는 관리자 취소를 선택합니다. 슈퍼 관리자는 이 페이지에서 비활성화, 제거하거나 역할을 변경할 수 없습니다. 자신의 관리자 권한을 취소하면 페이지가 새로고침되고 권한을 다시 검증합니다.
제한 규칙 수정: 멤버의 제한 규칙 편집 작업을 클릭하여 해당 멤버에게 적용할 규칙을 선택합니다. 규칙의 한도, 주기, 사용 가능 모델은 비용 관리에서 통합 관리합니다.
멤버 사용량 보기: 사용량 상세를 클릭하면 선택한 날짜 범위의 Token, 대화 횟수, Agent 도구 호출 횟수, 추이 및 최근 대화 기록을 확인할 수 있습니다. Agent 도구 호출에는 MCP와 CLI가 모두 포함되므로 이 수치를 MCP 호출 횟수로 그대로 간주하면 안 됩니다.
멤버 제거: 더보기 메뉴에서 멤버 제거를 선택하고 확인합니다. 제거하면 해당 멤버는 시스템에 접근할 수 없게 됩니다. 이는 멤버를 특정 워크스페이스에서 내보내는 것이 아닙니다. 공간 멤버만 조정하려면 새 공간 생성하기의 공간 멤버 및 권한 설명에 따라 진행하십시오.
시스템 사용량 조회
사용량 조회는 팀의 실제 사용 현황을 파악하는 데 사용합니다. 시스템 사용량에 들어가 해결하려는 문제에 따라 뷰를 선택합니다.
| 뷰 | 답할 수 있는 질문 | 작업 포인트 |
|---|---|---|
| 개요 | 전체 소비량은 얼마이고 추이가 변했습니까? 사용량이 많은 모델은 무엇입니까? | 날짜 범위를 선택하여 비용, Token, 요청, 활성 사용자, 도구 호출 등의 지표를 확인합니다. Top 모델을 클릭하면 LLM 사용량 뷰로 이동하여 해당 모델을 찾을 수 있습니다. |
| LLM 사용량 | 소비가 어떤 사용자, 모델 또는 제품에서 발생했습니까? | 사용자, 모델, 제품 또는 날짜별로 그룹화하고 검색, 정렬, 드릴다운합니다. 필요에 따라 현재 뷰, 현재 드릴다운 또는 전체 상세 CSV를 내보냅니다. |
| Agent 도구 호출 | MCP나 CLI를 누가 호출했고, 성공과 오류 현황은 어떻습니까? | MCP 또는 CLI를 선택하고 호출 출처와 선택 가능한 집계 기준을 함께 사용하여 추이, 집계, 개별 호출 상세를 확인하고 CSV로 내보냅니다. |
비교하기 전에 날짜를 먼저 맞추십시오. 개요와 LLM 사용량은 날짜 범위를 각각 따로 관리합니다. 개요에서 모델을 찾은 후에도 현재 사용량 뷰의 날짜를 확인해야 합니다. 사용자 지정 날짜는 확인해야 적용되며, 범위 제한은 페이지 안내를 따릅니다.
로드 실패와 사용량 0을 구분하십시오. —, 비용 사용 불가 또는 도구 호출 로드 실패는 실제 소비가 0이라는 뜻이 아닙니다. 새로고침에 실패하면 페이지에 마지막으로 성공한 데이터가 계속 표시될 수 있으므로 업데이트 시간을 확인하고 다시 시도하십시오.
분석 결과에서 이어서 처리하십시오. 특정 사용자를 찾은 후 사용량 드릴다운에서 해당 사용자의 비용 관리 규칙으로 이동할 수 있습니다. 모델 설정을 조정해야 하면 모델을 바로 참고하십시오.
비용 관리 설정
시스템 사용량은 무슨 일이 있었는지 확인하는 데, 비용 관리는 사용을 허용할 한도와 모델을 설정하는 데 사용합니다. 비용 관리에 들어가 먼저 계정 잔액, 회사 사용량, 규칙, 한도 도달 사용자를 확인한 후 조정할 제한을 선택합니다.
회사 한도 및 사용자 제한 규칙
회사 한도: 회사 멤버가 하나의 월간 한도 풀을 공유합니다. 회사 한도 추가를 클릭하거나 기존 회사 한도를 편집하여 금액 제한 또는 Token 제한을 선택하고, 월간 한도를 입력한 후 저장합니다.
사용자 제한 규칙: 사용자에게 배정하는 사용 규칙을 정의합니다. 규칙을 추가하거나 편집할 때 규칙 이름을 입력하고, 매일, 매주 또는 매월과 제한 방식을 선택한 후 한도와 사용 가능 모델을 설정하고 사용자를 배정합니다. 이 규칙에 연결된 사용자는 규칙에 따라 사용이 제한됩니다.
Token 제한을 사용하면 총 Token 한도를 설정하고 필요에 따라 모델별 상한을 추가할 수 있습니다. 모델 상한을 추가하지 않으면 총 Token 풀의 제한만 받습니다. 모델 상한은 양수여야 하며 총 한도를 초과할 수 없습니다. 금액이나 Token을 입력할 때는 페이지에 표시된 통화와 단위에 유의하십시오.
사용 가능 모델과 한도는 서로 다른 제한입니다. 특정 모델의 사용 가능 설정을 해제하면 해당 모델에 연결된 Agent를 사용할 수 없게 될 수 있습니다. 새 모델 기본 사용 가능을 활성화하면 모델별 사용 가능 여부를 하나씩 수동으로 선택하지 않아도 됩니다. 조정하기 전에 영향을 받는 멤버와 해당 Agent를 확인하십시오.
저장한 후 규칙이 활성화되었는지, 사용자 배정이 올바른지 확인합니다. 사용자가 한도에 도달하면 해당 사용자의 규칙 주기, 사용 금액, 회사 한도를 확인한 후 규칙이나 배정 관계를 조정할지, 주기가 갱신되기를 기다릴지 결정합니다. 사용자 한도에 도달하지 않았다고 해서 회사 한도가 반드시 남아 있는 것은 아닙니다. 규칙을 비활성화하거나 삭제하기 전에도 영향 범위를 확인해야 합니다.
계정 잔액 및 알림
현재 계정 잔액을 확인하고, 필요에 따라 잔액 알림을 켜고 양수인 알림 금액을 설정합니다. 잔액이 이 값보다 낮아지면 시스템이 비용 관리 페이지와 사용자 사이드바에 알림을 표시합니다. 알림을 끄면 설정한 알림 금액이 지워집니다.
잔액 알림은 자금 상황을 알려 주는 기능이며, 회사 한도나 사용자 제한 규칙을 대신하지 않고 자동 충전 기능도 아닙니다.
샌드박스 및 공유 공간 리소스 관리
샌드박스 환경은 실행 공간을 격리하는 데 사용하며, Skill의 스크립트 파일 실행 등의 작업을 지원합니다. 샌드박스 관리에 들어가면 샌드박스 사용 현황을 확인하고 개인 샌드박스, 공유 샌드박스, 샌드박스 도구, 배포 기록 사이를 전환할 수 있습니다. 기능이 활성화되지 않은 경우 샌드박스 관리 진입점이 표시되지 않을 수 있습니다.
개인 샌드박스
개인 샌드박스에서 대상 사용자나 샌드박스를 검색하고 연결된 사용자, 사용 가능 상태, 컨테이너 상태, 마지막 접속 시간을 확인합니다. 새로 만들어야 하면 개인 샌드박스 생성을 클릭하고 사용자를 선택한 후 필요에 따라 설명을 입력합니다. 일괄 생성으로 여러 사용자의 샌드박스를 한 번에 만들 수도 있습니다.
생성하거나 활성화하기 전에 남은 할당량을 먼저 확인합니다. 이미 개인 샌드박스가 있는 사용자는 다시 만들 필요가 없습니다. 일괄 작업 후에는 대상별 결과를 확인하고 실패한 항목을 처리해야 합니다.
사용 가능 상태와 실행 상태를 구분하십시오: 사용 가능 스위치는 샌드박스 사용 허용 여부를 제어하고, 시작 또는 중지는 샌드박스가 현재 실행 중인지를 제어합니다. 사용 가능으로 표시되어도 실행 중이라는 뜻은 아니며, 중지도 삭제와 같지 않습니다. 상태가 전환 중이면 결과를 기다린 후 새로고침하여 확인하십시오.
관리자는 페이지에서 제공하는 작업에 따라 개인 샌드박스를 시작, 중지, 편집 또는 삭제할 수 있으며, 여러 샌드박스를 선택하여 일괄 처리할 수도 있습니다. 중지하기 전에 중요한 작업이 실행 중이지 않은지 확인하고, 삭제하기 전에는 영향과 보존해야 할 내용을 확인하십시오. 삭제를 일반적인 재시작으로 여기지 마십시오.
사용자가 자신의 리소스, 작업 디렉터리, 터미널을 확인하려면 내 샌드박스를 바로 참고하십시오.
공유 샌드박스
공유 샌드박스에는 공유 공간과 해당 공간 전용 샌드박스가 표시됩니다. 공유 공간을 생성할 때 공간 Owner를 선택하고 공간 정보를 입력합니다. 제출한 후에는 현재 단계와 상태를 확인하고 초기화와 검사가 완료될 때까지 기다립니다. 제출에 성공했다고 해서 공간을 바로 사용할 수 있는 것은 아닙니다. 실패하면 먼저 오류 정보를 확인하고, 같은 생성 요청을 반복해서 제출하지 마십시오.
사용 가능 상태 관리: 공유 샌드박스를 비활성화하면 실행도 함께 중지되어 공간 멤버가 작업을 계속 실행할 수 없게 됩니다. 다시 활성화하면 사용 가능 상태만 복구될 뿐 샌드박스가 시작되는 것은 아니므로 실행 상태를 따로 확인해야 합니다.
Owner 이전: 새 공간 Owner를 선택하고 확인합니다. 새 Owner는 공간에 추가되고, 기존 Owner는 공간 멤버로 남습니다. 리소스 관리 권한이 있는 관리자는 해당 공간의 멤버가 아니어도 권한에 따라 Owner를 이전할 수 있습니다. 단, 공간에 들어가려면 여전히 멤버 자격이 있어야 하고 공간이 사용 가능한 상태여야 합니다.
공유 공간 삭제: 삭제하면 공유 샌드박스도 함께 처리되며 복구할 수 없고, 모든 멤버의 기존 대화에 영향을 줍니다. 실행을 잠시 중지하거나 담당자를 바꾸기만 하려면 공간을 바로 삭제하지 마십시오.
공간의 생성 정보, 멤버, 공용 기능 설정은 새 공간 생성하기를 참고하십시오. 이 페이지에서는 조직 수준의 리소스 관리만 설명합니다.
샌드박스 도구 및 배포 기록
샌드박스 도구에서 사전 설정 도구와 사용자 정의 도구를 확인하고, 필요에 따라 도구 목록을 새로고침하거나 사용자 정의 도구를 관리하거나, 선택한 도구에 대해 배포, 비활성화, 상태 새로고침을 실행할 수 있습니다. 배포하기 전에 대상 샌드박스 범위를 먼저 확인하십시오. 전체 running 샌드박스는 현재 목록의 검색, 필터, 페이지 구분의 제한을 받지 않으며, 실행 중이 아닌 샌드박스는 건너뜁니다.
배포 또는 비활성화를 제출한 후 배포 기록에서 대상, 성공, 실패, 건너뜀 결과를 확인합니다. 일부 실패한 경우 처리가 필요한 대상만 재시도하십시오. 결과가 상태 확인 필요로 표시되면 먼저 실제 상태를 새로고침하여, 알 수 없는 결과를 미실행으로 간주하지 않도록 하십시오.
도구의 관리형 진입점을 비활성화해도 같은 이름의 명령이 모두 제거되는 것은 아니며, 환경에 이미 있는 같은 이름의 다른 버전이 계속 사용될 수 있습니다. 특정 사용자가 실제로 사용할 수 있는 도구를 확인해야 하면 해당 사용자에게 내 샌드박스에서 확인하도록 요청할 수 있습니다.
자주 묻는 질문 및 다음 단계
| 발생한 문제 | 먼저 확인할 사항 |
|---|---|
| Agent 시스템 관리가 보이지 않거나 권한이 없다는 안내가 표시됨 | 현재 계정에 슈퍼 관리자 또는 Agent 관리자 권한이 있는지 확인합니다. 공간 Owner나 다른 플랫폼의 관리 권한으로는 대신할 수 없습니다. |
| 멤버를 추가했지만 여전히 작업을 실행할 수 없음 | 멤버가 활성화되었는지, 추가 결과에 일부 실패가 있는지, 개인 샌드박스나 현재 공유 공간을 사용할 수 있는지, 그리고 모델 및 할당량 제한을 확인합니다. |
| 개인 사용량이 한도에 도달하지 않았는데도 제한 안내가 표시됨 | 회사 한도, 사용자 규칙 주기, 사용 가능 모델을 함께 확인합니다. 개인 사용량 진행률만 보지 마십시오. |
| 샌드박스가 사용 가능으로 표시되지만 작업을 시작할 수 없음 | 실행 상태, 연결 관계, 생성 단계를 추가로 확인합니다. 공간과 샌드박스의 연결이 일치하지 않으면 먼저 원인을 조사하고, 바로 삭제 후 다시 만들지 마십시오. |
| 사용량이 비어 있음, — 표시 또는 새로고침 실패 | 날짜, 필터 조건, 업데이트 시간, 오류 안내를 확인합니다. 누락되었거나 로드되지 않은 데이터를 사용량 0으로 간주하면 안 됩니다. |
전체 목차로 돌아가지 않고 현재 목적에 맞는 페이지를 바로 이어서 읽을 수 있습니다.
- 특정 공간의 멤버와 공용 기능만 관리: 새 공간 생성하기.
- 개인 샌드박스 상태, 작업 디렉터리, 터미널 확인: 내 샌드박스.
- 모델 리소스, 기본 모델, 사용 가능 여부 관리: 모델.
- Feishu, Slack 등 메시지 플랫폼 연동 설정: 채널 관리.
- 개인 메시지 계정 권한 부여 및 연결 완료: 채널 개요 및 연결.
소속 목차: 플랫폼 및 설정. 위의 관련 페이지에서 바로 이어서 읽을 수 있습니다.