Conversational Analytics API의 알려진 제한사항

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

데이터 소스 제한사항

이 섹션에서는 BigQuery, 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)의 데이터를 반환할 수 있습니다.

BigQuery 검색 범위 제한사항

검색 범위를 사용하여 대화형 분석 API가 쿼리할 BigQuery 테이블을 선택하도록 하면 다음 제한사항이 적용됩니다.

  • 인라인 컨텍스트가 있는 스테이트리스(Stateless) 채팅 요청에서만 검색 범위를 사용할 수 있습니다. 검색 범위는 영구 데이터 에이전트 또는 대화 참조를 사용하는 스테이트풀(Stateful) 채팅 요청에서 지원되지 않습니다.
  • 데이터 세트는 최대 100개, 프로젝트는 최대 100개까지 지정할 수 있습니다.

자세한 내용은 BigQuery 데이터 세트 및 프로젝트에 연결을 참조하세요.

시각화 제한사항

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

  • 영역
  • 막대
  • Geoshape
  • 히트맵
  • 선(시계열)
  • 원형
  • 분산형

데이터 처리 제한사항

  • 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 핵심 서비스) 인스턴스에 연결하는 경우, 대화형 분석 API는 CMEK를 사용하도록 구성되거나 VPC 서비스 제어를 사용하도록 구성된 Looker(Google Cloud 핵심 서비스) 인스턴스를 지원하지 않습니다.
  • Conversational Analytics API는 보고서 필드 수정이 사용 중지된 데이터 스튜디오 데이터 소스에서 제대로 작동하지 않습니다. 이 설정으로 인해 대화형 분석에서 계산된 필드를 만들 수 없기 때문입니다.
  • 쿼리 검사 또는 실행 중에 오류가 발생하면 대화형 분석 API가 수정된 쿼리를 생성하여 작업을 자동으로 재시도할 수 있습니다. 이러한 종류의 재시도는 요청당 최대 3회 시도됩니다.

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

할당량 제한사항

  • 대화형 분석 API에는 전체 요청(채팅 및 비채팅 요청 모두 포함)에 대해 다음과 같은 제한이 있습니다.
    • 프로젝트당 최대 초당 쿼리 수(QPS) 30개, 즉 분당 쿼리 수(QPM) 1,800개입니다.
    • 최대 속도는 10QPS이며, 이는 사용자당 프로젝트당 600QPM입니다.
  • 예외적으로 채팅 요청에는 더 제한적인 한도가 적용됩니다.
    • 프로젝트당 최대 30QPM입니다.
    • 사용자별 프로젝트당 최대 30QPM입니다.
    • 각 채팅 요청은 표준 1단위가 아닌 8할당량 단위로 계산됩니다. 따라서 Google Cloud 콘솔 할당량 페이지에는 실제 요청 한도의 8배인 한도가 표시됩니다. 예를 들어 한도가 240단위이면 채팅 요청 30개를 나타냅니다.
  • 에이전트 간(A2A) 요청의 최대 속도는 에이전트당 프로젝트당 100QPM입니다. 기본 제공 에이전트는 각각 전용 한도를 받지만 커스텀 데이터 에이전트는 프로젝트당 단일 풀링된 100QPM 한도를 공유합니다.
  • AlloyDB, MySQL용 Cloud SQL, PostgreSQL용 Cloud SQL, Spanner용 대화형 분석 API의 QPM 한도는 프로젝트당 50개입니다. 이 한도를 늘리려면 Google Cloud 고객 지원에 문의하세요.

질문 유형 제한사항

  • 대화형 분석 API는 단일 시각화로 답변할 수 있는 질문을 지원합니다. 예를 들면 다음과 같습니다.

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

    • 예측
    • 상관관계 및 이상 감지를 포함한 고급 통계 분석