API de análisis conversacional: cree agentes de datos y chatee con sus datos

Vista previa privada

Este producto o característica está sujeto a los "Términos de ofertas previas al lanzamiento general" en la sección Términos generales del servicio de los Términos específicos del servicio . Los productos y funciones pre-GA están disponibles "tal cual" y pueden tener soporte limitado. Para obtener más información, consulte las descripciones de las etapas de lanzamiento .

Los desarrolladores pueden usar la API de Análisis Conversacional, a la que se accede a través de geminidataanalytics.googleapis.com , para crear una interfaz de chat basada en inteligencia artificial (IA), o agente de datos, que responde a preguntas sobre datos estructurados en BigQuery, Looker y Looker Studio mediante lenguaje natural. Con la API de Análisis Conversacional, se proporciona al 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, creando una experiencia de chat de datos fluida y auditable.

Importante: si está migrando desde la API de Data QnA, consulte 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 Géminis te acompaña Google Cloud utiliza sus datos . Como tecnología en etapa inicial, Gemini para Google Cloud Los productos pueden generar resultados que parecen plausibles, pero que son incorrectos en los hechos. Recomendamos que valide todos los resultados de Gemini para Google Cloud productos antes de usarlos. Para obtener más información, consulte Gemini para Google Cloud y una IA responsable .

Nota: Las ofertas de vista previa de pre-GA (1) están destinadas a usarse solo en entornos de prueba y no deben usarse en un entorno de producción ni para procesar datos personales u otros datos sujetos a requisitos de cumplimiento legal o reglamentario, y (2) están sujetas a los Términos de ofertas de pre-GA de los Términos específicos del servicio y el Anexo de consentimiento para Gemini. Google Cloud Programa de probadores de confianza .

Comience a utilizar la API de análisis conversacional

Siga estos pasos para configurar su entorno y comenzar a crear e interactuar con agentes de datos mediante la API de análisis conversacional.

Nota: Para usar la API de Análisis Conversacional, debes participar en la vista previa privada. Para expresar tu interés, completa el formulario de interés de la vista previa .

Configuración y requisitos previos

Antes de utilizar la API o los ejemplos, complete los siguientes pasos:

• Habilitar la API de análisis conversacional : describe los requisitos previos para habilitar la API de análisis conversacional.
• Autenticar y conectarse a una fuente de datos con la API de análisis conversacional : proporciona instrucciones para autenticarse en la API y configurar conexiones a sus datos de BigQuery, Looker y Looker Studio.

Construir e interactuar con un agente de datos

Después de completar los pasos anteriores, utilice la API de análisis conversacional para crear e interactuar con un agente de datos siguiendo estos pasos:

• Construir un agente de datos usando HTTP : proporciona un ejemplo completo de construcción e interacción con un agente de datos mediante solicitudes HTTP directas con Python.
• Construya un agente de datos usando el SDK de Python : proporciona un ejemplo completo de construcción e interacción con un agente de datos mediante el SDK de Python.
• Crear una conversación de varios turnos : proporciona orientación y ejemplos para manejar preguntas de seguimiento (tanto con estado como sin estado) mediante el SDK de Python.
• Representar una respuesta de un agente de API de Conversational Analytics como una visualización : proporciona un ejemplo de procesamiento de especificaciones de gráficos a partir de respuestas de API y su representación como visualizaciones mediante el SDK de Python y la biblioteca Vega-Altair.

Operaciones clave de API

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

Nombre de la API	Método HTTP	Punto final	Descripción
Crear agente	POST	/v1alpha/projects/*/locations/*/dataAgents	Crea un nuevo agente de datos.
Obtener agente	GET	/v1alpha/projects/*/locations/*/dataAgents/*	Recupera detalles de un agente de datos específico.
Agente de actualización	PATCH	/v1alpha/projects/*/locations/*/dataAgents/*	Modifica un agente de datos existente.
Eliminar agente	DELETE	/v1alpha/projects/*/locations/*/dataAgents/*	Elimina un agente de datos.
Agentes de lista	GET	/v1alpha/projects/*/locations/*/dataAgents	Enumera los agentes de datos disponibles en un proyecto.
Charlar	POST	/v1alpha/projects/*/locations/*:chat	Envía un mensaje de chat a un agente de datos.
Crear conversación	POST	/v1alpha/projects/*/locations/*/conversations	Inicia una nueva conversación.
Obtener conversación	GET	/v1alpha/projects/*/locations/*/conversations/*	Recupera detalles de una conversación específica.
Lista de conversaciones	GET	/v1alpha/projects/*/locations/*/conversations	Enumera las conversaciones en un proyecto específico.
Lista de mensajes	GET	/v1alpha/projects/*/locations/*/conversations/*/messages	Enumera los mensajes dentro de una conversación específica.

Recursos adicionales

• Documentación de referencia de la API de análisis conversacional : proporciona descripciones detalladas de métodos, puntos finales y definiciones de tipos para estructuras de solicitud y respuesta.