AI 에이전트 권한 선택하기
API 토큰이나 연결된 앱이 가질 수 있는 모든 권한, 각 권한의 허용 범위, 포함된 프리셋, 그리고 권한을 부여할 수 있는 역할(소유자, 관리자, 편집자, 콘텐츠 제작자)에 대해 알아봅니다.
모든 API 토큰과 연결된 앱은 에이전트가 워크스페이스에서 수행할 수 있는 작업을 결정하는 권한(기능) 세트를 가집니다. 이 문서에서는 각 권한의 의미와 허용 범위, 포함된 프리셋, 그리고 권한을 부여할 수 있는 역할을 나열합니다.
권한 작동 방식
- 에이전트는 토큰을 생성한 사람의 역할 범위 내에서 해당 사람처럼 행동합니다. 에이전트는 소유자가 앱에서 할 수 있는 것보다 더 많은 작업을 수행할 수 없으며, 소유자가 볼 수 있는 녹화본, 영상, 컬렉션만 확인할 수 있습니다.
- 사용자의 역할에 따라 부여 가능한 권한이 결정됩니다. 토큰 마법사와 연결 화면에서 사용자의 역할로 부여할 수 없는 권한은 "사용자의 역할로는 이 권한을 부여할 수 없습니다."라는 문구와 함께 비활성화됩니다(게시 권한의 경우 "소유자, 관리자, 편집자만 게시 권한을 부여할 수 있습니다."라고 표시됩니다). 해당 권한이 포함된 프리셋은 "사용자의 역할로는 이 프리셋의 모든 기능을 부여할 수 없습니다."라는 문구와 함께 비활성화됩니다.
- 역할은 토큰 생성 시점이 아닌 모든 호출 시점에 확인됩니다. 나중에 소유자의 역할이 변경되면, 새로운 역할에서 허용되지 않는 권한이 필요한 호출은 거부되며 토큰 목록에 역할 범위를 초과함이 표시됩니다: "소유자의 역할이 변경되었습니다. 취소선이 표시된 기능이 필요한 호출은 거부됩니다."
- 각 권한에는 종류가 있으며, 마법사에서 배지로 표시됩니다: 읽음, 편집, 게시, 관리 또는 크레딧 사용.
- 에이전트는 권한으로 허용된 도구(MCP)와 엔드포인트(REST)만 볼 수 있습니다. 권한이 없는 도구를 호출하면 "이 토큰에는 … 기능이 없습니다."라는 응답이 반환됩니다.
프리셋
토큰 마법사의 첫 번째 단계(어떤 용도인가요?)에서는 프리셋을 제공합니다. 하나를 선택하면 해당 권한이 체크되며, 다음 단계에서 자유롭게 변경할 수 있습니다. 변경 시 마법사에는 사용자 지정됨이 표시되며 다음으로 재설정 프리셋 옵션이 나타납니다.
| 프리셋 | 화면 설명 | 권한 |
|---|---|---|
| 작성자 | "에이전트가 초안을 작성하고, 사람이 검토 후 게시합니다." | content:read, articles:write, changelog:write, media:write |
| 게시자 | "독자가 보는 내용을 변경할 수 있는 신뢰할 수 있는 자동화." | help:read 및 insights:read를 제외한 모든 문서 사이트 권한 |
| 고객 지원 어시스턴트 | "게시된 문서에서 답변합니다. 다른 작업은 수행하지 않습니다." | help:read |
| 읽기 전용 | "조사, 감사 및 번역 확인." | content:read |
| 분석가 | "콘텐츠와 독자 신호를 읽어 수정 사항을 제안합니다." | content:read, insights:read |
| 프로듀서 | "콘텐츠 초안을 작성하고 지출 한도 내에서 유료 작업을 시작합니다." | 작성자 권한 및 site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| 워크스페이스 에이전트 | "지출 한도 내에서 이 워크스페이스 내 에이전트가 할 수 있는 모든 작업." | help:read을 제외한 모든 권한 |
프로듀서와 워크스페이스 에이전트에는 credits:spend이 포함되어 있으므로, 마법사는 제한 단계에서 지출 한도를 설정하도록 요청합니다. 에이전트 지출 및 승인 제어하기를 참조하세요.
작성자, 게시자, 고객 지원 어시스턴트, 읽기 전용 및 분석가 프리셋은 문서 사이트용입니다.
영상 권한
| 권한 | 종류 | 허용 범위 |
|---|---|---|
library:read |
읽음 | "소유자가 볼 수 있는 녹화본, 영상, 아티클 및 대본 읽기": 라이브러리와 녹화본 목록 확인, 항목, 대본 및 아티클 읽기, 임베드 가져오기. |
videos:create |
편집 | "녹화본에서 영상, 아티클 인용 및 요청, 번역": 견적 요청, 녹화본에서 하우투(how-to), 제품 데모, 정리 및 스타일 영상, 소셜 클립, 아티클 및 영상 번역 요청. 유료 작업 시작 시 credits:spend도 필요합니다. |
videos:export |
편집 | "영상 내보내기 및 임베드 가져오기": 1080p(기본값), 2K 또는 4K, 60fps로 MP4 렌더링 및 다운로드 링크 가져오기. 내보내기에는 크레딧이 소모되지 않습니다. |
materials:write |
편집 | "새 영상에 사용되는 워크스페이스 업로드에 이미지, 영상 및 PDF 추가". |
워크스페이스 권한
| 권한 | 종류 | 허용 범위 |
|---|---|---|
credits:spend |
크레딧 사용 | "토큰의 한도 내에서 견적된 작업에 크레딧 사용". 유료 작업을 시작할 때 해당 작업 권한(예: videos:create)과 함께 필요한 두 번째 핵심 권한입니다. |
jobs:read |
읽음 | "소유자의 다른 토큰이 시작한 작업 확인". 토큰은 항상 자신의 작업을 볼 수 있으며, 이 권한을 추가하면 소유자의 다른 토큰 작업도 볼 수 있습니다. 또한 에이전트가 작업을 취소하고 워크스페이스의 크레딧 잔액을 읽을 수 있게 합니다. |
문서 권한
이 권한들은 문서 사이트에 적용됩니다. 제한 → 문서 사이트에서 토큰은 모든 사이트("새 사이트를 포함하여 이 워크스페이스의 모든 문서 사이트.") 또는 선택된 사이트를 대상으로 합니다.
| 권한 | 종류 | 허용 범위 |
|---|---|---|
content:read |
읽음 | "사이트, 페이지, 아티클(초안 포함), 수정 내역, 변경 로그 및 사이트 페이지 읽기". 사이트 설정, 디자인, 탐색 및 리디렉션 포함. |
articles:write |
편집 | "아티클 초안 생성 및 게시되지 않은 아티클 편집". 아티클 번역(유료) 시 credits:spend도 필요합니다. |
structure:write |
편집 | "섹션 생성 및 편집, 페이지 이동, 숨기기 및 이름 변경". |
site-pages:write |
편집 | "홈, 연락처, 법적 고지 등 사이트 페이지 편집". AI를 사용한 사이트 페이지 생성 또는 번역(유료) 시 credits:spend도 필요합니다. |
changelog:write |
편집 | "변경 로그 항목을 초안으로 생성 및 편집". |
media:write |
편집 | "이미지 업로드". |
site:publish |
게시 | "게시: 독자가 보는 내용 변경, 라이브 콘텐츠 편집, 페이지 준비 완료 표시". 변경 로그 항목 게시 및 삭제, 사이트 롤백 포함. |
insights:read |
읽음 | "사이트 인사이트 읽기: 검색 공백, 답변되지 않은 질문 및 페이지 피드백". articles:write과 함께 사용 시 공백을 해결됨으로 표시할 수 있습니다. |
site:configure |
관리 | "사이트 설정, 디자인 및 탐색 변경" 및 리디렉션 추가. |
sites:create |
관리 | "새 문서 사이트 생성". |
help:read |
읽음 | "게시된 공개 페이지 검색만 가능(고객 지원 어시스턴트)". 이 권한만 있는 토큰은 다른 내용을 볼 수 없습니다. |
권한 부여 가능 대상
| 권한 | 소유자 | 관리자 | 편집자 | 콘텐츠 제작자 |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
예 | 예 | 예 | 예 |
library:read |
예 | 예 | 예 | 예 |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
예 | 예 | 예 | 예 |
videos:export |
예 | 예 | 예 | 예 |
videos:create, materials:write, credits:spend |
예 | 예 | 아니요 | 예 |
site:publish, site:configure |
예 | 예 | 예 | 아니요 |
sites:create |
예 | 예 | 아니요 | 아니요 |
콘텐츠 제작자는 토큰에 credits:spend을 부여할 수 있지만, 승인이 필요한 유료 작업은 항상 워크스페이스 소유자나 관리자가 승인하며, 토큰 소유자 단독으로 승인할 수 없습니다. 에이전트 지출 및 승인 제어하기를 참조하세요.
아직 에이전트가 사용할 수 없는 기능
에이전트는 아직 웹사이트 조사나 녹화된 워크스루를 실행하거나, 다른 플랫폼에 영상을 게시할 수 없습니다. 해당 권한은 부여할 수 없습니다.