워크플로 빌더의 할당량 및 한도

할당량은 일일 에이전트 생성 또는 쿼리와 같이 사용할 수 있는 리소스 양에 대해 구성 가능하거나 할당된 한도입니다. 사용자 기반 구독의 경우 조직에서 구매하는 라이선스 수에 따라 할당량이 자동으로 조정됩니다. 한도는 하위 에이전트 깊이, 파일 업로드 크기, 에이전트를 공유할 수 있는 개인 수와 같은 시스템 제약조건 또는 용량 기준점입니다. 시스템 한도는 조정 가능한 관리 설정으로 명시적으로 표시되지 않는 한 고정된 제약조건입니다.

전반적인 Gemini Enterprise 할당량, 버전 간 풀링, 할당량 초과 시 사용한 만큼만 지불하는 사용량 가격 책정에 대한 자세한 내용은 할당량 및 사용한 만큼만 지불하는 사용량을 참조하세요.

기능 및 버전 기반 할당량

Workflow Builder에서 에이전트를 만들고 실행하는 것은 Gemini Enterprise 버전에 따라 다릅니다.

일일 생성 할당량

에이전트를 만들고, 초안을 작성하고, 등록하면 버전별로 할당된 일일 생성 할당량(discoveryengine.googleapis.com/agents_tier_enterprise_regional)이 소모됩니다. 일일 생성 할당량은 특정 프로젝트 및 위치 내에서 해당 버전의 라이선스를 보유한 모든 사용자가 공유하며, 매일 태평양 표준시(PT) 자정에 재설정됩니다.

이 일일 생성 할당량은 다음 두 가지 모두에 적용됩니다.

버전 일일 생성 할당량 설명
Frontline Worker / Starter 0 커스텀 에이전트를 만들거나 등록할 수 없습니다. Frontline 라이선스는 생성 할당량을 제공하지 않으며 프로젝트의 풀링된 생성 할당량에 기여하지 않습니다. 사용자는 자신과 공유된 에이전트만 실행할 수 있습니다.
표준 사용자당 하루 1개의 에이전트 (공용) 프로젝트 및 위치의 모든 Standard 버전 라이선스 사용 좌석에 풀링됩니다. 예를 들어 라이선스 100개는 프로젝트에 하루 100개의 생성 및 등록 작업을 제공합니다.
Plus 사용자당 일일 에이전트 10개 (공용) 프로젝트 및 위치의 모든 Plus 버전 라이선스 사용 좌석에 풀링됩니다. 예를 들어 라이선스 100개는 프로젝트에 하루 1,000개의 생성 및 등록 작업을 제공합니다.
사용한 만큼만 지불 무제한 일일 생성 한도가 없습니다. 사용량은 기본 리소스 소비량과 쿼리 볼륨에 따라 청구됩니다.

여러 버전에서 할당량 초과 시 사용한 만큼만 지불하는 사용량에 대해 할당량이 풀링, 계산, 청구되는 방식에 대한 자세한 내용은 할당량 및 사용한 만큼만 지불 사용량을 참조하세요.

에이전트 용량 한도

다음 한도는 애플리케이션 인스턴스에 존재할 수 있는 활성 에이전트 수를 제어합니다.

리소스 기본 한도 범위 설명
사용자당 에이전트 수 1,000 사용자 계정별 단일 사용자가 만들고 소유할 수 있는 최대 에이전트 수입니다.
애플리케이션 인스턴스당 에이전트 10,000 애플리케이션 인스턴스별 애플리케이션 인스턴스 내의 모든 사용자가 만들 수 있는 최대 에이전트 수입니다.

공유 한도

조직의 동료와 에이전트를 공유할 때는 다음 제한사항이 적용됩니다.

설정 한도 설명
에이전트당 최대 개인 멤버십 수 개인 계정 1,500개 에이전트의 액세스 목록에 직접 추가할 수 있는 개별 사용자 계정의 최대 수입니다. Google Cloud IAM 허용 정책에 의해 시행됩니다.
Google 그룹스 지원 총 회원 수 무제한 (그룹 1개 = 정책 회원 1명) Google 그룹과 공유하면 정책 한도인 1,500명의 구성원 중 한 명으로 간주됩니다.

공유 한도 오류 동작

1,500개가 넘는 개별 사용자 계정과 에이전트를 공유하려고 하면 작업이 실패하고 다음 오류가 반환됩니다.

