할당량 및 한도

이 문서에서는 Dialogflow 사용에 적용되는 현재 할당량과 한도에 관한 내용을 다룹니다. Google에는 제약조건을 변경할 권리가 있으며 관련 변경사항은 이 페이지에 업데이트됩니다.

할당량

할당량은 프로젝트에 적용되는 기본 제약조건입니다. 유료 버전을 사용하는 경우 할당량 상향을 요청할 수 있습니다. 할당량의 목적은 클라이언트당 서비스 부하를 제한하여 서비스가 과부하되지 않고 클라이언트에 예기치 않은 리소스 사용이 발생하지 않도록 보호하는 데 있습니다.

Dialogflow 할당량은 에이전트의 버전에 따라 다릅니다. 할당량은 각 프로젝트에 적용되며 프로젝트를 사용하는 모든 애플리케이션과 IP 주소 전반에 공유됩니다.

할당량 시간 경계 세부정보:

월별 할당량은 매월 1일 오전 12시(태평양 표준시 기준)에 보충됩니다.
일일 할당량은 매일 오전 12시(태평양 표준시 기준)에 보충됩니다. 태평양 표준시 일광 절약 시간 전환으로 하루의 길이가 늘어나면 이에 비례하여 할당량 보너스가 부여됩니다. 하지만 일광 절약 시간 전환으로 하루의 길이가 더 짧아지면 이에 상응하는 공제가 없습니다.
분당 할당량은 60분마다 새로고침됩니다.

아래에 나열된 할당량은 일반적인 할당량입니다. 모든 할당량을 검토하려면 GCP Console Dialogflow 할당량 페이지를 참조하세요.

할당량 상향 요청

필요한 경우 할당량 상향 조정을 요청할 수 있습니다.

Dialogflow 에이전트와 서비스 계정 인증에 다른 프로젝트를 사용하는 경우 소비자 프로젝트의 할당량 상향을 요청합니다. 자세한 내용은 ES에 여러 프로젝트 사용 또는 CX에 여러 프로젝트 사용을 참조하세요.

ES 에이전트의 경우 할당량 상향을 요청하기 전에 에이전트를 Dialogflow Essentials 버전으로 업그레이드해야 합니다.

할당량 표

가격 책정 및 할당량을 설명하는 데 사용되는 용어는 다음과 같습니다.

요청: 요청은 Dialogflow 서비스에 대한 API 호출(API 사용을 통한 직접 호출 또는 통합이나 콘솔 사용을 통한 간접 호출)로 정의됩니다. 에이전트의 작업과 설계에 따라 최종 사용자가 Dialogflow 에이전트로 작업을 수행하는 데 필요한 요청 수가 크게 다를 수 있습니다.
세션: 세션은 최종 사용자와 Dialogflow 에이전트 간의 대화입니다. 세션에 대한 마지막 요청을 보낸 후 30분 동안 세션이 활성 상태로 유지되고 세션 데이터가 저장됩니다. 세션은 채팅 세션과 음성 세션으로 나뉩니다. 가격과 할당량을 산정하기 위해 하나의 대화가 여러 세션으로 집계될 수 있습니다.
- 채팅 세션: 채팅 세션은 요청과 응답에 텍스트만 사용합니다. 채팅 세션에 40개가 넘는 요청이 있으면 세션당 최대 40개의 요청이 포함된 여러 개의 세션으로 집계됩니다. 예를 들어 81개의 쿼리가 있는 세션은 3개의 세션으로 집계됩니다.
- 음성 세션: 음성 세션은 요청과 응답 중 하나 이상에 오디오를 사용합니다. 음성 세션의 오디오가 10분이 넘으면 세션당 최대 10분의 오디오가 포함된 여러 개의 세션으로 집계됩니다. 예를 들어 세션의 오디오 길이가 21분이면 3개의 세션으로 집계됩니다.
소비자 프로젝트 및 리소스 프로젝트: 여러 프로젝트를 사용하는 경우 요청 인증(소비자 프로젝트)에 연결된 프로젝트가 요청의 에이전트에 연결된 프로젝트(리소스 프로젝트)와 동일하지 않을 수 있습니다. 이러한 경우에는 소비자 프로젝트를 사용해 가격과 할당량을 결정합니다. 자세한 내용은 ES에 여러 프로젝트 사용 또는 CX에 여러 프로젝트 사용을 참조하세요.

