Conversational Analytics API의 알려진 제한사항

Conversational Analytics API에는 데이터 소스 수, 시각화 스타일, 데이터 세트 크기에 다음과 같은 알려진 제한사항이 있습니다.

데이터 소스 제한사항

이 섹션에서는 Looker 및 데이터베이스 소스(PostgreSQL용 AlloyDB, MySQL용 Cloud SQL, PostgreSQL용 Cloud SQL, Spanner)에 연결하고 쿼리할 때의 대화형 분석 API의 제약 조건과 동작을 설명합니다.

Looker 데이터 소스 제한사항

Looker 데이터 소스에 연결할 때는 다음 사항에 유의하세요.

대화에서 포함된 Explore를 쿼리할 수 있습니다.
에이전트는 한 번에 Explore 하나만 쿼리할 수 있습니다. Explore 여러 개에서 동시에 쿼리를 수행할 수는 없습니다.
에이전트는 같은 대화에서 Explore 여러 개를 쿼리할 수 있습니다.
에이전트는 여러 부분으로 구성된 질문이 포함된 대화나 후속 질문이 포함된 대화에서 Explore 여러 개를 쿼리할 수 있습니다.

예를 들어 사용자가 cat-explore 하나와 dog-explore 하나 등 Explore 2개를 연결합니다. 사용자가 '고양이와 개 중에 어느 것이 더 많아?'라는 질문을 입력합니다. 이렇게 하면 cat-explore의 고양이 수를 세는 쿼리와 dog-explore의 개 수를 세는 쿼리 등 쿼리 2개가 생성됩니다. 에이전트는 두 쿼리 모두 완료한 후 두 쿼리의 숫자를 비교합니다.
QueryData 메서드는 BigQuery 또는 Looker 데이터 소스를 지원하지 않습니다.

데이터베이스 데이터 소스 제한사항

AlloyDB, MySQL용 Cloud SQL, PostgreSQL용 Cloud SQL 또는 Spanner 데이터 소스에 연결할 때는 다음 사항을 고려하세요.

데이터 에이전트는 데이터 에이전트와 상호작용하는 사용자의 사용자 인증 정보를 사용하여 데이터에 액세스합니다. 사용자가 에이전트의 구성된 테이블에 대한 액세스 권한이 없는 공유 데이터 에이전트에 액세스하면 데이터 에이전트가 해당 테이블에 액세스할 수 없습니다.
데이터 에이전트의 테이블 선택은 에이전트가 집중해야 할 테이블을 안내합니다. 표 선택은 보안 설정이 아닙니다. 데이터 소스가 table1 및 table2과 같은 특정 테이블에서만 정보를 가져올 수 있다고 지정하더라도 쿼리를 실행하는 사용자에게 동일한 데이터베이스에서 table3의 콘텐츠를 볼 수 있는 일반 권한이 있는 경우 시스템에서 의도하지 않은 테이블 (table3)의 데이터를 반환할 수 있습니다.

시각화 제한사항

지원되는 시각화 유형은 다음과 같습니다.

영역
막대
지오셰이프
히트맵
선 (시계열)
원형
분산형

데이터 처리 제한사항

Looker 데이터 소스의 경우 Conversational Analytics API는 쿼리당 최대 5,000개 행을 반환할 수 있습니다.
BigQuery 데이터 소스의 경우 Conversational Analytics API는 데이터 쿼리를 처리된 바이트 500GB로 제한합니다.
AlloyDB, MySQL용 Cloud SQL, PostgreSQL용 Cloud SQL, Spanner 데이터 소스의 경우 대화형 분석 API는 쿼리당 최대 1,000개 행을 반환할 수 있습니다.
Conversational Analytics API의 Python 기반 추론 및 콘텐츠 검색 기능은 최대 O(100k)개 행의 시간 복잡성을 수용할 수 있습니다.
대량의 데이터를 쿼리하면 데이터 에이전트의 추론 정확도가 떨어질 수 있습니다.
Conversational Analytics API의 최대 토큰 출력 길이는 8,192개 토큰입니다. 대량의 데이터를 쿼리하면 MAX_TOKENS 오류가 반환될 수 있습니다.
시스템 메시지의 DataResult 필드 내에 반환되는 데이터에는 크기 제한이 적용됩니다. 데이터 결과는 최대 3,000,000바이트로 잘립니다. 이 자르기 프로세스는 이 크기 제약 조건 내에서 최대한 많은 전체 행을 유지합니다.

