Conversational Analytics API에는 데이터 소스 수, 시각화 스타일, 데이터 세트 크기에 다음과 같은 알려진 제한사항이 있습니다.
데이터 소스 제한사항
Looker 데이터 소스에 연결할 때는 다음 사항에 유의하세요.
- 대화에서 포함된 Explore를 쿼리할 수 있습니다.
- 에이전트는 한 번에 Explore 하나만 쿼리할 수 있습니다. Explore 여러 개에서 동시에 쿼리를 수행할 수는 없습니다.
- 에이전트는 같은 대화에서 Explore 여러 개를 쿼리할 수 있습니다.
에이전트는 여러 부분으로 구성된 질문이 포함된 대화나 후속 질문이 포함된 대화에서 Explore 여러 개를 쿼리할 수 있습니다.
예를 들어 사용자가
cat-explore하나와dog-explore하나 등 Explore 2개를 연결합니다. 사용자가 '고양이와 개 중에 어느 것이 더 많아?'라는 질문을 입력합니다. 이렇게 하면cat-explore의 고양이 수를 세는 쿼리와dog-explore의 개 수를 세는 쿼리 등 쿼리 2개가 생성됩니다. 에이전트는 두 쿼리 모두 완료한 후 두 쿼리의 숫자를 비교합니다.
시각화 제한사항
- 다음 시각화 유형이 완전히 지원됩니다: 선 차트, 영역 차트, 막대(가로, 세로, 스택) 차트, 분산형 차트, 원형 차트.
- 다음 시각화 유형은 부분적으로 지원되며 예기치 않은 동작이 발생할 수 있습니다: 지도, 히트맵, 도움말이 제공되는 차트.
데이터 처리 제한사항
- Looker 데이터 소스의 경우 Conversational Analytics API는 쿼리당 최대 5,000개 행을 반환할 수 있습니다.
- BigQuery 데이터 소스의 경우 Conversational Analytics API는 데이터 쿼리를 처리된 바이트 500GB로 제한합니다.
- Conversational Analytics API의 Python 기반 추론 및 콘텐츠 검색 기능은 최대
O(100k)개 행의 시간 복잡성을 수용할 수 있습니다. - 대량의 데이터를 쿼리하면 데이터 에이전트의 추론 정확도가 떨어질 수 있습니다.
- Conversational Analytics API의 최대 토큰 출력 길이는 8,192개 토큰입니다. 대량의 데이터를 쿼리하면
MAX_TOKENS오류가 반환될 수 있습니다.
쿼리 제한사항
- BigQuery의 유연한 열 이름 기능은 지원되지 않습니다.
- BigQuery의 구조체는 지원되지만 때때로 실패할 수 있습니다.
- Looker 데이터 소스의 경우 API는 LookML
parameter파라미터를 사용하여 정의된 필터 전용 필드의 값을 설정할 수 없습니다. - Looker(Google Cloud 핵심 서비스) 인스턴스가 VPC 서비스 제어 경계 내에 있는 경우 Looker Studio Pro를 사용하여 비공개 IP Looker(Google Cloud 핵심 서비스) 인스턴스에 연결하기 위해 Conversational Analytics API를 사용하는 것은 지원되는 구성이 아니며 VPC 서비스 제어 규정 준수 요구사항을 충족하지 않습니다.
- 비공개 IP 구성이 있는 Looker(Google Cloud 핵심 서비스) 인스턴스에 연결하는 경우, Conversational Analytics API는 CMEK 또는 VPC 서비스 제어를 사용하도록 구성된 Looker(Google Cloud 핵심 서비스) 인스턴스를 지원하지 않습니다.
- Conversational Analytics API는 보고서 필드 수정이 사용 중지된 Looker Studio 데이터 소스에서 제대로 작동하지 않습니다. 이 설정으로 인해 대화형 분석에서 계산된 필드를 만들 수 없기 때문입니다.
쿼리 검사 또는 실행 중에 오류가 발생하면 Conversation Analytics API가 수정된 쿼리를 생성하여 작업을 자동으로 재시도할 수 있습니다. 이러한 종류의 재시도는 요청당 최대 3회 시도됩니다.
권한 또는 인증 문제로 인해 쿼리가 실패하면 Conversational Analytics API에서 쿼리를 재시도하지 않습니다. 재시도는 비결정론적으로, 오류 메시지에 쿼리를 복구할 수 없다고 표시되면 요청당 오류 한도인 3개 미만이라도 API는 쿼리를 다시 시도하지 않습니다.
질문 유형 제한사항
Conversational Analytics API는 단일 시각화로 답변할 수 있는 질문을 지원합니다. 예를 들면 다음과 같습니다.
- 시간 경과에 따른 측정항목 트렌드
- 측정기준별 측정항목 분류 또는 분포
- 하나 이상의 측정기준에 대한 고유한 값
- 단일 측정항목값
- 측정항목별 상위 측정기준값
Conversational Analytics API는 아직 다음과 같은 복잡한 시각화 유형으로만 답변할 수 있는 질문을 지원하지 않습니다.
- 예측
- 상관관계 및 이상 감지를 포함한 고급 통계 분석