Estas notas de la versión corresponden a las actualizaciones de la API de Conversational Analytics.
25 de agosto de 2025
La API de Conversational Analytics ya está disponible en versión preliminar pública.
Actualizaciones de la biblioteca cliente:
Las siguientes bibliotecas cliente ahora están disponibles en varios lenguajes:
Actualizaciones de la API de Conversational Analytics:
Ya está disponible la compatibilidad con los extremos de v1beta para HTTP REST.
Se agregó compatibilidad con los métodos de API GetLocation y ListLocations a las APIs de REST y al SDK.
Ahora puedes compartir agentes de datos con los métodos de API GetIamPolicy y SetIamPolicy.
Ahora puedes crear agentes de datos a partir de fuentes de datos de Looker que se basan en instancias de Looker (Google Cloud Core) que usan redes de IP privadas. (La API de Conversational Analytics no admite fuentes de datos basadas en instancias de Looker (Google Cloud Core) que se encuentran dentro de perímetros de la nube privada virtual).
Ya está disponible el contexto estructurado para las fuentes de datos de BigQuery. Esto incluye la capacidad de agregar pares de preguntas o búsquedas de ejemplo, descripciones de tablas, sinónimos y etiquetas a nivel de la tabla y el campo con la API.
Ahora se admiten las APIs de ubicación y operación. Las funciones de Identity and Access Management DataAgentCreator y DataAgentEditor ahora tendrán permisos para las APIs de operación.
Se realizó una mejora para 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.
Se actualizaron los nombres visibles de los roles de Identity and Access Management a "Usuario sin estado del chat de análisis de datos de Gemini" y "Creador del agente de datos de análisis de datos de Gemini". Para obtener más información sobre los roles de Identity and Access Management que se usan con la API de Conversational Analytics, consulta la página de documentación Otorga roles y permisos de Identity and Access Management de la API de Conversational Analytics.
Ya está disponible la versión 1.1 de Colaboratory.
Se realizaron actualizaciones en el manejo de errores para controlar los errores internos 500 relacionados con la conversación en el chat con estado.
Se implementaron mejores mensajes de control de excepciones para los errores del 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 de Conversational Analytics en cuestión de minutos.
La demostración de oro de la API de Conversational Analytics ya está disponible en GitHub. Con la demostración de oro de la API de Conversational Analytics, puedes ver ejemplos para integrar la API de Conversational Analytics en aplicaciones web, así como una demostración completa de producción en TypeScript. Este proyecto se creó solo con fines de demostración. No está diseñado para usarse en un entorno de producción.
Se agregaron muestras de código de cargas útiles de solicitudes para las APIs de REST y el SDK.
Arquitectura, flujos de trabajo y roles de la API de Conversational Analytics: Obtén más información sobre los conceptos clave para usar la API de Conversational Analytics, incluido cómo funcionan los agentes de datos, los flujos de trabajo típicos de los agentes de datos, los modos de conversación, los roles de Identity and Access Management y cómo diseñar sistemas que usan varios agentes de datos.
Limitaciones conocidas de la API de Conversational Analytics: Obtén más información sobre las limitaciones en la cantidad de fuentes de datos, el estilo de las visualizaciones y el tamaño de los conjuntos de datos.
Soluciona problemas de errores de la API de Conversational Analytics: Obtén más información sobre los posibles problemas o errores con la API de Conversational Analytics, así como las soluciones propuestas.
Supervisa y administra los costos de BigQuery para tus agentes de la API de Conversational Analytics: Obtén más información para implementar controles de costos para tus agentes de la API de Conversational Analytics.
Los métodos SetIAMPolicy y GetIAMPolicy están disponibles en la página de documentación de la descripción general de la API de Conversational Analytics para usarse en agentes de datos compartidos.
Ya está disponible una nueva página de documentación que contiene respuestas a las preguntas frecuentes sobre la API de Conversational Analytics.
Guía el comportamiento del agente con contexto creado para las fuentes de datos de BigQuery: Obtén más información para escribir instrucciones del sistema para las fuentes de datos de BigQuery.
Guía el comportamiento del agente con contexto creado para las fuentes de datos de Looker: Obtén más información para escribir instrucciones del sistema para las fuentes de datos de Looker.
15 de julio de 2025
Ahora puedes invitar a usuarios a colaborar en agentes de datos específicos asignándoles roles de IAM predefinidos. Para obtener más detalles, consulta Permisos y roles de IAM de la API de Conversational Analytics.
Una nueva guía de prácticas recomendadas te ayuda a proporcionar un contexto comercial y de datos eficaz a tus agentes. Para obtener más información, consulta Cómo guiar el comportamiento del agente con contexto creado.
Actualizaciones del SDK:
Ahora puedes instalar el SDK de Python desde el índice de paquetes de Python (PyPI).
25 de junio de 2025
Actualizaciones de la API:
Los nuevos roles predefinidos de IAM controlan el acceso para crear y administrar agentes de datos, y para interactuar con ellos:
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
Para obtener una lista completa de los roles y sus permisos, consulta Cómo otorgar roles y permisos de IAM de la API de Conversational Analytics.
5 de junio de 2025
La versión preliminar privada inicial de la API de Conversational Analytics introdujo funciones para crear agentes de datos y para interactuar con ellos.
Los siguientes notebooks interactivos de Colaboratory están disponibles para comenzar a usar la API de REST y el SDK de Python:
Actualizaciones de la API:
El Servicio de agentes de datos te permite crear, configurar y administrar de forma programática agentes de IA persistentes y sensibles al contexto con Looker, Looker Studio y BigQuery.
El servicio de Data Chat te permite participar en conversaciones con tu agente usando varios modos de chat. Estos modos incluyen un modo con estado en el que Google administra el historial de conversaciones, una opción con estado en la que tu aplicación administra la conversación y un modo sin estado en el que tu aplicación proporciona el contexto completo con cada solicitud.
La API admite el análisis avanzado con Python y reintenta automáticamente las consultas con errores.
La API de Conversational Analytics (geminidataanalytics.googleapis.com) reemplaza a la API de Data QnA (dataqna.googleapis.com), que dejó de estar disponible. Esto incluye la migración de DataQuestionService al nuevo DataChatService. Para obtener instrucciones detalladas sobre cómo actualizar tus solicitudes, consulta la guía de migración.