에이전트 지출 관리 및 요청 승인
에이전트가 유료 작업을 시작하는 방법: 견적, 작업당/일일/월간 지출 한도, 아래에서 자동 승인, 에이전트 요청 승인 또는 거부. 결정 권한자, 만료 및 모든 거부 메시지에 대해 알아봅니다.
에이전트는 제품 데모 영상이나 소셜 클립과 같이 크레딧이 소모되는 작업을 시작할 수 있지만, 이는 토큰에 설정한 제한 내에서만 가능하며, 토큰의 자동 승인 기준을 초과하는 작업은 사람이 직접 승인해야 합니다. 이 문서에서는 지출 한도, 자동 승인, 그리고 에이전트의 요청을 승인하거나 거부하는 방법을 설명합니다.
크레딧이 소모되는 작업
| 에이전트 무료 작업 | 크레딧 소모 작업 (앱과 동일) |
|---|---|
| 읽기, 검색 및 나열 | 녹화본 기반 영상 (방법 안내, 제품 데모, 정리, 스타일 적용) |
| 견적 및 테스트 실행 | 소셜 클립 |
| 작업 확인 및 대기 | 녹화본 기반 아티클 |
| 영상 내보내기 (최대 4K MP4) | 영상 번역 |
| 자료 및 이미지 업로드 | 문서 사이트 아티클, 변경 로그 및 사이트 페이지 번역, AI 생성 사이트 페이지 |
유료 작업을 시작하려면 토큰에 credits:spend 권한이 있어야 하며, 해당 작업에 대한 권한(예: videos:create)도 필요합니다. 프로듀서 및 워크스페이스 에이전트 프리셋에는 두 가지가 모두 포함되어 있습니다.
유료 작업 시작 확인 절차
모든 유료 작업은 시작 전 견적을 받습니다. 견적에는 크레딧 범위(예: 45~60 크레딧)가 포함되며, 15분간 유효하고 1회 사용할 수 있습니다. 에이전트가 작업을 시작하면 Clevera는 다음 순서로 확인합니다:
- 플랜. 유료 에이전트 작업은 Pro, Business 및 Custom 플랜에서 제공됩니다. 그 외의 경우: "현재 플랜에는 유료 에이전트 작업이 포함되어 있지 않습니다. 업그레이드하여 에이전트가 작업을 시작할 수 있도록 하세요."
- 크레딧. 앱에서 작업을 시작할 때와 마찬가지로, 워크스페이스에 견적을 처리할 충분한 크레딧이 있어야 합니다.
- 토큰 한도. 견적의 상한선은 작업당 한도 내에 있어야 하며, 일일 및 월간 한도의 잔여 크레딧(당일 또는 당월에 소모된 크레딧과 현재 실행 중인 토큰 작업의 견적 합계) 내에 있어야 합니다. 한도를 초과할 경우: "토큰의 지출 한도를 초과하게 됩니다. 워크스페이스 관리자가 한도를 상향할 수 있습니다."
- 승인. 견적의 상한선이 토큰의 아래에서 자동 승인 값보다 낮으면 작업이 시작됩니다. 그렇지 않으면 에이전트 요청에서 사람이 승인할 때까지 대기합니다.
작업 비용은 앱에서와 마찬가지로 실제 사용량에 따라 청구됩니다. 일일 및 월간 기준은 달력상의 날짜와 월을 따릅니다.
한도 설정
한도는 토큰 생성 시 제한 단계에서 설정합니다. 지출 항목은 토큰에 credits:spend 권한이 있을 때만 나타납니다.
| 필드 | 기능 | 비어 있거나 0인 경우 |
|---|---|---|
| 작업당 | 1회 시작 시 견적 가능한 최대치. | 비어 있음: 제한 없음. |
| 일일 | 토큰이 하루 동안 소모할 수 있는 최대치. | 비어 있음: 제한 없음. |
| 월간 | 토큰이 한 달 동안 소모할 수 있는 최대치. | 비어 있음: 제한 없음. |
| 아래에서 자동 승인 | 이 크레딧 미만으로 견적된 작업은 사람의 개입 없이 시작됨. | 0: "모든 유료 작업은 사람이 직접 승인". |
| 플랜 | 아래에서 자동 승인 최대치 |
|---|---|
| Pro, Business | 500 크레딧 |
| Custom | 1,000 크레딧 |
한도는 정수 단위의 크레딧입니다. 토큰의 한도는 나중에 변경할 수 없으므로, 한도를 높이거나 낮추려면 새 토큰을 생성하고 기존 토큰을 취소해야 합니다. 시크릿 키를 재생성해도 기존 한도는 유지됩니다.
요청 승인 또는 거부
에이전트 요청 열기
에이전트가 대기 중일 때 워크스페이스 소유자, 관리자 및 토큰 소유자에게 "agent이(가) 승인을 요청합니다"라는 알림과 함께 "최대 n 크레딧을 사용하려고 합니다."라는 메시지가 전송됩니다. 검토를 클릭하거나 AI 에이전트 & API → 에이전트 요청을 여세요. 탭에서 대기 중인 요청 수를 확인할 수 있습니다.
요청 확인
사용자 대기 중 아래의 각 요청에는 에이전트, 유형(크레딧 사용), 크레딧 범위, 작업 내용, 요청됨 시간, 만료일 및 사용된 토큰이 표시됩니다.
각 요청은 에이전트가 수행하려는 작업과 크레딧 범위를 보여줍니다. 결정
승인을 클릭하고 "이 요청을 승인하시겠습니까?"에서 확인하면 작업이 시작됩니다. 거부를 클릭하면 작업이 취소되고 비용이 청구되지 않습니다. 워크스페이스가 더 이상 Pro 이상의 플랜이 아닌 경우, 승인 버튼을 누르면 "API 및 에이전트 액세스가 현재 플랜에 포함되어 있지 않습니다."라는 메시지가 표시되지만 거부는 여전히 가능합니다.
- 워크스페이스 소유자와 관리자만 지출을 결정할 수 있습니다. 다른 사용자는 "소유자 또는 관리자가 결정합니다"라는 메시지를 보게 됩니다. 에이전트는 자신의 요청을 직접 승인할 수 없으며, 에이전트 토큰은 승인 엔드포인트를 호출할 수 없습니다.
- 요청은 24시간 후에 만료됩니다. 만료된 요청의 작업은 취소되며, 에이전트는 다시 요청해야 합니다.
- 결정되었거나 만료된 요청은 기록("결정되었거나 만료된 요청.")으로 이동하며, 결과(승인됨, 거부됨, 만료됨, 취소됨)와 결정한 사용자가 표시됩니다.
- 에이전트는 대기 중일 때 자신의 작업을
needs_input으로 보며, 결정이 내려지면 결과를 확인합니다. 웹훅을 사용하면 시스템에서approval.requested및approval.decided를 받을 수 있습니다.
소유자나 관리자가 아닌 멤버는 자신의 에이전트 요청만 볼 수 있습니다: "에이전트가 크레딧을 사용하거나 게시하기 전에 이곳에서 요청을 보내고 소유자나 관리자의 승인을 기다립니다."
기타 지출 제한
| 제한 | 결과 |
|---|---|
| 토큰당 시간당 20회, 워크스페이스당 일일 100회 유료 작업 시작 | 해당 기간이 지날 때까지 추가 시작이 rate_limited으로 거부됩니다. |
| 특정 토큰이 비정상적으로 빠르게 크레딧 소모 | 해당 토큰은 24시간 동안 유료 작업을 시작할 수 없으며, 소유자에게 "token에서 비정상적인 활동 감지": "짧은 시간 동안 비정상적으로 많은 크레딧을 사용하여 현재 유료 작업을 시작할 수 없습니다."라는 메시지가 전송됩니다. |
| 동시에 두 개의 작업 시작 확인 | "다른 작업이 확인 중입니다. 잠시 후 다시 시도하세요." |
문제 해결
| 메시지 | 원인 | 해결 방법 |
|---|---|---|
| "토큰의 지출 한도를 초과하게 됩니다. 워크스페이스 관리자가 한도를 상향할 수 있습니다." | 견적이 작업당 한도 또는 일일/월간 잔여 한도를 초과함. | 다음 날 또는 다음 달까지 기다리거나, 더 높은 한도의 토큰을 생성하세요. |
| "현재 플랜에는 유료 에이전트 작업이 포함되어 있지 않습니다. 업그레이드하여 에이전트가 작업을 시작할 수 있도록 하세요." | 워크스페이스가 Pro, Business 또는 Custom 플랜이 아님. | 업그레이드하세요. |
| "크레딧 부족" 메시지 | 워크스페이스에 견적을 처리할 크레딧이 부족함. | 크레딧 구매 또는 할당량 충전 대기. |
| "견적이 만료되었습니다. 새 견적을 요청하세요." | 견적 후 15분 경과. | 에이전트가 새 견적을 요청하도록 하세요. |
| "이미 사용된 견적입니다. 새 견적을 요청하세요." | 견적이 이미 작업 시작에 사용됨. | 에이전트가 새 견적을 요청하도록 하세요. |
| "현재 플랜은 최대 500 크레딧까지 에이전트 작업을 자동 승인합니다." | 아래에서 자동 승인 값이 플랜 최대치를 초과함. | 값을 낮추세요. |
| "API 및 에이전트 액세스가 현재 플랜에 포함되어 있지 않습니다." (승인 시) | 워크스페이스가 Pro 플랜에서 해지됨. | Pro 플랜으로 업그레이드하거나 요청을 거부하세요. |
| "이미 결정되었거나 만료된 요청입니다." | 다른 사용자가 결정했거나 24시간이 지남. | 별도 조치 필요 없음; 기록을 확인하세요. |
| "이 요청을 결정할 수 없습니다." | 현재 역할로 지출 승인 불가. | 워크스페이스 소유자나 관리자에게 문의하세요. |
| 에이전트가 대기 중이나 아무 일도 일어나지 않음 | 요청이 에이전트 요청에서 대기 중임. | 24시간 이내에 승인하거나 거부하세요. |