Conversational Analytics API 版本说明

这些版本说明适用于对话式分析 API 的更新。

2026 年 4 月 16 日

对话式分析 API 更新：

功能

对话式分析 API 现在支持查询连接到 Apache Iceberg REST 目录或联合到外部目录的 Lakehouse 表。如果您使用的是 Lakehouse 表，请使用四部分 project.catalog.namespace.table (P.C.N.T) 语法。如需了解详情，请参阅进行身份验证并连接到数据源。

2026 年 3 月 30 日

对话式分析 API 更新：

功能

对话式分析 API 现在支持将 AlloyDB for PostgreSQL、Cloud SQL for MySQL、Cloud SQL for PostgreSQL 和 Spanner 用作数据源。借助此功能，用户可以使用自然语言查询其运营数据，并将复杂的人类对话转换为精确的数据库查询，以提供可据以采取行动的洞见。此功能处于预览版阶段。如需了解详情，请参阅以下内容：

功能

针对 BigQuery 数据源的对话式分析 API 更新包括以下功能和改进：

对话式分析 API 现在通过 ObjectRef 函数与 Cloud Storage 集成。这样，API 就可以通过引用任何表中的 ObjectRef 列，回答有关 Cloud Storage 存储分区中非结构化数据（例如图片和 PDF）的问题。
该 API 现在支持一组 BigQuery ML 函数，包括 AI.FORECAST、AI.DETECT_ANOMALIES 和 AI.GENERATE。API 可以使用这些函数回答更广泛的问题，例如预测、异常检测和生成式 AI 任务。
对话式分析 API 现在可以使用 BigQuery 表分区。API 可以通过在按日期分区的表上使用分区列（例如日期范围）来优化 SQL 查询，从而提高查询性能并降低费用。
由对话式分析 API 发起的 BigQuery 作业现在包含标签，您可以在BigQuery 作业记录中识别这些标签，这些记录位于 Google Cloud 控制台中。这些标签有助于监控费用、审核代理活动和分析查询性能。由于这些标签不会直接显示在 BigQuery Studio 作业记录表中，因此您可以通过查询 INFORMATION_SCHEMA.JOBS 来识别与 {'ca-bq-job': 'true'} 类似的标签：
```
SELECT
  COUNT(*) AS job_count
FROM
  `PROJECT_ID`.`region-LOCATION`.INFORMATION_SCHEMA.JOBS
WHERE
  EXISTS (
    SELECT 1
    FROM UNNEST(labels) AS label
    WHERE label.key = 'ca-bq-job' AND label.value = 'true'
  );
```
在示例查询中，您需要按如下所示替换示例值：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- LOCATION：BigQuery 作业的位置。

功能

对于使用 Looker 或 BigQuery 数据源的数据代理，您现在可以在聊天请求中指定 thinkingMode 值为 FAST，以启用“快速”思考模式。快速思考有助于缩短整体思考时间，从而缩短延迟时间。不过，此模式会降低回答的透明度，因为响应流中不会发出 TextType 值为 THOUGHT 的消息。此外，使用此模式可能会影响回答的准确性。

功能

对于使用 Looker 数据源的数据代理，代理现在可以提出后续问题，以澄清查询中的歧义，例如当有多个名称相似的字段时。这些问题会以 TextMessage 响应的形式返回，并带有 Clarification needed: 前缀。如需了解详情，请参阅提出有效问题。

功能

对于使用 BigQuery 数据源的数据代理，代理现在可以提出后续问题，以澄清查询中的歧义，例如当有多个名称相似的字段时。这些问题会以 TextMessage 响应的形式返回。

已更改

对于使用 Looker 数据源的数据代理，我们进行了一些改进以缩短延迟时间，包括并行工具调用和更好地利用 Looker 缓存。

2026 年 3 月 26 日

对话式分析 API 更新：

功能

对于使用 Looker 数据源的对话式分析 API，您可以使用客户管理的加密密钥 (CMEK) 来帮助保护静态 DataAgent 和 Conversation 资源。对话式分析 API 中的 CMEK 处于预览版阶段。如需了解详情，请参阅客户管理的加密密钥 (CMEK)。

2026 年 2 月 11 日

对话式分析 API 更新：

功能

使用 BigQuery 数据源的 Chat 请求现在可以更深入地了解代理的推理过程。虽然 API 架构保持不变，但您会在响应流中观察到以下新行为：

API 响应流现在包含额外的 systemMessage.text 消息，且 textType = THOUGHT。这些消息可让您逐步了解代理的推理和决策流程。
在 THOUGHT 消息之后，API 会以一系列消息（例如查询、作业、文本、数据结果和图表消息）的形式返回答案。如需详细了解消息类型，请参阅 SystemMessage。
架构消息不再包含在 BigQuery 数据源的响应流中。

功能

同步代理管理方法现已推出。这些方法允许您同步创建、更新和删除数据代理，作为现有异步方法的替代方案：