다음 표는 에이전트 유형별 버전의 할당량을 비교한 것입니다. 기능이 포함된 것으로 표시되지 않은 경우 할당량은 요청에 사용된 모든 기능에 대해 누적됩니다.

CX 에이전트

기능	CX 버전
텍스트	요청 1,200개/분
오디오 입력/출력 (음성 인식, 음성 텍스트 변환, STT, 음성 합성, 텍스트 음성 변환, TTS, 전화)	요청 600개/분
설계 시점 요청 예: 에이전트 빌드 또는 업데이트를 위한 통화 여기에는 Dialogflow 콘솔 시뮬레이터에서 보낸 텍스트 및 오디오 런타임 요청도 포함됩니다.	요청 60개/분
기타 세션 요청 예: 세션 항목 설정	요청 100개/분

ES 에이전트

기능	무료 체험 버전	Essentials 버전
텍스트	요청 180개/분	요청 600개/분
오디오 입력 (음성 인식, 음성 텍스트 변환, STT라고도 함)	요청 100개/분 † 요청 1,000개/일 † 요청 15,000개/월 † 요청당 오디오 길이 최대 60초 †	요청 300개/분 † 요청당 오디오 길이 최대 60초 †
오디오 출력 (음성 합성, 텍스트 음성 변환, TTS라고도 함)	오디오 입력과 동일	오디오 입력과 동일
지식 커넥터(베타)	총 문서 크기 최대 10MB 매월 요청 1,000개 일일 요청 100개	무제한 #
감정 분석	해당 사항 없음	무제한 #
Dialogflow Phone Gateway(베타) 오디오 입력 및 출력이 포함됩니다.	수신자 부담 전화번호: 해당 사항 없음 분당 총통화량 3분 ‡ 통화 30분/일 통화 500분/월 전화번호 30일간 저장	분당 총통화량 100분 ‡
메가 에이전트	요청 1,000개/일	무제한 #
설계 시점 요청 예: 에이전트 빌드 또는 업데이트를 위한 통화 여기에는 Dialogflow 콘솔 시뮬레이터에서 보낸 텍스트 및 오디오 런타임 요청도 포함됩니다.	요청 60개/분	요청 60개/분
기타 세션 요청 예: 세션 항목 설정 또는 컨텍스트 업데이트/쿼리	요청 100개/분	요청 100개/분
Agent Assist 대화 기타 작업 대화 및 참여자를 관리하는 모든 요청이 포함됩니다.	해당 없음	요청 300개/분
Agent Assist 분석 텍스트/오디오 작업 대화 단계의 모든 텍스트 또는 오디오 AnalyzeContent 또는 StreamingAnalyzeContent 요청이 포함됩니다.	해당 없음	요청 300개/분

기호	설명
†	StreamingDetectIntent 스트림 안에 여러 프레임의 `StreamingDetectIntentRequest` 오디오가 포함되더라도 각 스트림은 단일 요청으로 간주됩니다.
‡	'분당 총통화량'은 전화 시스템을 통해 전화를 건 모든 사용자가 사용한 분당 시간의 총합입니다. 예를 들어 60초 동안 첫 번째 사용자가 60초, 두 번째 사용자가 30초, 세 번째 사용자가 30초를 통화할 경우 분당 총통화량은 2분으로 계산됩니다. 분당 총통화량이 많을수록 더 많은 사용자가 시스템을 동시에 사용할 수 있습니다.
#	무제한으로 표시된 기능도 다른 기능의 사용으로 잠재적으로 제한될 수 있습니다. 예를 들어 사용하는 버전에서 지식 커넥터에 대한 무제한 할당량을 제공하는 경우 지식 커넥터를 사용하는 텍스트 요청은 텍스트 요청에 대한 할당량으로 제한됩니다.
¶	Google 어시스턴트 오디오 입력과 출력은 텍스트 요청으로 간주됩니다.

한도

한도는 상향 조정이 불가능한 고정된 제약조건입니다. 많은 리소스 및 필드의 서비스 구현에 적용되는 고정된 제약조건으로 개수, 기간 또는 길이 한도가 있습니다.

다음 표에는 일반적인 한도가 나와 있습니다. 기능별 문서 및 API 참조 문서에서 추가 한도에 대한 설명을 확인할 수 있습니다.

개수 한도

CX 에이전트

