Estas notas de la versión corresponden a las actualizaciones de la API Conversational Analytics.
25 de septiembre del 2025
Novedades de la API Conversational Analytics:
Ahora está disponible una nueva API, ListAccessibleDataAgents, para mostrar los agentes de datos a los que puede acceder un usuario en un proyecto. Se considera que un agente de datos es accesible si el usuario que invoca la API tiene el permiso get en el agente. Puedes usar el campo creator_filter para gestionar qué agentes devuelve este método:
NONE(valor predeterminado): devuelve todos los agentes de datos a los que puede acceder el usuario, independientemente de quién los haya creado.CREATOR_ONLY: devuelve solo los agentes de datos que ha creado el usuario.NOT_CREATOR_ONLY: devuelve solo los agentes de datos creados por otros usuarios.
El enum systemMessage.text.textType ahora está disponible con los valores FINAL_RESPONSE y THOUGHT, lo que ayuda a los clientes a distinguir entre diferentes tipos de mensajes de texto. La API Conversational Analytics ahora usa mensajes systemMessage.text con textType = THOUGHT para generar pasos de reflexión.
La API ahora admite hasta cinco fuentes de datos de Exploraciones de Looker en contexto. Las solicitudes de chat generan consultas en la función Explorar más relevante. Para obtener más información, consulta la documentación sobre cómo conectarse a datos de Looker con HTTP y con el SDK de Python.
El campo systemMessage.data.generatedLookerQuery ahora es systemMessage.data.query.looker.
25 de agosto del 2025
La API Conversational Analytics ya está disponible en la vista previa pública.
Actualizaciones de la biblioteca de cliente:
Las siguientes bibliotecas de cliente están disponibles en varios idiomas:
Novedades de la API Conversational Analytics:
Ya se pueden usar los puntos de conexión de la versión v1beta de HTTP REST.
Se ha añadido compatibilidad con los métodos de la API GetLocation y ListLocations a las APIs REST y al SDK.
Ahora puede compartir agentes de datos mediante los métodos de la API GetIamPolicy y SetIamPolicy.
Ahora puede crear agentes de datos a partir de fuentes de datos de Looker basadas en instancias de Looker (Google Cloud core) que usen redes IP privadas. La API Conversational Analytics no admite fuentes de datos basadas en instancias de Looker (Google Cloud core) que estén dentro de perímetros de nube privada virtual.
Ya está disponible el contexto estructurado para las fuentes de datos de BigQuery. Esto incluye la posibilidad de añadir pares de preguntas o consultas de ejemplo, descripciones de tablas, sinónimos y etiquetas a nivel de tabla y de campo mediante la API.
Ahora se admiten las APIs de ubicación y operación. Los roles de gestión de identidades y accesos DataAgentCreator y DataAgentEditor ahora tendrán permisos para las APIs de operaciones.
Se ha mejorado el almacenamiento automático de Last Published Context en la capa del servidor cada vez que se actualiza el contexto publicado de un agente de datos.
Los nombres visibles de los roles de Gestión de Identidades y Accesos se han actualizado a "Usuario de chat sin estado de analíticas de datos de Gemini" y "Creador de agentes de datos de analíticas de datos de Gemini". Para obtener más información sobre los roles de gestión de identidades y accesos que se usan con la API, consulta la página de documentación Conceder roles y permisos de gestión de identidades y accesos de la API Conversational Analytics.
La versión 1.1 de Colaboratory ya está disponible.
Se han realizado actualizaciones en la gestión de errores para gestionar los errores internos 500 relacionados con las conversaciones en el chat con estado.
Se han implementado mensajes de gestión de excepciones mejorados para los errores de cliente 400.
Actualizaciones de la documentación:
Ahora puedes usar la nueva aplicación de inicio rápido de Streamlit en GitHub para configurar una demostración de la API Conversational Analytics en cuestión de minutos.
La demo de la API Conversational Analytics ya está disponible en GitHub. Con la demo de oro de la API Conversational Analytics, puedes ver ejemplos para integrar la API Conversational Analytics en aplicaciones web, así como una demo de producción completa en TypeScript. Este proyecto solo tiene fines de demostración. No se ha diseñado para usarse en un entorno de producción.
Arquitectura, flujos de trabajo y roles de la API Conversational Analytics: consulta más información sobre los conceptos clave para usar la API Conversational Analytics, como el funcionamiento de los agentes de datos, los flujos de trabajo típicos de los agentes de datos, los modos de conversación, los roles de gestión de identidades y accesos, y cómo diseñar sistemas que usen varios agentes de datos.
Limitaciones conocidas de la API Conversational Analytics: consulta más información sobre las limitaciones en el número de fuentes de datos, el estilo de las visualizaciones y el tamaño de los conjuntos de datos.
Solucionar problemas de la API Conversational Analytics: consulta más información sobre los posibles problemas o errores de la API Conversational Analytics, así como las soluciones propuestas.
Monitorizar y gestionar los costes de BigQuery de los agentes de la API Conversational Analytics: consulta más información sobre cómo implementar controles de costes para los agentes de la API Conversational Analytics.
Los métodos SetIAMPolicy y GetIAMPolicy están disponibles en la página de documentación Descripción general de la API Conversational Analytics para usarlos en agentes de datos compartidos.
Ya está disponible una nueva página de documentación con respuestas a preguntas frecuentes sobre la API Conversational Analytics.
Definir el contexto del agente de datos para las fuentes de datos de BigQuery: consulta más información sobre cómo escribir instrucciones del sistema para las fuentes de datos de BigQuery.
Definir el contexto del agente de datos para las fuentes de datos de Looker: consulta más información sobre cómo escribir instrucciones del sistema para las fuentes de datos de Looker.
15 de julio del 2025
Ahora puedes invitar a usuarios a colaborar en agentes de datos específicos asignándoles roles de gestión de identidades y accesos predefinidos. Para obtener más información, consulta el artículo sobre los roles y permisos de gestión de identidades y accesos de la API Conversational Analytics.
Una nueva guía de prácticas recomendadas te ayuda a proporcionar a tus agentes un contexto empresarial y de datos eficaz. Para obtener más información, consulta Dirigir el comportamiento de los agentes con contexto creado.
Actualizaciones del SDK:
Ahora puede instalar el SDK de Python desde el índice de paquetes de Python (PyPI).
25 de junio del 2025
Novedades de las APIs:
Los nuevos roles de gestión de identidades y accesos predefinidos controlan el acceso para crear, gestionar e interactuar con agentes de datos:
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
Para ver una lista completa de los roles y sus permisos, consulta el artículo Conceder roles y permisos de gestión de identidades y accesos de la API Conversational Analytics.
5 de junio del 2025
La versión preliminar privada inicial de la API Conversational Analytics introdujo funciones para crear agentes de datos e interactuar con ellos.
Para empezar a usar la API REST y el SDK de Python, puedes consultar los siguientes cuadernos interactivos de Colaboratory:
Novedades de las APIs:
El servicio de agente de datos te permite crear, configurar y gestionar de forma programática agentes de IA persistentes y contextuales con Looker, Looker Studio y BigQuery.
El Servicio de chat de datos te permite mantener conversaciones con tu agente usando varios modos de chat. Estos modos incluyen un modo con reconocimiento del estado en el que Google gestiona el historial de la conversación, una opción con reconocimiento del estado en la que tu aplicación gestiona la conversación y un modo sin reconocimiento del estado en el que tu aplicación proporciona el contexto completo con cada solicitud.
La API admite análisis avanzado con Python y vuelve a intentar automáticamente las consultas fallidas.
La API Conversational Analytics (geminidataanalytics.googleapis.com) sustituye a la API Data QnA (dataqna.googleapis.com), que ya no está disponible. Esto incluye la migración de DataQuestionService a la nueva DataChatService. Para obtener instrucciones detalladas sobre cómo actualizar tus solicitudes, consulta la guía de migración.