Conversational Analytics API の既知の制限事項

会話型分析 API には、データソースの数、ビジュアリゼーションのスタイル、データセットのサイズに関する次の既知の制限事項があります。

データソースの制限事項

このセクションでは、BigQuery、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)からデータを返す可能性があります。

BigQuery 検索スコープの制限事項

検索スコープを使用して、会話型分析 API がクエリする BigQuery テーブルを選択できるようにすると、次の制限が適用されます。

  • 検索スコープは、インライン コンテキストを含むステートレス チャット リクエストでのみ使用できます。検索スコープは、永続データ エージェントや、会話参照を使用するステートフル チャット リクエストではサポートされていません。
  • 最大 100 個のデータセットと最大 100 個のプロジェクトを指定できます。

詳細については、BigQuery のデータセットとプロジェクトに接続するをご覧ください。

可視化の制限事項

サポートされているビジュアリゼーション タイプは次のとおりです。

  • 領域
  • バー
  • Geoshape
  • ヒートマップ
  • 折れ線(時系列)
  • Pie
  • 散布

データ処理の制限事項

  • 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 コア)インスタンスへの接続の場合、会話型分析 API は、CMEK を使用するように構成された Looker(Google Cloud コア)インスタンスまたは VPC Service Controls をサポートしていません。
  • この設定では、会話型分析で計算フィールドを作成できないため、[レポートのフィールド編集] が無効になっているデータポータルのデータソースでは、会話型分析 API は適切に機能しません。
  • クエリの検証または実行中にエラーが発生した場合、Conversational Analytics API は修正されたクエリを生成してオペレーションを自動的に再試行することがあります。この種の再試行は、リクエストごとに最大 3 回試行されます。

    権限または認証の問題が原因でクエリが失敗した場合、Conversational Analytics API はクエリを再試行しません。再試行は非決定的です。エラー メッセージでクエリが回復不能であることが示されている場合、リクエストあたりのエラー数が 3 回の制限を下回っていても、会話型分析 API はクエリを再試行しません。

割り当ての制限事項

  • 会話型分析 API には、リクエスト全体(チャット リクエストとチャット以外のリクエストの両方を含む)に対して次の上限があります。
    • 最大レートは 30 QPS(秒間クエリ数)で、プロジェクトあたり 1,800 QPM(分間クエリ数)に相当します。
    • 最大レートは 10 QPS(プロジェクトごとにユーザーごとに 600 QPM)。
  • 例外として、チャット リクエストにはより厳しい制限があります。
    • プロジェクトあたり最大 30 QPM のレート。
    • プロジェクトごとにユーザーあたり最大 30 QPM のレート。
    • 各チャット リクエストは、標準の 1 ユニットではなく、8 ユニットの割り当てとしてカウントされます。その結果、 Google Cloud コンソールの [割り当て] ページには、実際のリクエスト上限の 8 倍の上限が表示されます。たとえば、240 ユニットの上限は 30 件のチャット リクエストを表します。
  • エージェント間(A2A)リクエストの最大レートは、エージェントごとにプロジェクトあたり 100 QPM です。組み込みエージェントにはそれぞれ専用の上限が割り当てられますが、カスタム データ エージェントはプロジェクトごとに 100 QPM の単一のプールされた上限を共有します。
  • AlloyDB、Cloud SQL for MySQL、Cloud SQL for PostgreSQL、Spanner の会話型分析 API には、プロジェクトあたり 50 QPM の上限があります。これらの上限を引き上げるには、Google Cloud カスタマーケアにお問い合わせください。

質問の種類の制限

  • 会話型分析 API は、1 つのビジュアリゼーションで回答できる質問をサポートしています。例:

    • 指標の推移
    • ディメンション別の指標の内訳または分布
    • 1 つ以上のディメンションの一意の値
    • 単一の指標値
    • 指標別の上位のディメンション値
  • 会話型分析 API は、次のタイプの複雑なビジュアリゼーションでのみ回答できる質問をまだサポートしていません。

    • 予測
    • 相関分析や異常検出などの高度な統計分析