설명	한도
Google Cloud 프로젝트당 최대 에이전트 수	1000
에이전트당 최대 플로우 수	20
에이전트당 최대 항목 유형 수	250
에이전트당 최대 웹훅 수	100
에이전트당 최대 환경 수	20
에이전트당 최대 테스트 사례 수	1000
플로우당 최대 페이지 수	250
플로우당 최대 경로 그룹 수	100
플로우당 최대 버전 수	20
플로우당 최대 참조 인텐트 수	2,000
각 인텐트 및 언어당 최대 학습 문구 수('기본 제외 인텐트'는 예외)	2,000
흐름당 및 언어당 최대 학습 문구 수	75,000
인텐트당 최대 매개변수 수	20
항목당 최대 개체 항목 수	30,000
개체 항목당 최대 개체 동의어 수	200
각 에이전트 및 언어당 최대 항목 참조 값 및 동의어 수	1,000,000
페이지당 최대 매개변수 수	20
페이지당 최대 경로 수	2,000
페이지당 최대 이벤트 핸들러 수	100
경로 그룹당 최대 경로 수	2,000

ES 에이전트

설명	한도
리전당 및 Google Cloud 프로젝트당 최대 에이전트 수	1
최대 인텐트 수	2,000
최대 항목 유형 수	250
각 언어당 및 인텐트당 최대 학습 문구 수 *	2,000
각 언어당 및 에이전트당 최대 학습 문구 수 *	100,000
최대 개체 항목 수	30000
개체 항목당 최대 개체 동의어 수	200
각 언어당 및 에이전트당 최대 항목 참조 값과 동의어 수*	1,000,000
인텐트당 최대 매개변수 수	20
인텐트당 최대 입력 컨텍스트 수	5
인텐트당 최대 출력 컨텍스트 수	30
각 언어당 및 인텐트당 최대 텍스트 응답 수 *	30
각 언어당 및 매개변수당 최대 프롬프트 수 †	30
에이전트당 최대 환경 수	10
에이전트당 최대 버전 수	1000

¶	계정당 최대 에이전트 수는 계정에서 만들 수 있는 Google 프로젝트 수에 따라 다릅니다. 추가 프로젝트 요청 방법을 참조하세요.
*	언어 구성요소가 있는 인텐트와 관련된 모든 한도는 언어별로 검사됩니다. 예를 들어 에이전트가 영어와 프랑스어를 지원하는 경우 인텐트는 최대 2,000개의 영어 학습 문구와 2,000개의 프랑스어 학습 문구를 가질 수 있습니다.
†	예를 들어 에이전트가 영어와 프랑스어를 지원하는 경우 매개변수는 최대 30개의 영어 프롬프트와 30개의 프랑스어 프롬프트를 가질 수 있습니다.

기간 한도

CX 에이전트

설명	한도
웹훅당 최대 제한 시간	30초

ES 에이전트

설명	한도
최대 전화 통화 시간	3.5시간

길이 한도

CX 에이전트

설명	한도
학습 문구의 최대 길이	768자(영문 기준)
텍스트 응답의 최대 길이	4,000자(영문 기준)
인텐트 인식 텍스트 입력의 최대 길이	256자(영문 기준)

ES 에이전트

설명	한도
에이전트 이름의 최소 길이	1자(영문 기준)
에이전트 이름의 최대 길이	150자(영문 기준)
에이전트 설명의 최대 길이	500자(영문 기준)
인텐트 이름의 최대 길이	100자(영문 기준)
항목 유형 이름의 최대 길이	30자(영문 기준)
학습 문구의 최대 길이	768자(영문 기준)
작업 이름의 최대 길이	250자(영문 기준)
컨텍스트 이름의 최대 길이	250자(영문 기준)
항목 값의 최대 길이	512자(영문 기준)
매개변수 이름의 최대 길이	30자(영문 기준)
텍스트 응답의 최대 길이	4,000자(영문 기준)
인텐트 인식 텍스트 입력의 최대 길이 *	256자(영문 기준)
이벤트 이름의 최대 길이	150자(영문 기준)

크기 제한

CX 에이전트

설명	한도
로컬 파일 시스템에서 에이전트로 내보내기/복원할 수 있는 최대 에이전트 크기 *	~10MB

기호	설명
*	Cloud Storage 옵션을 사용하여 이 한도를 초과하는 에이전트를 내보내고 복원합니다.

ES 에이전트

설명	한도
에이전트 가져오기/복원을 위한 최대 에이전트 크기(압축되지 않은 콘텐츠)	50MB