> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toolkit Google Cloud Platform

> Connectez votre agent à BigQuery, Cloud Run et Cloud SQL à l'aide d'une connexion par compte de service.

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.

<Info>
  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.
</Info>

## Ajout du toolkit à un agent

1. Ouvrez votre agent et allez dans **Toolkits**.
2. Trouvez **Google Cloud Platform** et cliquez sur **Ajouter à l'agent**.
3. 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**.