쿼리 제한사항

BigQuery의 유연한 열 이름 기능은 지원되지 않습니다.
BigQuery의 구조체는 지원되지만 때때로 실패할 수 있습니다.
Looker 데이터 소스의 경우 API는 LookML parameter 파라미터를 사용하여 정의된 필터 전용 필드의 값을 설정할 수 없습니다.
Looker (Google Cloud 핵심 서비스) 인스턴스가 VPC 서비스 제어 경계 내에 있는 경우 대화형 분석 API를 사용하여 데이터 스튜디오 Pro를 통해 비공개 IP Looker (Google Cloud 핵심 서비스) 인스턴스에 연결하는 것은 지원되는 구성이 아니며 VPC 서비스 제어 규정 준수 요구사항을 충족하지 않습니다.
비공개 IP 구성이 있는 Looker(Google Cloud 핵심 서비스) 인스턴스에 연결하는 경우, Conversational Analytics API는 CMEK 또는 VPC 서비스 제어를 사용하도록 구성된 Looker(Google Cloud 핵심 서비스) 인스턴스를 지원하지 않습니다.
대화형 분석 API 리소스의 경우 Looker 데이터 소스에만 CMEK가 지원됩니다.
Conversational Analytics API는 보고서 필드 수정이 사용 중지된 데이터 스튜디오 데이터 소스에서 제대로 작동하지 않습니다. 이 설정으로 인해 대화형 분석에서 계산된 필드를 만들 수 없기 때문입니다.
쿼리 검사 또는 실행 중에 오류가 발생하면 Conversation Analytics API가 수정된 쿼리를 생성하여 작업을 자동으로 재시도할 수 있습니다. 이러한 종류의 재시도는 요청당 최대 3회 시도됩니다.

권한 또는 인증 문제로 인해 쿼리가 실패하면 Conversational Analytics API에서 쿼리를 재시도하지 않습니다. 재시도는 비결정론적으로, 오류 메시지에 쿼리를 복구할 수 없다고 표시되면 요청당 오류 한도인 3개 미만이라도 API는 쿼리를 다시 시도하지 않습니다.

할당량 제한사항

대화형 분석 API에는 채팅 요청과 비채팅 요청을 모두 포함한 전체 요청에 다음과 같은 제한이 있습니다.
- 최대 초당 쿼리 수 10개 (QPS), 즉 프로젝트당 분당 600개의 쿼리 (QPM)
- 최대 속도는 10QPS이며, 이는 사용자당 프로젝트당 600QPM입니다.
예외적으로 채팅 요청에는 더 엄격한 제한이 적용됩니다.
- 최대 QPS는 1QPS이며, 이는 프로젝트당 60QPM입니다.
- 최대 QPS는 1이며, 이는 사용자당 프로젝트당 60QPM입니다.
AlloyDB, MySQL용 Cloud SQL, PostgreSQL용 Cloud SQL, Spanner의 대화형 분석 API에는 프로젝트당 50QPM 한도가 있습니다. 이 한도를 늘리려면 Google Cloud 고객 관리에 문의하세요.

질문 유형 제한사항

Conversational Analytics API는 단일 시각화로 답변할 수 있는 질문을 지원합니다. 예를 들면 다음과 같습니다.
- 시간 경과에 따른 측정항목 트렌드
- 측정기준별 측정항목 분류 또는 분포
- 하나 이상의 측정기준에 대한 고유한 값
- 단일 측정항목값
- 측정항목별 상위 측정기준값
Conversational Analytics API는 아직 다음과 같은 복잡한 시각화 유형으로만 답변할 수 있는 질문을 지원하지 않습니다.
- 예측
- 상관관계 및 이상 감지를 포함한 고급 통계 분석