QueryData 概览

借助 QueryData，您可以使用对话语言与数据互动，并构建 数据智能体 来帮助您查询数据。数据智能体是 AI 赋能的助理和应用，可以理解用户意图、查询运营数据并返回准确、基于事实的答案。QueryData 使用上下文集（即精选的蓝图、业务逻辑和架构信息的集合）为您的数据库生成查询。借助此上下文，QueryData 可以将自然语言问题转换为针对目标用例的准确查询。

何时使用 QueryData

QueryData 非常适合以下应用：

  • 客户服务自动化：处理大量咨询，例如“我的订单在哪里？”或“我的当前余额是多少？”。
  • 电子商务购物助理：帮助用户使用自然语言查询（例如“显示 100 美元以下的跑鞋”）浏览大型产品 目录。
  • 现场运营工具：让移动员工能够实时查询库存 水平、零件可用性或服务工单详情。

核心概念

为了可靠地将对话问题转换为数据库查询，QueryData 依赖于以下关键概念：

QueryData 和 Conversational Analytics API

Conversational Analytics API 中的 QueryData 端点是一种智能体工具，可为您的数据库以编程方式生成自然语言到 SQL 的 查询。在对话应用或 Agentic Workflows 中，QueryData 端点负责处理架构解读和查询合成。您的智能体 Harness（例如 Antigravity、智能体开发套件 (ADK) 或 LangChain）负责管理对话历史记录、用户状态和工具编排，以便在将自然语言请求发送到 QueryData 端点之前对用户输入进行情境化处理。

上下文集

上下文集是与数据库实例关联的数据库专用知识、精选查询模式和业务规则的集合。QueryData 不仅依赖于通用 LLM 知识或原始表架构，还使用上下文集来了解数据模型的细微差别和组织专用术语。

上下文集包含三个主要构建块：

  • 查询蓝图：精选的代表性自然语言 问题及其对应的预验证 SQL 查询对。蓝图提供了规范示例，用于定义特定业务意图如何映射到 SQL 语句。
  • 查询方面：模块化 SQL 谓词和过滤条件（例如日期 范围、阈值计算或业务标志）。借助方面，QueryData 可以将多个过滤条件动态组合成一个查询，而无需为每个组合单独创建蓝图。
  • 值搜索：语义和字符串匹配查询，用于将 非正式短语与数据库列中存储的精确值进行关联。值搜索有助于使用完全匹配、三元组字符串相似度或语义向量嵌入来消除歧义（例如，将“湾区”映射到 San Francisco，或将“希思罗”映射到 London Heathrow Airport）。

参数化安全视图

为了确保 AI 生成的查询遵循行级安全性和多租户隔离，您可以使用参数化安全视图，该视图会将生成的 SQL 限制为仅访问经过身份验证的应用用户有权查看的数据行。如需了解详情，请参阅使用参数化安全视图保护应用数据安全并 控制对应用数据的访问权限。

QueryData 的工作原理

当您的智能体或应用发送自然语言请求（例如，智能体已使用对话历史记录或用户状态进行情境化处理的用户问题）时，QueryData 会执行以下步骤：

  1. 值解析：QueryData 针对 数据库运行值搜索查询，以将提示中的实体（例如名称、城市或类别）映射到 特定的数据库列值。
  2. 意图匹配和消除歧义：QueryData 将情境化处理后的 请求与您在 上下文集中定义的精选查询蓝图和方面进行匹配。如果请求不够明确或存在歧义，QueryData 可以返回消除歧义问题，以便您的智能体或应用要求用户进行澄清。
  3. 查询合成：QueryData 使用匹配的蓝图结构、应用的方面、 和解析的值，为您的 数据库引擎合成完整的 SQL 查询。
  4. 查询执行：生成的查询针对数据库执行，以 返回结果。

编写和管理上下文集

如需编写和管理上下文集，请执行以下操作：

  1. 编写上下文：为您的数据库定义查询蓝图、方面和值搜索 。如需了解详情，请参阅上下文集概览。 您还可以使用上下文工程智能体 来自动创建上下文。
  2. 在 Google Cloud 控制台中进行管理：在 Cloud SQL Studio 中创建和管理上下文集，使其可用于生成查询 。
  3. 与应用集成：使用 MCP Toolbox 或直接 API 调用将应用或 AI 智能体 连接到 QueryData。

价格

当您创建上下文集并使用 QueryData 与您的 数据智能体或数据库数据源搭配使用时，系统会按照 Cloud SQL for MySQL 计算价格 向您收取查询费用。在 预览版期间，创建 和使用上下文集以及 QueryData 不会产生额外费用。如需了解详情，请参阅 Data Cloud 智能体价格。

后续步骤