Ces notes de version concernent les mises à jour de l'API Conversational Analytics.
25 septembre 2025
Nouveautés concernant l'API Conversational Analytics :
Une nouvelle API, ListAccessibleDataAgents, est désormais disponible pour lister les agents de données accessibles à un utilisateur dans un projet. Un agent de données est considéré comme accessible si l'utilisateur qui appelle l'API dispose de l'autorisation get sur l'agent. Vous pouvez utiliser le champ creator_filter pour gérer les agents renvoyés par cette méthode :
NONE(par défaut) : renvoie tous les agents de données accessibles à l'utilisateur, quel que soit le créateur.CREATOR_ONLY: ne renvoie que les agents de données créés par l'utilisateur.NOT_CREATOR_ONLY: ne renvoie que les agents de données créés par d'autres utilisateurs.
L'énumération systemMessage.text.textType est désormais disponible avec les valeurs FINAL_RESPONSE et THOUGHT, ce qui aide les clients à distinguer les différents types de messages. L'API Conversational Analytics utilise désormais des messages systemMessage.text avec textType = THOUGHT pour générer des étapes de réflexion.
L'API est désormais compatible avec un maximum de cinq sources de données Looker Explore dans le contexte. Les demandes de chat génèrent des requêtes sur l'outil Explorer le plus pertinent. Pour en savoir plus, consultez la documentation sur la connexion aux données Looker avec HTTP et avec le SDK Python.
Le champ systemMessage.data.generatedLookerQuery est désormais systemMessage.data.query.looker.
25 août 2025
L'API Conversational Analytics est désormais disponible en version Preview publique.
Mises à jour des bibliothèques clientes :
Les bibliothèques clientes suivantes sont désormais disponibles dans plusieurs langages :
Nouveautés concernant l'API Conversational Analytics :
Les points de terminaison v1beta pour HTTP/REST sont désormais pris en charge.
Les méthodes d'API GetLocation et ListLocations sont désormais prises en charge par les API REST et le SDK.
Vous pouvez désormais partager des agents de données à l'aide des méthodes d'API GetIamPolicy et SetIamPolicy.
Vous pouvez désormais créer des agents de données à partir de sources de données Looker basées sur des instances Looker (Google Cloud Core) qui utilisent des réseaux IP privés. L'API Conversational Analytics n'est pas compatible avec les sources de données basées sur des instances Looker (Google Cloud Core) situées dans des périmètres de cloud privé virtuel.
Le contexte structuré pour les sources de données BigQuery est désormais disponible. Il permet d'ajouter des exemples de paires question/requête, des descriptions de tables, des synonymes et des tags au niveau des tables et des champs à l'aide de l'API.
Les API de localisation et d'opération sont désormais prises en charge. Les rôles IAM DataAgentCreator et DataAgentEditor disposeront désormais d'autorisations pour les API d'opération.
Nous avons amélioré le stockage automatique de Last Published Context dans la couche serveur chaque fois que le contexte publié d'un agent de données est mis à jour.
Les noms à afficher des rôles Identity and Access Management ont été remplacés par "Utilisateur sans état du chat des analyses de données Gemini" et "Créateur d'agent de données des analyses de données Gemini". Pour en savoir plus sur les rôles Identity and Access Management utilisés avec l'API, consultez la page de documentation Accorder des rôles et des autorisations Identity and Access Management pour l'API Conversational Analytics.
La version 1.1 de Colaboratory est désormais disponible.
Des modifications ont été apportées à la gestion des exceptions pour traiter les erreurs internes 500 liées aux conversations pour le chat avec état.
De meilleurs messages de gestion des exceptions ont été implémentés pour les erreurs client 400.
Mise à jour de la documentation :
Vous pouvez désormais utiliser la nouvelle application de démarrage rapide Streamlit sur GitHub pour configurer une démo de l'API Conversational Analytics en quelques minutes.
La démo Golden de l'API Conversational Analytics est désormais disponible sur GitHub. La démo Golden de l'API Conversational Analytics vous permet de consulter des exemples d'intégration de l'API Conversational Analytics dans des applications Web, ainsi qu'une démo de production complète en TypeScript. Ce projet est fourni à des fins de démonstration uniquement. Il n'est pas destiné à être utilisé dans un environnement de production.
Architecture, workflows et rôles de l'API Conversational Analytics : découvrez les concepts clés pour utiliser l'API Conversational Analytics, y compris le fonctionnement des agents de données, les workflows typiques des agents de données, les modes de conversation, les rôles Identity and Access Management et la conception de systèmes utilisant plusieurs agents de données.
Limites connues de l'API Conversational Analytics : découvrez les limites concernant le nombre de sources de données, le style des visualisations et la taille des ensembles de données.
Résoudre les problèmes liés à l'API Conversational Analytics : découvrez les problèmes ou erreurs potentiels liés à l'API Conversational Analytics, ainsi que les solutions proposées.
Surveiller et gérer les coûts BigQuery de vos agents de l'API Conversational Analytics : découvrez comment mettre en place des contrôles des coûts pour vos agents de l'API Conversational Analytics.
Les méthodes SetIAMPolicy et GetIAMPolicy sont disponibles sur la page de documentation Présentation de l'API Conversational Analytics pour partager des agents de données.
Une nouvelle page de documentation contenant des réponses aux questions fréquentes sur l'API Conversational Analytics est désormais disponible.
Définir le contexte de l'agent de données pour les sources de données BigQuery : découvrez comment rédiger des instructions système pour les sources de données BigQuery.
Définir le contexte de l'agent de données pour les sources de données Looker : découvrez comment rédiger des instructions système pour les sources de données Looker.
15 juillet 2025
Vous pouvez désormais inviter des utilisateurs à collaborer sur des agents de données spécifiques en leur attribuant des rôles IAM prédéfinis. Pour en savoir plus, consultez Rôles et autorisations IAM pour l'API Conversational Analytics.
Un nouveau guide des bonnes pratiques vous aide à fournir à vos agents un contexte métier et de données efficace. Pour en savoir plus, consultez Guider le comportement de l'agent avec un contexte créé.
Mises à jour du SDK :
Vous pouvez désormais installer le SDK Python à partir de l'index de packages Python (PyPI).
25 juin 2025
Mises à jour de l'API :
De nouveaux rôles IAM prédéfinis contrôlent l'accès pour créer et gérer des agents de données, ainsi que pour interagir avec eux :
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
Pour obtenir la liste complète des rôles et de leurs autorisations, consultez Accorder des rôles et des autorisations IAM pour l'API Conversational Analytics.
5 juin 2025
La version Preview privée initiale de l'API Conversational Analytics a introduit des fonctionnalités permettant de créer des agents de données et d'interagir avec eux.
Les notebooks Colaboratory interactifs suivants sont disponibles pour vous aider à vous lancer avec REST et le SDK Python :
Mises à jour de l'API :
Le service d'agent de données vous permet de créer, de configurer et de gérer de manière programmatique des agents IA persistants et contextuels avec Looker, Looker Studio et BigQuery.
Le service de chat de données vous permet d'échanger avec votre agent à l'aide de plusieurs modes de chat. Ces modes incluent un mode avec état dans lequel Google gère l'historique des conversations, une option avec état dans laquelle votre application gère la conversation et un mode sans état dans lequel votre application fournit le contexte complet à chaque requête.
L'API est compatible avec l'analyse avancée à l'aide de Python et relance automatiquement les requêtes ayant échoué.
L'API Conversational Analytics (geminidataanalytics.googleapis.com) remplace l'API Data QnA (dataqna.googleapis.com), laquelle est obsolète. Cela inclut la migration de DataQuestionService vers le nouveau DataChatService. Pour obtenir des instructions détaillées sur la mise à jour de vos requêtes, consultez le guide de migration.