CreateDataAgentSync
UpdateDataAgentSync
DeleteDataAgentSync

已更改

BigQuery 数据源不再支持 Python 分析选项 (options.analysis.python.enabled)。

2026 年 2 月 6 日

对话式分析 API 更新：

功能

对于使用 Looker 数据源的数据代理，您现在可以将黄金版 Looker 查询定义为结构化上下文。

2026 年 1 月 26 日

对话式分析 API 更新：

功能

推理透明度得到提升，可让您逐步了解代理的推理和决策流程，并提供 textType = THOUGHT 消息，不再需要许可名单，并且适用于 Looker 数据源的所有用户。

功能

Looker 数据源的精细数据检索功能可让您通过 textType = PROGRESS 消息获取数据值搜索的更新，不再需要许可名单，并且适用于所有用户。

2025 年 12 月 15 日

对话式分析 API 更新：

功能

Looker 数据源的 API 响应流包含额外的 systemMessage.text 消息，且 textType = THOUGHT。这些消息可让您逐步了解代理在回答查询时所用的推理和决策流程。如需运行演示此推理过程的对话示例，请参阅 HTTP 和 Python SDK Colaboratory 笔记本。如需了解如何呈现 Look0/} 数据源的 THOUGHT 消息，请参阅呈现 Looker 数据源的智能体回答。这是一项实验性功能的早期公告，该功能可根据请求提供。如需请求访问此功能，请发送邮件至 conversational-analytics-api-feedback@google.com。

注意：自 2026 年 1 月 26 日起，此功能不再需要许可名单，并且适用于 Looker 数据源的所有用户；请参阅2026 年 1 月 26 日的条目。

功能

对于 Looker 数据源，代理使用更精细的方法来检索探索架构和数据值。当代理搜索特定数据值时，API 流还会包含 systemMessage.text 消息，且 textType = PROGRESS，从而提供有关搜索状态和结果的更新。如需了解如何呈现 PROGRESS 消息，请参阅呈现 Looker 数据源的智能体回答。这是一项实验性功能的早期公告，该功能可根据请求提供。如需请求访问此功能，请发送邮件至 conversational-analytics-api-feedback@google.com。

注意：自 2026 年 1 月 26 日起，此功能不再需要许可名单，并且适用于 Looker 数据源的所有用户；请参阅2026 年 1 月 26 日的条目。

功能

对话式分析 API 与 VPC Service Controls 的集成处于预览版阶段。此项产品集成已为更广泛的测试和使用做好准备，但尚未完全支持生产环境。如需了解详情，请参阅支持的产品列表。

已修复

修复了 big_query_max_billed_bytes 未正确应用的问题。

已修复

修复了 API 处理 Looker 数据源的方式存在的问题，包括：

文本响应中的值格式更完善
更完善的完全匹配过滤
改进了同比 (PoP) 指标支持
完善了 always_filter 支持

客户端库更新：

功能

添加了以下客户端库：

2025 年 10 月 21 日

对话式分析 API 更新：

功能

向 REST API 和 SDK 添加了对 deleteConversation API 方法的支持。

2025 年 9 月 25 日

对话式分析 API 更新：

功能

现在提供了一个新的 API ListAccessibleDataAgents，用于列出用户在项目中可访问的数据代理。如果调用 API 的用户对代理具有 get 权限，则该数据代理被视为可访问。您可以使用 creator_filter 字段来管理此方法返回哪些代理：

NONE（默认）：返回用户可访问的所有数据代理，无论创建者是谁。
CREATOR_ONLY：仅返回用户创建的数据代理。
NOT_CREATOR_ONLY：仅返回其他用户创建的数据代理。

功能

现在，systemMessage.text.textType 枚举提供 FINAL_RESPONSE 和 THOUGHT 值，可帮助客户端区分不同类型的消息。对话式分析 API 现在使用 systemMessage.text 消息（且 textType = THOUGHT）来生成思考步骤。

功能

该 API 现在支持上下文中的最多五个 Looker 探索数据源。Chat 请求会针对最相关的探索生成查询。如需了解详情，请参阅有关使用 HTTP 和 Python SDK 连接到 Looker 数据的文档。

已更改

systemMessage.data.generatedLookerQuery 字段现在为 systemMessage.data.query.looker。

2025 年 8 月 25 日

通知

对话式分析 API 现已推出公开预览版。

客户端库更新：

功能

以下客户端库现已支持多种语言：

对话式分析 API 更新：

功能

现在支持适用于 HTTP REST 的 v1beta 端点。

功能

向 REST API 和 SDK 添加了对 GetLocation 和 ListLocations API 方法的支持。

功能

您现在可以通过基于使用专用 IP 网络的 Looker (Google Cloud Core) 实例的 Looker 数据源构建数据代理。（对话式分析 API 不支持基于位于虚拟私有云边界内的 Looker (Google Cloud Core) 实例的数据源。）

功能

BigQuery 数据源的结构化上下文现已推出。这包括能够使用 API 在表和字段级别添加示例问题/查询对、表说明、同义词和标记。

