会話型分析 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 は、次のタイプの複雑なビジュアリゼーションでのみ回答できる質問をまだサポートしていません。
- 予測
- 相関分析や異常検出などの高度な統計分析