Descripción general de QueryData

QueryData te permite interactuar con tus datos usando lenguaje conversacional y agentes de datos que creas para ayudarte a consultar tus datos. Los agentes de datos son asistentes y aplicaciones potenciados por IA que pueden comprender la intención del usuario, consultar tus datos operativos y devolver respuestas precisas y fundamentadas. QueryData genera consultas para tu base de datos con conjuntos de contexto, que son colecciones de esquemas, lógica empresarial y planos seleccionados. Este contexto permite que QueryData traduzca preguntas en lenguaje natural en consultas precisas para tus casos de uso objetivo.

Cuándo usar QueryData

QueryData es ideal para aplicaciones como las siguientes:

  • Automatización de la atención al cliente: Maneja consultas de gran volumen, como "¿Dónde está mi pedido?" o "¿Cuál es mi saldo actual?".
  • Asistentes de compra de comercio electrónico: Ayudan a los usuarios a navegar por grandes catálogos de productos con preguntas en lenguaje natural, como "Muéstrame calzado para correr de menos de USD 100".
  • Herramientas de operaciones en terreno: Permiten que los empleados móviles consulten los niveles de inventario, la disponibilidad de piezas o los detalles de los tickets de servicio en tiempo real.

Conceptos básicos

Para traducir de forma confiable las preguntas conversacionales en consultas de bases de datos, QueryData se basa en los siguientes conceptos clave:

QueryData y la API de Conversational Analytics

El extremo QueryData de la API de Conversational Analytics es una herramienta de agente que permite la generación programática de consultas de lenguaje natural a SQL (NL2SQL) para tus bases de datos. En una aplicación conversacional o un flujo de trabajo de varios agentes, el extremo QueryData controla la interpretación del esquema y la síntesis de consultas. Tu arnés de agente (como Antigravity, el kit de desarrollo de agentes [ADK] o LangChain) administra el historial de conversaciones, el estado del usuario y la organización de herramientas para contextualizar la entrada del usuario antes de enviar una solicitud en lenguaje natural al extremo de QueryData.

Conjuntos de contextos

Un conjunto de contexto es una colección de conocimiento específico de la base de datos, patrones de búsqueda seleccionados y reglas de negocio asociadas con tu instancia de base de datos. En lugar de depender únicamente del conocimiento general del LLM o de los esquemas de tablas sin procesar, QueryData usa conjuntos de contexto para comprender los matices de tu modelo de datos y la terminología específica de la organización.

Un conjunto de contexto contiene tres componentes básicos principales:

  • Esquemas de preguntas: Pares seleccionados de preguntas representativas en lenguaje natural y sus correspondientes consultas en SQL validadas previamente. Los esquemas proporcionan ejemplos canónicos que definen cómo las intenciones comerciales específicas se asignan a instrucciones SQL.
  • Facetas de búsqueda: Son predicados y condiciones de filtro modulares de SQL (como rangos de fechas, cálculos de umbrales o marcas comerciales). Las facetas permiten que QueryData combine de forma dinámica varios criterios de filtrado en una consulta sin necesidad de tener planos separados para cada combinación.
  • Búsquedas de valores: Son búsquedas semánticas y de concordancia de cadenas que fundamentan frases informales en valores exactos almacenados en columnas de bases de datos. Las búsquedas de valores ayudan a resolver ambigüedades (por ejemplo, asignar "Bay Area" a San Francisco o "Heathrow" a London Heathrow Airport) con concordancias exactas, similitud de cadenas de trigramas o embeddings de vectores semánticos.

Vistas seguras parametrizadas

Para garantizar que las consultas generadas por IA respeten la seguridad a nivel de la fila y el aislamiento de múltiples inquilinos, puedes usar vistas seguras parametrizadas, que restringen el SQL generado para que solo acceda a las filas de datos que el usuario autenticado de la aplicación tiene autorización para ver. Para obtener más información, consulta Cómo proteger y controlar el acceso a los datos de la aplicación con vistas seguras parametrizadas.

Cómo funciona QueryData

Cuando tu agente o aplicación envía una solicitud en lenguaje natural (como la pregunta de un usuario que el agente contextualizó con el historial de conversaciones o el estado del usuario), QueryData realiza los siguientes pasos:

  1. Resolución de valores: QueryData ejecuta búsquedas de valores en la base de datos para asignar entidades en la instrucción (como nombres, ciudades o categorías) a valores específicos de columnas de la base de datos.
  2. Coincidencia y desambiguación de la intención: QueryData compara la solicitud contextualizada con los planos y las facetas de búsqueda seleccionados que definiste en el conjunto de contexto. Si la solicitud no está bien especificada o es ambigua, QueryData puede devolver una pregunta de desambiguación para que tu agente o aplicación le pida al usuario que aclare su solicitud.
  3. Síntesis de la consulta: Con la estructura del esquema coincidente, las facetas aplicadas y los valores resueltos, QueryData sintetiza una consulta en SQL completa para tu motor de base de datos.
  4. Ejecución de la consulta: La consulta generada se ejecuta en la base de datos para devolver resultados.

Crea y administra conjuntos de información contextual

Para crear y administrar conjuntos de contexto, haz lo siguiente:

  1. Contexto del autor: Define los esquemas de búsqueda, las facetas y las búsquedas de valores para tu base de datos. Para obtener más información, consulta la Descripción general de los conjuntos de contexto. También puedes usar el agente de ingeniería de contexto para automatizar la creación de contexto.
  2. Administrar en la Google Cloud consola: Crea y administra conjuntos de contexto en Cloud SQL Studio para que estén disponibles para la generación de consultas.
  3. Integración con tus aplicaciones: Conecta tus aplicaciones o agentes de IA a QueryData con MCP Toolbox o llamadas directas a la API.

Precios

Se te cobra según los precios de procesamiento de Cloud SQL para MySQL por las consultas que se ejecutan cuando creas conjuntos de contexto y usas QueryData con tus agentes de datos o fuentes de datos de bases de datos. No se aplican cargos adicionales por crear y usar conjuntos de contexto y QueryData durante el período de vista previa. Para obtener más información, consulta los precios del agente de Data Cloud.

¿Qué sigue?