已更改

现在支持位置和操作 API。DataAgentCreator 和 DataAgentEditor Identity and Access Management 角色现在拥有适用于操作 API 的权限。

已更改

我们对以下功能进行了增强：每当数据代理的已发布上下文更新时，在服务器层自动存储 Last Published Context。

已更改

Identity and Access Management 角色的显示名称已更新为“Gemini Data Analytics Stateless Chat User”和“Gemini Data Analytics Data Agent Creator”。如需详细了解与该 API 搭配使用的 Identity and Access Management 角色，请参阅授予 Conversational Analytics API Identity and Access Management 角色和权限文档页面。

已更改

Colaboratory 版本 1.1 现已推出。

已修复

更新了错误处理功能，以便为有状态聊天处理对话相关 500 内部错误。

已修复

针对 400 客户端错误实现了更完善的异常处理消息。

文档更新：

功能

您现在可以使用 GitHub 上的 Streamlit 快速入门应用在几分钟内设置对话式分析 API 的演示。

功能

对话式分析 API 黄金版演示现已在 GitHub 上推出。借助 Conversational Analytics API 黄金版演示，您可以查看将 Conversational Analytics API 集成到 Web 应用中的示例，以及使用 TypeScript 编写的完整生产演示。此项目仅用于演示目的。它不适用于生产环境。

功能

我们为 REST API 和 SDK 添加了请求载荷代码示例。

功能

对话式分析 API 架构、工作流和角色：详细了解使用对话式分析 API 的关键概念，包括数据代理的工作方式、典型的数据代理工作流、对话模式、Identity and Access Management 角色，以及如何设计使用多个数据代理的系统。

功能

对话式分析 API 已知限制：详细了解数据源数量、可视化图表样式和数据集大小方面的限制。

功能

排查对话式分析 API 错误：详细了解对话式分析 API 的潜在问题或错误，以及建议的解决方案。

功能

监控和管理对话式分析 API 代理的 BigQuery 费用：详细了解如何为对话式分析 API 代理实现费用控制。

功能

SetIAMPolicy 和 GetIAMPolicy 方法在对话式分析 API 概览文档页面上提供，用于共享数据代理。

功能

我们现已推出一个新文档页面，其中包含对话式分析 API 的常见问题解答。

功能

为 BigQuery 数据源定义数据代理上下文：详细了解如何为 BigQuery 数据源编写系统指令。

功能

为 Looker 数据源定义数据代理上下文：详细了解如何为 Looker 数据源编写系统指令。

2025 年 7 月 15 日

功能

新的最佳实践指南可帮助您为代理提供有效的业务和数据上下文。如需了解详情，请参阅使用编写的上下文来引导代理行为。

SDK 更新：

功能

您现在可以从 Python 软件包索引 (PyPI) 安装 Python SDK。

2025 年 6 月 25 日

API 更新：

功能

新的预定义 IAM 角色可控制用于创建、管理数据代理以及与数据代理互动的访问权限：

geminidataanalytics.dataAgentCreator
geminidataanalytics.dataAgentOwner
geminidataanalytics.dataAgentEditor
geminidataanalytics.dataAgentUser
geminidataanalytics.dataAgentViewer
geminidataanalytics.dataAgentStatelessUser

如需查看角色及其权限的完整列表，请参阅授予 Conversational Analytics API IAM 角色和权限。

2025 年 6 月 5 日

通知

对话式分析 API 的初始非公开预览版引入了用于创建数据代理并与之互动的各项功能。

功能

以下交互式 Colaboratory 笔记本可帮助您开始使用 REST 和 Python SDK：

API 更新：

功能

借助 **Data Agent Service** ，您可以使用 Looker、数据洞察和 BigQuery 以程序化方式创建、配置和管理持久的情境感知 AI 代理。

功能

借助 **Data Chat Service** ，您可以使用多种聊天模式与代理进行对话。这些模式包括有状态模式（Google 管理对话历史记录）、有状态选项（您的应用管理对话）以及无状态模式（您的应用在每次请求中提供完整上下文）。

功能

该 API 支持使用 Python 进行高级分析，并会自动重试失败的查询。

已更改

对话式分析 API (geminidataanalytics.googleapis.com) 取代了已弃用的 Data QnA API (dataqna.googleapis.com)。这包括从 DataQuestionService 迁移到新的 DataChatService。有关如何更新请求的详细说明，请参阅迁移指南。

Conversational Analytics API 版本说明 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

2026 年 4 月 16 日

2026 年 3 月 30 日

2026 年 3 月 26 日

2026 年 2 月 11 日

2026 年 2 月 6 日

2026 年 1 月 26 日

2025 年 12 月 15 日

2025 年 10 月 21 日

2025 年 9 月 25 日

2025 年 8 月 25 日

2025 年 7 月 15 日

2025 年 6 月 25 日

2025 年 6 月 5 日

Conversational Analytics API 版本说明