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

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

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

기능 및 버전 기반 할당량

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

일일 생성 할당량

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

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

버전 일일 생성 할당량 설명
일선 인력 / Starter 0 커스텀 에이전트를 만들거나 등록할 수 없습니다. Frontline 라이선스는 생성 할당량을 0으로 제공하며 프로젝트의 풀링된 생성 할당량에 기여하지 않습니다. 사용자는 자신과 공유된 에이전트만 실행할 수 있습니다.
표준 사용자당 하루 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는 턴마다 에이전트의 Knowledge 섹션에 업로드한 파일을 모델의 프롬프트 컨텍스트에 전체적으로 로드합니다. 파일을 많이 첨부하거나 밀도가 높은 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개 에이전트가 참조하는 모듈식 기술 에이전트의 최대 수입니다.

다음 단계