관리자 어시스턴트

**관리자 어시스턴트(Admin Assistant)**는 슈퍼 관리자 대시보드의 채팅 패널입니다. 이를 사용하여 관리자 UI를 떠나지 않고 플랫폼 상태를 검사하고 사용자 정의 툴킷을 구축 및 공유할 수 있습니다.

릴리스 노트에서는 이 기능이 **툴킷 관리 어시스턴트(Toolkit Management Assistant)**로 표시될 수 있습니다. 제품 UI에서 버튼과 패널은 Admin Assistant라는 레이블이 표시됩니다.

이는 내장 엔터프라이즈 툴킷(OAuth, 활성화/비활성화, 범주)을 활성화하고 구성하는 툴킷 탭과는 별개입니다. 어시스턴트는 프로젝트에 이미 존재하는 작업(Action) 및 워크플로우에 대한 링크의 이름이 지정된 번들인 사용자 정의 툴킷으로 작업합니다.

전제 조건

역할에 Custom Toolkits → Manage가 포함되어 있어야 합니다(RBAC 참고). 없으면 Admin Assistant 버튼이 숨겨집니다.
번들하려는 작업 또는 워크플로우가 프로젝트에 이미 존재해야 합니다(어시스턴트는 링크만 하고 새 도구를 만들지 않습니다).
공유 툴킷을 받을 팀을 알고 있어야 합니다.

패널 열기

Super Admin을 엽니다.
헤더 바에서 Admin Assistant(방패 아이콘)를 클릭합니다.
크기를 조절할 수 있는 사이드 패널이 열립니다(약 400–800px 너비; 왼쪽 가장자리를 끌어 크기 조절).

컨트롤	목적
New chat	대화를 지우고 새로 시작
Close	패널 숨기기(플랫폼 상태는 변경되지 않음)
작성기	자리 표시자: Ask the Admin Assistant… — Enter를 눌러 전송
Stop	표시되는 중 생성을 취소

빈 상태 문구: Build and share custom toolkits, 플랫폼을 변경하는 모든 것은 먼저 묻는다는 안내와 함께. 제안 칩을 클릭하면 해당 프롬프트가 전송됩니다.

사용자 정의 툴킷이란

사용자 정의 툴킷은 이미 존재하는 것들에 대한 링크 번들입니다:

연결된 리소스	위치
작업(Action)	프로젝트의 작업 라이브러리
워크플로우	프로젝트의 워크플로우 / 도구 편집기

중요한 속성:

툴킷은 도구를 복사하거나 소유하지 않습니다. 원본이 있는 홈 프로젝트를 가리키며, 그곳의 편집은 툴킷이 공유된 모든 곳에 적용됩니다.
팀과 공유하면 해당 팀의 에이전트가 툴킷을 사용할 수 있습니다. 에이전트별 개별 opt-in 단계는 없습니다.
표시 이름은 사람이 읽을 수 있는 것이며, 슬러그는 변경할 수 없고 모델이 보는 도구 이름의 네임스페이스 역할을 합니다.
어시스턴트는 새 작업이나 워크플로우를 작성할 수 없습니다. 먼저 작업 라이브러리나 도구 편집기에서 생성한 다음 어시스턴트에게 링크를 요청하세요.

질문하기 대 변경하기

요청 유형	예	발생하는 일
읽기	팀 목록, 사용자 정의 툴킷 목록, 사용량 리더보드, 링크 가능한 작업/워크플로우 검색, 툴킷 세부 정보 조회	승인 카드 없이 실행
변경	툴킷 생성/수정/삭제, 작업 또는 워크플로우 링크/링크 해제, 팀과 공유	먼저 승인 카드 표시

승인 카드

변경이 제안되면:

도구 이름, 위험 수준, 인수를 검토합니다.
Allow(또는 레이블이 붙은 확인 동작)를 선택하여 실행하거나, Deny를 선택하여 플랫폼을 그대로 둡니다.
가장 최신 어시스턴트 턴만 활성 승인을 보유합니다. 이전 카드는 재실행할 수 없습니다.

채팅에 "확인해 주세요"를 입력할 필요는 없습니다. 변경을 호출하고 카드를 사용하세요. 패널 부제목은 Confirms every change before it runs입니다.

모든 도구 호출은 본인의 관리자 권한으로 인증됩니다. 호출이 권한 오류를 반환하면, 어시스턴트는 조용히 다른 경로를 시도하는 대신 무엇이 부족한지 보고해야 합니다.

일반적인 워크플로우: 툴킷 구축 및 공유

