API de Conversational Analytics: Crea agentes de datos y chatea con tus datos

Vista previa privada

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Los desarrolladores pueden usar la API de Conversational Analytics, a la que se accede a través de geminidataanalytics.googleapis.com, para crear una interfaz de chat o un agente de datos potenciados por la inteligencia artificial (IA) que responda preguntas sobre datos estructurados en BigQuery, Looker y Looker Studio con lenguaje natural. Con la API de Conversational Analytics, le proporcionas a tu agente de datos información y datos empresariales ("contexto"), así como acceso a herramientas como SQL, Python y bibliotecas de visualización. Estas respuestas del agente se presentan al usuario y la aplicación cliente puede registrarlas, lo que crea una experiencia de chat de datos sin inconvenientes y auditable.

Importante: Si migras desde la API de Data QnA, consulta la guía de migración para obtener una descripción general de las diferencias clave y los pasos de migración necesarios.

Descubre cómo y cuándo Gemini para Google Cloud usa tus datos. Como tecnología en etapa inicial, los productos de Gemini para Google Cloud pueden generar resultados que parecen posibles, pero que no son correctos. Te recomendamos validar todos los resultados de Gemini para los productos de Google Cloud antes de usarlos. Para obtener más información, consulta Gemini para Google Cloud y la IA responsable.

Nota: Las ofertas de la vista previa de la fase previa a la DG (1) están diseñadas para usarse solo en entornos de prueba y no deben usarse en un entorno de producción ni para procesar datos personales ni otros datos sujetos a requisitos de cumplimiento legal o normativo, y (2) están sujetas a las Condiciones de las Ofertas de Fase Previa a la DG de las Condiciones Específicas del Servicio y al Anexo de Consentimiento para Gemini para el Google Cloud Programa de Verificador de Confianza.

Comienza a usar la API de Conversational Analytics

Sigue estos pasos para configurar tu entorno y comenzar a crear agentes de datos y a interactuar con ellos mediante la API de Conversational Analytics.

Nota: Para usar la API de Conversational Analytics, debes formar parte de la versión preliminar privada. Para expresar tu interés, completa el formulario de interés de la versión preliminar.

Configuración y requisitos previos

Antes de usar la API o los ejemplos, completa los siguientes pasos:

• Habilita la API de Conversational Analytics: Describe los requisitos previos para habilitar la API de Conversational Analytics.
• Cómo autenticar y conectarse a una fuente de datos con la API de Conversational Analytics: Proporciona instrucciones para autenticar la API y configurar conexiones a tus datos de BigQuery, Looker y Looker Studio.

Compila un agente de datos y, luego, interactúa con él

Después de completar los pasos anteriores, usa la API de Conversational Analytics para compilar un agente de datos y, luego, interactuar con él. Para ello, sigue estos pasos:

• Crea un agente de datos con HTTP: Proporciona un ejemplo completo de cómo compilar un agente de datos y cómo interactuar con él mediante solicitudes HTTP directas con Python.
• Cómo compilar un agente de datos con el SDK de Python: Proporciona un ejemplo completo de cómo compilar un agente de datos y cómo interactuar con él mediante el SDK de Python.
• Crea una conversación de varias rondas: Proporciona orientación y ejemplos para controlar las preguntas de seguimiento (con y sin estado) con el SDK de Python.
• Cómo renderizar una respuesta del agente de la API de Conversational Analytics como una visualización: Proporciona un ejemplo de cómo procesar las especificaciones de los gráficos a partir de las respuestas de la API y renderizarlas como visualizaciones con el SDK de Python y la biblioteca Vega-Altair.

Operaciones clave de la API

La API proporciona los siguientes extremos principales para administrar agentes de datos y conversaciones:

Nombre de la API	Método HTTP	Extremo	Descripción
Crear agentes	POST	/v1alpha/projects/*/locations/*/dataAgents	Crea un agente de datos nuevo.
Obtener agentes	GET	/v1alpha/projects/*/locations/*/dataAgents/*	Recupera los detalles de un agente de datos específico.
Actualizar agente	PATCH	/v1alpha/projects/*/locations/*/dataAgents/*	Modifica un agente de datos existente.
Borrar agente	DELETE	/v1alpha/projects/*/locations/*/dataAgents/*	Quita un agente de datos.
Enumerar agentes	GET	/v1alpha/projects/*/locations/*/dataAgents	Muestra una lista de los agentes de datos disponibles en un proyecto.
Chat	POST	/v1alpha/projects/*/locations/*:chat	Envía un mensaje de chat a un agente de datos.
Crear conversaciones	POST	/v1alpha/projects/*/locations/*/conversations	Inicia una conversación nueva.
Obtener conversaciones	GET	/v1alpha/projects/*/locations/*/conversations/*	Recupera los detalles de una conversación específica.
Enumerar conversaciones	GET	/v1alpha/projects/*/locations/*/conversations	Muestra una lista de las conversaciones de un proyecto específico.
Mostrar lista de mensajes	GET	/v1alpha/projects/*/locations/*/conversations/*/messages	Muestra una lista de los mensajes de una conversación específica.

Recursos adicionales

• Documentación de referencia de la API de Conversational Analytics: Proporciona descripciones detalladas de los métodos, los extremos y las definiciones de tipos para las estructuras de solicitud y respuesta.