Conversational Analytics API 版本说明

这些版本说明适用于 Conversational Analytics API 的更新。

2025 年 9 月 25 日

Conversational Analytics API 更新：

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

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

现在，systemMessage.text.textType 枚举提供 FINAL_RESPONSE 和 THOUGHT 值，可帮助客户端区分不同类型的消息。Conversational Analytics API 现在使用包含 textType = THOUGHT 的 systemMessage.text 消息来生成思考步骤。

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

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

2025 年 8 月 25 日

Conversational Analytics API 现已推出公开预览版。

客户端库更新：

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

Conversational Analytics API 更新：

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

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

您现在可以通过基于使用专用 IP 网络的 Looker (Google Cloud Core) 实例的 Looker 数据源构建数据代理。（Conversational Analytics 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 快速入门应用在几分钟内设置 Conversational Analytics API 的演示。

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

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

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

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

排查 Conversational Analytics API 错误：详细了解 Conversational Analytics API 的潜在问题或错误，以及建议的解决方案。

监控和管理 Conversational Analytics API 代理的 BigQuery 费用：详细了解如何为 Conversational Analytics API 代理实现费用控制。

Conversational Analytics API 概览文档页面上提供了 SetIAMPolicy 和 GetIAMPolicy 方法，用于共享数据代理。

我们现已推出一个新文档页面，其中包含 Conversational Analytics 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 日

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

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

API 更新：

借助 Data Agent Service，您可以使用 Looker、Looker Studio 和 BigQuery 以编程方式创建、配置和管理持久的情境感知 AI 代理。

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

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

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