The number of members in the policy (1,501) is larger than the maximum allowed size 1,500.

대규모 공유 권장사항

1,500명의 IAM 구성원 한도에 도달하지 않고 대규모 대상 (예: 팀 전체, 부서 전체 또는 조직 전체 배포)과 에이전트를 공유하려면 다음 안내를 따르세요.

  1. 앱 관리자에게 기능 제어에서 그룹 공유를 사용 설정하도록 요청합니다.
  2. 에이전트 공유 대화상자에서 개별 사용자 계정이 아닌 Google 그룹스 또는 Workspace 그룹의 이메일 주소 (예: support-team@example.com)를 입력합니다.
  3. Google 그룹 내에서 잠재고객 구성원을 동적으로 관리합니다. 모든 그룹 구성원은 에이전트의 IAM 정책을 수정하지 않고도 액세스 권한을 자동으로 상속합니다.

단계별 공유 안내 및 권한 수준은 채팅 에이전트 공유 및 워크플로 공유를 참조하세요.

흐름 빌더 복잡성 한도

흐름 빌더 캔버스는 구조적 및 라우팅 제약 조건을 적용하여 실행 지연 시간을 낮게 유지하고, 결정론적 조정을 보장하며, 순환 호출 그래프를 방지합니다.

제약조건 한도 설명
하위 에이전트 깊이 1가지 단계 단일 수준 흐름 깊이만 지원됩니다. 하위 에이전트는 추가 하위 에이전트를 호출할 수 없습니다. 중첩된 다중 수준 계층 구조는 지원되지 않습니다.
채팅 루트로 라우팅되는 하위 에이전트 하위 에이전트 50개 단일 채팅 루트 에이전트가 평가하고 요청을 라우팅할 수 있는 최대 하위 에이전트 수입니다.
흐름당 노드 노드 100개 단일 워크플로에서 허용되는 최대 노드 수 (트리거, 조건, 작업, 하위 에이전트, 휴먼인더루프 노드 포함)입니다.
노드당 기술 스킬 20개 단일 흐름 노드에 연결할 수 있는 도구 기술 또는 작업의 최대 개수입니다.
동시 하위 에이전트 실행 한 번에 하위 에이전트 1개 워크플로 실행은 하위 에이전트를 순차적으로 평가하고 실행합니다. 여러 하위 에이전트 간의 동시 브랜치 실행은 지원되지 않습니다.

기술 자료 및 파일 업로드 한도

에이전트의 기술 자료에 직접 업로드된 문서에는 다음 한도가 적용됩니다.

리소스 한도 설명
최대 파일 크기 파일당 20MB 에이전트의 기술 자료에 직접 업로드되는 개별 파일의 최대 크기입니다.
에이전트당 최대 파일 수 파일 100개 단일 에이전트에 연결할 수 있는 최대 총 파일 수입니다.
업로드 배치당 최대 파일 수 파일 10개 단일 작업에서 선택하고 업로드할 수 있는 최대 파일 수입니다.
최대 결합 컨텍스트 토큰 토큰 800,000개 에이전트에 연결된 모든 정적 지식 파일, 채팅 세션 내에서 직접 업로드된 파일, 대화 기록의 최대 총 토큰 수입니다. 이 토큰 한도를 초과하면 개별 파일이 20MB 크기 한도 미만인 경우에도 FILE_SIZE_TOO_LARGE 또는 Input too long 오류가 반환됩니다.
지원되는 문서 유형 PDF, DOCX, TXT, PPTX, CSV, XLSX, HTML, 마크다운 (.md)

대용량 문서 및 여러 시트가 있는 스프레드시트 권장사항

