会話型分析 API には、データソースの数、ビジュアリゼーションのスタイル、データセットのサイズに関する次の既知の制限事項があります。
データソースの制限事項
このセクションでは、Looker とデータベース ソース（AlloyDB for PostgreSQL、Cloud SQL for MySQL、Cloud SQL for PostgreSQL、Spanner）に接続してクエリを実行する際の会話型分析 API の制約と動作について説明します。
Looker データソースの制限事項
Looker データソースに接続する場合は、次の点に注意してください。
- 会話で、含まれている Explore をクエリできます。
- エージェントが一度にクエリできる Explore は 1 つのみです。複数のデータ探索にまたがって同時にクエリを実行することはできません。
- エージェントは、同じ会話で複数の探索に対してクエリを実行できます。
エージェントは、複数の部分から構成される質問を含む会話や、フォローアップの質問を含む会話で、複数の探索をクエリできます。
たとえば、ユーザーが 2 つの Explore（
cat-exploreとdog-explore）を接続します。ユーザーが「猫の数と犬の数ではどちらが多いですか？」という質問を入力します。これにより、cat-exploreの猫の数をカウントするクエリと、dog-exploreの犬の数をカウントするクエリの 2 つが作成されます。エージェントは、両方のクエリを完了した後、両方のクエリの数値を比較します。QueryDataメソッドは、BigQuery または Looker のデータソースをサポートしていません。
データベース データソースの制限事項
AlloyDB、Cloud SQL for MySQL、Cloud SQL for PostgreSQL、または Spanner のデータソースに接続する場合は、次の点を考慮してください。
データ エージェントは、データ エージェントとやり取りしているユーザーの認証情報を使用してデータにアクセスします。ユーザーが、エージェントの構成済みテーブルに対するアクセス権を持っていない共有データ エージェントにアクセスすると、データ エージェントはこれらのテーブルにアクセスできません。
データ エージェントのテーブル選択は、どのテーブルに焦点を当てるかについてエージェントに指示します。テーブルの選択はセキュリティ設定ではありません。データソースが特定のテーブル（
table1やtable2など）からのみ情報を取得するように指定した場合でも、クエリを実行するユーザーが同じデータベース内のtable3のコンテンツを表示する一般的な権限を持っていると、システムが意図しないテーブル（table3）からデータを返すことがあります。
可視化の制限事項
次のビジュアリゼーション タイプがサポートされています。
- 地域
- バー
- Geoshape
- ヒートマップ
- 折れ線（時系列）
- 円
- 散布
データ処理の制限事項
- Looker データソースの場合、Conversational Analytics API はクエリごとに最大 5,000 行を返すことができます。
- BigQuery データソースの場合、Conversational Analytics API はデータクエリを処理されたバイト数 500 GB に制限します。
- AlloyDB、Cloud SQL for MySQL、Cloud SQL for PostgreSQL、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 Service Controls 境界内にある場合に、データポータル Pro を使用してプライベート IP Looker（Google Cloud コア）インスタンスに接続するために会話型分析 API を使用することは、サポートされている構成ではなく、VPC Service Controls のコンプライアンス要件を満たしていません。
- プライベート IP 構成の Looker（Google Cloud コア）インスタンスへの接続の場合、Conversational Analytics API は、CMEK または VPC Service Controls を使用するように構成された Looker（Google Cloud コア）インスタンスをサポートしていません。
- 会話型分析 API リソースの場合、CMEK は Looker データソースでのみサポートされます。
- この設定では、会話型分析で計算フィールドを作成できないため、[レポートのフィールド編集] が無効になっているデータポータル データソースでは、会話型分析 API は適切に機能しません。
クエリの検証または実行中にエラーが発生した場合、Conversation Analytics API は修正されたクエリを生成してオペレーションを自動的に再試行することがあります。この種の再試行は、リクエストごとに最大 3 回試行されます。
権限または認証の問題が原因でクエリが失敗した場合、Conversational Analytics API はクエリを再試行しません。再試行は非決定的です。エラー メッセージでクエリが回復不能であることが示されている場合、リクエストあたりのエラー数が 3 回の制限を下回っていても、API はクエリを再試行しません。
割り当ての制限事項
- 会話型分析 API の全体的なリクエスト（チャット リクエストとチャット以外のリクエストの両方を含む）には、次の上限があります。
- 最大レートは 1 秒あたり 10 秒間クエリ数（QPS）、つまりプロジェクトごとに 1 分あたり 600 件のクエリ（QPM）です。
- 最大レートは 10 QPS（プロジェクトごとにユーザーごとに 600 QPM）。
- 例外として、チャット リクエストにはより厳しい制限があります。
- 最大レートは 1 QPS（プロジェクトごとに 60 QPM）です。
- 最大レートは 1 QPS（プロジェクトごとにユーザーごとに 60 QPM）です。
- AlloyDB、Cloud SQL for MySQL、Cloud SQL for PostgreSQL、Spanner の会話型分析 API には、プロジェクトあたり 50 QPM の上限があります。これらの上限を引き上げるには、Google Cloud カスタマーケアにお問い合わせください。
質問の種類の制限
Conversational Analytics API は、1 つの可視化で回答できる質問をサポートしています。例:
- 指標の推移
- ディメンション別の指標の内訳または分布
- 1 つ以上のディメンションの一意の値
- 単一の指標値
- 指標別の上位のディメンション値
会話型分析 API は、次のタイプの複雑なビジュアリゼーションでのみ回答できる質問をまだサポートしていません。
- 予測
- 相関分析や異常検出などの高度な統計分析