어시스턴트에게 툴킷 생성을 요청합니다(명확한 표시 이름 제공).
작업 또는 워크플로우가 이미 있는 프로젝트를 가리킵니다(어시스턴트가 확인할 수 있는 프로젝트 이름 사용).
각 작업 또는 워크플로우를 한 번에 하나씩 검색 및 링크하도록 합니다.
올바른 팀과 툴킷을 공유하도록 요청합니다.
요약을 검토합니다: 툴킷 이름, 내용, 볼 수 있는 사람.

링크 시 어시스턴트가 입력 경고를 표시할 수 있습니다(예: 도구의 홈 프로젝트 밖의 호출자에게는 작동하지 않을 수 있는 파일 업로드 입력). 링크는 여전히 성공할 수 있으며, 경고를 호출자를 위한 지침으로 취급하세요.

공유는 팀 목록을 대체합니다

팀 집합과 툴킷을 공유하면 전체 공유 팀 목록을 대체합니다. 다른 팀을 유지하면서 하나만 추가하려면:

현재 공유 팀을 읽습니다(먼저 get / 툴킷 검사).
기존 팀 ID에 새 팀을 추가하여 전달합니다.

새 팀만 전달하면 다른 모든 팀의 공유가 해제됩니다.

어시스턴트가 도울 수 있는 일

기능	참고
사용자 정의 툴킷 목록/검사	플랫폼 전체 사용자 정의 툴킷 목록
사용자 정의 툴킷 생성, 수정, 삭제	승인으로 제어
프로젝트에서 링크 가능한 작업 및 워크플로우 검색	확인된 프로젝트 내 쿼리로 검색
작업 및 워크플로우 링크 / 링크 해제	한 번에 하나씩; 입력 경고에 주의
팀과 툴킷 공유	대체 의미론 — 위 참조
플랫폼 팀 목록	공유 및 탐색용
팀 사용량 리더보드	예: 최근 기간(예: 최근 30일)의 사용량
프로젝트 목록 / 프로젝트 세부 정보	도구가 어디에 있는지 확인하기 위해

내장 툴킷 활성화, OAuth 구성, 툴킷 범주 관리를 위한 Super Admin → Toolkits를 대체하지 않습니다.

예시 프롬프트

지금 어떤 사용자 정의 툴킷이 있나요?
이 플랫폼의 팀을 나열해 주세요.
최근 30일 동안 가장 많은 사용량을 기록한 팀은 어디인가요?
우리 Jira 작업을 지원 팀용 툴킷으로 묶어 주세요.

한계 및 팁

채팅에서 ID를 절대 지어내지 마세요 — 검색/목록 결과에서 어시스턴트가 팀, 프로젝트, 작업, 워크플로우, 툴킷을 확인하게 하세요.
여러 프로젝트나 도구가 일치할 수 있는 경우 정확한 이름을 사용하세요. 모호하면 어시스턴트가 어떤 것인지 물어야 합니다.
무관한 작업으로 전환할 때는 이전 컨텍스트가 공유나 링크를 혼동하지 않도록 New chat을 사용하세요.
도구가 아직 없으면 먼저 프로젝트에서 생성한 다음 어시스턴트로 돌아와 링크하세요.
내장 툴킷 활성화, OAuth, 범주 컨트롤은 Super Admin → Toolkits에 있습니다.

문제 해결

증상	확인할 사항
Admin Assistant 버튼이 없음	역할에 Custom Toolkits → Manage가 없음
승인 카드가 표시되지 않지만 아무것도 변경되지 않음	Deny했을 수 있음; 또는 요청이 읽기 전용이었음
워크플로우 중간에 권한 오류	역할로 어시스턴트를 열 수는 있지만 도구에 필요한 특정 관리자 API 권한이 없음
공유 시 다른 팀이 빠짐	공유는 전체 대체입니다 — 완전한 팀 목록으로 다시 공유하세요
작업/워크플로우를 찾을 수 없음	잘못된 프로젝트이거나, 해당 프로젝트에 도구가 생성된 적이 없음
링크 후 입력 경고	경고를 검토하세요. 링크는 일부 호출자에게는 유효할 수 있지만 다른 호출자에게는 아닐 수 있음

전제 조건​

패널 열기​

사용자 정의 툴킷이란​

질문하기 대 변경하기​

승인 카드​

일반적인 워크플로우: 툴킷 구축 및 공유​

공유는 팀 목록을 대체합니다​

어시스턴트가 도울 수 있는 일​

예시 프롬프트​

한계 및 팁​

문제 해결​

관련 문서​