Conversational Analytics API 的已知限制

Conversational Analytics API 在数据源数量、可视化图表样式和数据集大小方面存在以下已知限制。

数据源限制

本部分介绍了在连接到 BigQuery、Looker 和数据库来源(AlloyDB for PostgreSQL、Cloud SQL for MySQL、Cloud SQL for PostgreSQL 和 Spanner)并对其执行查询时,对话式分析 API 的限制和行为。

Looker 数据源限制

连接到 Looker 数据源时,请注意以下事项:

  • 您可以在对话中查询任何包含的探索。
  • 代理一次只能查询一个探索。无法同时跨多个探索执行查询。
  • 代理可以在同一对话中查询多个探索。
  • 在包含多部分问题的对话中,或者在包含后续问题的对话中,代理可以在一次对话中查询多个探索。

    例如:某用户连接了两个探索,一个名为 cat-explore,另一个名为 dog-explore。用户输入问题“哪个数量更多:猫还是狗?”这将创建两个查询:一个用于统计 cat-explore 中的猫数量,另一个用于统计 dog-explore 中的狗数量。智能体在完成两个查询后,会比较两个查询的结果。

  • QueryData 方法不支持 BigQuery 或 Looker 数据源。

数据库数据源限制

连接到 AlloyDB、Cloud SQL for MySQL、Cloud SQL for PostgreSQL 或 Spanner 数据源时,请考虑以下事项:

  • 数据智能体使用与数据智能体交互的用户的凭证访问数据。如果用户访问的共享数据智能体中包含用户无权访问的已配置表,则该数据智能体无法访问这些表。

  • 为数据智能体选择表可引导智能体重点关注哪些表。表选择不是安全设置。即使您指定数据源只能从特定表(例如 table1 和 table2)中提取信息,如果运行查询的用户具有查看同一数据库中 table3 内容的常规权限,系统仍可能会返回来自非预期表 (table3) 的数据。

BigQuery 搜索范围限制

如果您使用搜索范围让对话式分析 API 选择要查询的 BigQuery 表,则存在以下限制:

  • 您只能在具有内嵌上下文的无状态对话请求中使用搜索范围。永久性数据智能体或使用对话引用的有状态聊天请求不支持搜索范围。
  • 您最多可以指定 100 个数据集和 100 个项目。

如需了解详情,请参阅连接到 BigQuery 数据集和项目。

可视化图表限制

支持以下可视化图表类型:

  • 区
  • 条形图
  • 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 的输出token长度上限为 8,192 个token。查询大量数据可能会返回 MAX_TOKENS 错误。
  • 系统消息的 DataResult 字段中返回的数据存在大小限制。数据结果会被截断,最多保留 3,000,000 字节。此截断过程会在大小限制范围内尽可能多地保留完整行。

查询限制

  • 不支持 BigQuery 的灵活列名称功能。
  • 支持 BigQuery 中的结构体,但相关操作某些情况下可能会失败。
  • 对于 Looker 数据源,该 API 无法设置使用 LookML parameter 参数定义的只有过滤条件的字段的值。
  • 当 Looker (Google Cloud Core) 实例位于 VPC Service Controls 边界内时,使用对话式分析 API 通过数据洞察 Pro 连接到专用 IP Looker (Google Cloud Core) 实例是不受支持的配置,不符合 VPC Service Controls 法规遵从要求。
  • 对于连接到具有专用 IP 配置的 Looker (Google Cloud Core) 实例的应用场景,对话式分析 API 不支持配置为使用 CMEK 或 VPC Service Controls 的 Looker (Google Cloud Core) 实例。
  • 对话式分析 API 无法很好地处理停用了报告中的字段修改功能的数据洞察数据源,因为这样设置会阻止对话式分析创建计算字段。
  • 如果在查询验证或执行期间发生故障,Conversational Analytics API 可能会通过生成更正后的查询来自动重试操作。系统将尝试执行此类重试操作,但每个请求最多重试三次。

    如果查询因权限或身份验证问题而失败,对话式分析 API 将不会重试该查询。重试是不确定的;如果出错提示表明查询不可恢复,那么即使查询仍低于每个请求三次错误的限制,对话式分析 API 也不会再次尝试该查询。

配额限制

  • 对话式分析 API 对总体请求(包括聊天和非聊天请求)有以下限制:
    • 每个项目每秒最多 30 次查询 (QPS),即每分钟最多 1,800 次查询 (QPM)。
    • 每个用户在每个项目中最多可达到 10 QPS(即 600 QPM)。
  • 作为例外,聊天请求具有更严格的限制:
    • 每个项目的速率上限为 30 QPM。
    • 每位用户每个项目每分钟最多 30 次查询。
    • 每个聊天请求会计为 8 个配额单位,而不是标准的 1 个单位。因此, Google Cloud 控制台配额页面显示的限制是实际请求限制的 8 倍。例如,240 个单位的限额代表 30 个聊天请求。
  • 智能体到智能体 (A2A) 请求的速率上限为每个项目每个智能体 100 QPM。每个内置智能体都有专属的配额,而自定义数据智能体则共享每个项目 100 QPM 的总配额。
  • 适用于 AlloyDB、Cloud SQL for MySQL、Cloud SQL for PostgreSQL 和 Spanner 的对话式分析 API 的 QPM 限制为每个项目 50。如需提高这些限制,请与 Google Cloud Customer Care 联系。

问题类型限制

  • 对话式分析 API 支持可通过单个可视化图表回答的问题,例如:

    • 指标随时间变化的趋势
    • 指标按维度细分或分布的情况
    • 一个或多个维度的唯一值
    • 单个指标值
    • 维度值排行榜(按指标排序)
  • 对话式分析 API 尚不支持只能通过以下类型的复杂可视化图表回答的问题:

    • 预测
    • 高级统计分析,包括相关性和异常检测