Le Toolkit Google Cloud Platform (GCP) permet à votre agent d’interagir avec BigQuery, Cloud Run (services et fonctions déclenchées par HTTP) et Cloud SQL. L’authentification est gérée via une clé JSON de compte de service stockée en tant que connexion — l’agent agit en tant que compte de service et hérite de ses rôles IAM.
Prérequis
Avant de configurer le toolkit GCP, vous devez disposer d’une connexion Google Cloud active. Si vous ne l’avez pas encore configurée, allez dans Paramètres → Connexions pour en créer une.
Les connexions sont gérées de manière centralisée dans Paramètres → Connexions. La clé JSON du compte de service est stockée de manière chiffrée ; seul le client_email et le projet sont exposés aux agents.
- Ouvrez votre agent et allez dans Toolkits.
- Trouvez Google Cloud Platform et cliquez sur Ajouter à l’agent.
- Cliquez sur Configurer pour ouvrir le panneau de configuration.
Configuration
Connexion
Utilisez le menu déroulant Sélectionner une connexion GCP pour choisir la connexion du compte de service que l’agent utilisera. Pour gérer ou créer des connexions, cliquez sur Gérer les connexions en haut à droite.
À propos de l’intégration Google Cloud
Gardez les éléments suivants à l’esprit lors de la configuration du toolkit :
- L’agent hérite des rôles IAM du compte de service — n’accordez que les rôles requis (par exemple,
BigQuery Data Viewer, Cloud Run Invoker, Cloud SQL Client).
- L’invocation de Cloud Run / Cloud Functions utilise des jetons ID OIDC signés par le compte de service — restreignez
roles/run.Invoker au compte de service lorsque les services sont privés.
- Seuls les outils que vous activez ci-dessous seront disponibles pour l’agent.
Sélection des outils
Utilisez Tout sélectionner ou Tout désélectionner pour gérer les outils en bloc, ou activez-les individuellement. Vous pouvez également activer Demander confirmation pour chaque outil afin d’inviter l’utilisateur à confirmer avant que l’agent n’exécute cette action.
Il y a 13 outils disponibles répartis en quatre catégories.
BigQuery
| Outil | Description |
|---|
| Lister les jeux de données | Liste les jeux de données BigQuery accessibles par le compte de service connecté. |
| Lister les tables | Liste les tables d’un jeu de données BigQuery. |
| Obtenir le schéma de table | Inspecte les noms de colonnes, les types, les descriptions et les métadonnées de la table. |
| Exécuter une requête | Exécute une requête SQL sur BigQuery avec exécution test (dry-run) optionnelle, paramètres et limite de lignes. |
| Insérer des lignes | Insère des lignes en streaming dans une table BigQuery à l’aide de l’API d’insertion en streaming. |
Cloud Run
| Outil | Description |
|---|
| Lister les services | Liste les services Cloud Run (Gen 2) dans une région. |
| Obtenir un service | Récupère la définition d’un service Cloud Run, y compris son URL et son image. |
| Invoquer un service | Invoque un point de terminaison HTTP d’un service Cloud Run avec un jeton ID OIDC signé par le compte de service. |
| Invoquer une fonction | Invoque une fonction Cloud Run / Cloud Functions Gen 2 déclenchée par HTTP avec un jeton ID OIDC. |
Cloud SQL
| Outil | Description |
|---|
| Lister les instances | Liste les instances Cloud SQL (Postgres, MySQL, SQL Server) dans un projet. |
| Obtenir une instance | Récupère les métadonnées d’une instance Cloud SQL spécifique (moteur, IPs, version). |
| Exécuter une requête | Exécute une requête SQL sur une instance Cloud SQL via le connecteur Python. |
Générique
| Outil | Description |
|---|
| Appel API personnalisé | Effectue une requête authentifiée vers n’importe quelle API REST Google Cloud. Utilisez cet outil lorsqu’il n’existe pas d’outil dédié pour l’opération dont vous avez besoin. |
Enregistrement de votre configuration
Cliquez sur Enregistrer pour appliquer votre configuration, ou sur Définir par défaut pour rendre cette configuration la configuration par défaut des nouveaux agents. Pour supprimer le toolkit de l’agent, cliquez sur Supprimer le toolkit. 