에이전트에서 지식 소스를 구성하거나 복잡한 파일을 분석할 때는 컨텍스트 토큰 한도 및 처리 시간 초과를 방지하기 위해 다음 가이드라인을 따르세요.

  • 대규모 정적 문서 라이브러리에 연결된 데이터 스토어 (RAG) 사용: Gemini Enterprise는 에이전트의 지식 섹션에 업로드한 파일을 매번 모델의 프롬프트 컨텍스트에 완전히 로드합니다. 많은 파일이나 밀도가 높은 PDF (예: 100페이지가 넘는 설명서)를 첨부하면 결합된 토큰 수가 800,000 토큰 컨텍스트 한도를 초과하거나 생성 제한 시간이 초과될 수 있습니다. 대신 대규모 정적 참조 라이브러리를 연결된 Gemini Enterprise 데이터 스토어에 수집하여 문서를 자동으로 청크하고 색인을 생성하고, 소규모 세션별 파일에 직접 파일 업로드를 예약하세요.
  • 직접 업로드를 위해 밀도가 높은 PDF 분할: Gemini Enterprise는 PDF의 각 페이지를 텍스트 및 시각적 레이아웃과 함께 토큰화하므로 수백 페이지에 달하는 단일 PDF가 세션 토큰 예산의 상당 부분을 소비하고 추론 지연 시간을 늘릴 수 있습니다. PDF를 에이전트 또는 채팅 세션에 직접 업로드할 때는 큰 문서를 주제별로 작은 파일로 분할하세요.
  • 여러 시트가 있는 Excel (.xlsx) 통합 문서: 여러 시트가 있는 .xlsx 통합 문서를 에이전트의 지식 섹션이나 채팅 세션에 업로드하면 Gemini Enterprise가 각 워크시트를 Python 코드 실행을 위한 개별 CSV 테이블로 자동 변환하므로 에이전트가 통합 문서의 모든 시트에서 데이터를 쿼리, 조인, 분석할 수 있습니다.

스토리지 용량

업로드된 파일과 색인이 생성된 문서는 조직의 스토리지 용량 풀에서 스토리지를 사용합니다. 저장용량은 버전에 관계없이 프로젝트 및 위치의 모든 사용자가 공용으로 사용합니다.

  • 일선 인력/Starter: 사용자당 2GiB
  • Standard: 사용자당 30GiB
  • Plus: 사용자당 75GiB

총 저장된 콘텐츠가 라이선스가 부여된 사용자의 결합된 풀을 초과하는 경우 Google은 할당량을 초과하는 사용량에 대해 월별 GiB당 $5의 사용한 만큼만 지불 요금을 청구합니다. 자세한 내용은 기능 및 버전 기반 할당량을 참조하세요.

실행 일정 한도

자동 에이전트 일정에는 다음 한도 및 운영 제약조건이 적용됩니다.

설정 한도 또는 제약조건 설명
위치 지원 멀티 리전만 해당 에이전트 실행 일정은 멀티 리전 배포 (예: us 또는 eu)에서만 지원됩니다.
반복 빈도 매시간, 매일, 매주, 매월, 매년 자동 실행 트리거의 구성 가능한 간격
사용자 인증 정보 유효 기간 14일 예약된 에이전트는 작성자의 위임된 사용자 인증 정보를 사용하여 실행됩니다. 사용자 인증 정보는 14일마다 만료되며, 일정이 일시중지되지 않도록 Gemini Enterprise에서 수동으로 새로고침해야 합니다.
실행 타이밍 지연 시간 최대 5분 지연 예약된 실행은 시스템 큐 부하에 따라 최대 5분의 예약 지연이 발생할 수 있습니다.
승인 일시중지 (HITL) 외부 작업 필수 일시중지 다른 사용자에게 영향을 미치는 작업 (예: 이메일 전송 또는 회의 예약)을 수행하는 예약된 실행은 검토를 위해 자동으로 일시중지되며 채팅 기록에서 사용자의 승인이 필요합니다.

일정을 구성하거나 새로고침하는 방법은 채팅 에이전트 실행 예약을 참조하세요.

연결된 데이터 소스 및 통합 한도

연결된 데이터 스토어 및 서드 파티 통합에는 다음 한도가 적용됩니다.

리소스 기본 한도 설명
애플리케이션당 데이터 스토어 데이터 스토어 100개 애플리케이션 인스턴스당 연결된 엔터프라이즈 데이터 스토어의 최대 개수입니다. 할당량 상향 요청을 제출하여 최대 500개까지 늘릴 수 있습니다.
에이전트당 커넥터 커넥터 100개 단일 에이전트에 연결된 서드 파티 데이터 커넥터의 최대 개수입니다.
에이전트당 MCP 서버 서버 100개 에이전트에 연결된 모델 컨텍스트 프로토콜 (MCP) 서버의 최대 개수입니다.
에이전트당 스킬 에이전트 기술 100개 에이전트가 참조하는 모듈식 기술 에이전트의 최대 수입니다.

다음 단계