Conversational Analytics API の既知の制限事項

会話分析 API には、データソースの数、可視化のスタイル、データセットのサイズに関する次の既知の制限事項があります。

データソースの制限事項

Looker データソースに接続する場合は、次の点に注意してください。

  • 会話で、含まれている Explore をクエリできます。
  • エージェントが一度にクエリできる Explore は 1 つのみです。複数のデータ探索にまたがって同時にクエリを実行することはできません。
  • エージェントは、同じ会話で複数の探索に対してクエリを実行できます。

  • エージェントは、複数の部分を含む質問を含む会話や、フォローアップの質問を含む会話で、複数の探索をクエリできます。

    たとえば、ユーザーが 2 つの Explore（cat-explore と dog-explore）を接続します。ユーザーが「猫の数と犬の数ではどちらが多いですか？」という質問を入力します。これにより、cat-explore の猫の数をカウントするクエリと、dog-explore の犬の数をカウントするクエリの 2 つが作成されます。エージェントは、両方のクエリを完了した後、両方のクエリの数値を比較します。

可視化の制限事項

  • 次のビジュアリゼーション タイプは完全にサポートされています。折れ線グラフ、面グラフ、棒グラフ（横、縦、積み上げ）、散布図、円グラフ
  • これらのビジュアリゼーション タイプは部分的にサポートされており、予期しない動作が発生する可能性があります。マップ、ヒートマップ、ツールチップ付きのグラフ

データ処理の制限事項

  • Looker データソースの場合、会話分析 API はクエリごとに最大 5,000 行を返すことができます。
  • BigQuery データソースの場合、会話分析 API はデータクエリを処理されたバイト数 500 GB に制限します。
  • Conversational Analytics API の Python ベースの推論機能とコンテンツ取得機能は、最大 O(100k) 行の時間複雑性に対応できます。
  • 大量のデータをクエリすると、データ エージェントの推論精度が低下する可能性があります。
  • Conversational Analytics API の最大トークン出力長は 8,192 トークンです。大量のデータをクエリすると、MAX_TOKENS エラーが返されることがあります。

クエリの制限事項

  • BigQuery の柔軟な列名機能はサポートされていません。
  • BigQuery の構造体はサポートされていますが、失敗することがあります。
  • Looker データソースの場合、API は LookML の parameter パラメータを使用して定義されたフィルタ限定のフィールドの値を設定できません。
  • Looker（Google Cloud コア）インスタンスが VPC Service Controls 境界内にある場合に、Looker Studio Pro を使用してプライベート IP Looker（Google Cloud コア）インスタンスに接続するために Conversational Analytics API を使用することは、サポートされている構成ではなく、VPC Service Controls のコンプライアンス要件を満たしていません。
  • プライベート IP 構成の Looker（Google Cloud コア）インスタンスへの接続の場合、Conversational Analytics API は、CMEK または VPC Service Controls を使用するように構成された Looker（Google Cloud コア）インスタンスをサポートしていません。
  • [レポートのフィールド編集] が無効になっている Looker Studio のデータソースでは、会話分析 API が適切に機能しません。この設定では、会話分析で計算フィールドを作成できないためです。

  • クエリの検証または実行中にエラーが発生した場合、Conversation Analytics API は修正されたクエリを生成してオペレーションを自動的に再試行することがあります。この種の再試行は、リクエストごとに最大 3 回試行されます。

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

質問の種類の制限

  • 会話分析 API は、1 つの可視化で回答できる質問をサポートしています。例:

    • 指標の推移
    • ディメンション別の指標の内訳または分布
    • 1 つ以上のディメンションの一意の値
    • 単一の指標値
    • 指標別の上位のディメンション値

  • 会話分析 API は、次のタイプの複雑な可視化でのみ回答できる質問をまだサポートしていません。

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