할당량 및 한도

이 문서에서는 Dialogflow 사용과 관련하여 일반적으로 발생하는 할당량과 한도를 설명합니다. 할당량 및 한도의 전체 목록을 찾는 방법은 아래에 나와 있습니다. Google에는 이러한 제약조건을 변경할 권리가 있으며 관련 변경사항은 이 페이지에 업데이트됩니다.

할당량

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

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

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

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

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

할당량 상향 요청

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

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

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

할당량 표

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

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

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

CX 에이전트

기능	CX 버전
텍스트 (오디오를 포함하지 않는 모든 DetectIntent, StreamingDetectIntent, FulfillIntent 요청 포함)	요청 1,200개/분
오디오 입력/출력 (음성 인식, 음성 텍스트 변환, STT, 음성 합성, 텍스트 음성 변환, TTS, 전화)	요청 600개/분
Dialogflow phone gateway(미리보기) 오디오 입력 및 출력이 포함됩니다.	분당 총통화량 100분 ‡
설계 시점 쓰기 요청 예: 에이전트 빌드 또는 업데이트를 위한 호출	요청 60개/분
설계 시점 읽기 요청 예: 에이전트 리소스 나열 또는 가져오기 호출	요청 200개/분
기타 세션 요청 예: 세션 항목 설정 또는 가져오기	요청 100개/분

기호	설명
‡	'분당 총통화량'은 전화 시스템을 통해 전화를 건 모든 사용자가 사용한 분당 시간의 총합입니다. 예를 들어 60초 동안 첫 번째 사용자가 60초, 두 번째 사용자가 30초, 세 번째 사용자가 30초를 통화할 경우 분당 총통화량은 2분으로 계산됩니다. 분당 총통화량이 많을수록 더 많은 사용자가 시스템을 동시에 사용할 수 있습니다.

ES 에이전트

기능	무료 체험 버전	Essentials 버전
텍스트 (오디오를 포함하지 않는 모든 DetectIntent 및 StreamingDetectIntent 요청 포함)	요청 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개/일	무제한 #
설계 시점 쓰기 요청 예: 에이전트 빌드 또는 업데이트를 위한 호출	요청 60개/분	요청 60개/분
설계 시점 읽기 요청 예: 에이전트 리소스 나열 또는 가져오기 호출	요청 60개/분	요청 60개/분
기타 세션 요청 예: 세션 항목 설정/가져오기 또는 컨텍스트 업데이트/쿼리	요청 100개/분	요청 100개/분

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

Agent Assist

Agent Assist를 사용하는 경우 CX Agent 및 ES Agent 탭에 나열된 할당량도 사용 중인 에이전트 유형에 따라 적용됩니다.

기능	무료 체험 버전	Essentials 버전
Agent Assist 대화 기타 작업 대화 및 참여자를 관리하는 모든 요청이 포함됩니다.	해당 사항 없음	요청 300개/분
Agent Assist 분석 텍스트/오디오 작업 대화 단계의 모든 AnalyzeContent 또는 StreamingAnalyzeContent 요청이 포함됩니다. 여기에는 텍스트, 음성 합성 및/또는 음성 인식과 관련된 모든 요청이 포함됩니다.	해당 사항 없음	요청 300개/분
Agent Assist 대화 요약 제안 폴링 요청 대화 요약을 가져오기 위한 모든 요청을 포함합니다.	사용 불가	요청 300개/분

한도

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

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

개수 한도

CX 에이전트

설명	한도
Google Cloud 프로젝트당 최대 에이전트 수	1000
에이전트당 최대 플로우 수	50
에이전트당 최대 항목 유형 수	250
에이전트당 최대 웹훅 수	100
에이전트당 최대 환경 수	20
에이전트당 최대 테스트 사례 수	2000
에이전트당 최대 변경 로그 수	20,000
플로우당 최대 페이지 수	250
플로우당 최대 경로 그룹 수	100
플로우당 최대 버전 수	20
에이전트당 최대 인텐트 수	10,000
플로우당 최대 참조 인텐트 수	2,000
각 인텐트 및 언어당 최대 학습 문구 수('기본 제외 인텐트'는 예외)	2,000
흐름당 및 언어당 최대 학습 문구 수	100,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

Agent Assist

Agent Assist를 사용하는 경우 CX Agent 및 ES Agent 탭에 나열된 한도도 사용 중인 에이전트 유형에 따라 적용됩니다.

설명	한도
모델 학습에 필요한 최소 대화 수	30,000
프로젝트당 동시 학습된 최대 모델 수	1
월별 최대 학습 노드 GPU 시간	4200

기간 한도

CX 에이전트

설명	한도
웹훅당 최대 제한 시간	30초
최대 오디오 입력 지속 시간	120초

ES 에이전트

설명	한도
최대 웹훅 제한 시간	5초
최대 전화 통화 시간	3.5시간

길이 한도

CX 에이전트

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

ES 에이전트

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

크기 제한

CX 에이전트

설명	한도
로컬 파일 시스템에서 에이전트 내보내기/복원의 최대 에이전트 크기*	~10MB
최대 음성 합성 요청 크기	TTS API 콘텐츠 한도 참조

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

ES 에이전트

설명	한도
에이전트 가져오기/복원을 위한 최대 에이전트 크기(압축되지 않은 콘텐츠)	50MB
최대 음성 합성 요청 크기	TTS API 콘텐츠 한도 참조