Gérer les agents de données dans Cloud SQL Studio pour PostgreSQL

MySQL   |  PostgreSQL   |  SQL Server

Preview : Agents de données

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service, et aux Conditions supplémentaires pour les produits d'IA générative en version preview. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Pour plus d'informations sur l'accès à cette version, consultez la page de demande d'accès.

Ce document explique comment créer un agent de données dans Cloud SQL pour PostgreSQL Studio à l'aide d'un fichier de contexte d'agent. Un agent de données est associé à un seul fichier de contexte d'agent.

Pour en savoir plus sur les agents de données, consultez la présentation des agents de données.

Avant de commencer

Avant de créer un agent, remplissez les conditions préalables suivantes.

Activer les services requis

Activez les services suivants pour votre projet :

• API Gemini Data Analytics
• API Gemini pour Google Cloud

Préparer une instance Cloud SQL

Assurez-vous d'avoir accès à une instance Cloud SQL existante ou créez-en une. Pour en savoir plus, consultez Créer des instances pour Cloud SQL.

Rôles et autorisations requis

• Ajoutez un compte d'utilisateur ou de service IAM à l'instance. Pour en savoir plus, consultez Gérer les utilisateurs avec l'authentification IAM pour les bases de données Cloud SQL.
• Attribuez les rôles cloudsql.studioUser et cloudsql.instanceUser à l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Ajouter une liaison de stratégie IAM pour un projet.
• Vous devez également accorder des droits sur une base de données à un utilisateur ou à un compte de service IAM en vous connectant en tant qu'utilisateur postgres.
  
  GRANT ALL ON SCHEMA public TO public;.
  
  Pour en savoir plus, consultez Accorder des droits sur une base de données à un utilisateur ou un compte de service IAM individuel.

Accorder l'autorisation executesql à l'instance Cloud SQL

Pour accorder l'autorisation executesql à l'instance Cloud SQL et activer l'API Cloud SQL Data, exécutez la commande suivante :

gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

Remplacez INSTANCE_ID par l'ID de votre instance Cloud SQL.

Pour suivre les étapes de ce tutoriel, connectez-vous à Google Cloud, puis authentifiez-vous auprès de la base de données à l'aide de l'authentification IAM.

Créer un agent de données

Pour créer un agent de données, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Cloud SQL.

   Accéder à Cloud SQL

2. Sélectionnez une instance dans la liste.

3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.

4. Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).

5. Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.

6. Cliquez sur Create agent (Créer un agent).

7. Dans Agent name (Nom de l'agent), indiquez un nom d'agent unique. Le nom de l'agent est sensible à la casse et peut contenir des lettres, des chiffres, des traits d'union et des traits de soulignement.

8. Facultatif. Dans Agent description (Description de l'agent), ajoutez une description pour votre agent.

9. Facultatif. Cliquez sur Show Advanced Options (Afficher les options avancées), puis, dans Select a location (Sélectionner un emplacement), sélectionnez une région pour stocker le contexte de l'agent. Vous pouvez choisir parmi la liste suivante de régions compatibles :

   • us-central1
   • us-east1
   • europe-west4
   • asia-southeast1

10. Cliquez sur Créer.

Remarque : La création du premier agent dans un projet peut prendre plusieurs minutes.

Créer un contexte d'agent

Après avoir créé un agent, suivez les étapes décrites dans Créer des contextes à l'aide de l'interface de ligne de commande Gemini pour créer un fichier de contexte d'agent. Vous pouvez ensuite modifier votre agent pour importer le fichier de contexte.

Modifier un agent

Pour modifier un agent de données, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Cloud SQL.

   Accéder à Cloud SQL

2. Sélectionnez une instance dans la liste.

3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.

4. Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).

5. Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.

6. Cliquez sur Edit agent (Modifier l'agent).

7. Facultatif : Modifiez la description de l'agent.

8. Cliquez sur Parcourir dans la section Importer un fichier de contexte d'agent, puis sélectionnez le fichier de contexte d'agent.

9. Cliquez sur Enregistrer.

Supprimer un agent de données

Pour supprimer un agent de données, procédez comme suit :

1. Dans la Google Cloud console, accédez à la page Cloud SQL.

   Accéder à Cloud SQL

2. Sélectionnez une instance dans la liste.

3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.

4. Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).

5. Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.

6. Cliquez sur Delete agent (Supprimer l'agent).

7. Dans la boîte de dialogue de confirmation Supprimer l'agent, saisissez le nom de l'agent.

8. Cliquez sur Confirmer pour supprimer l'agent.

Remarque : Avant de supprimer une base de données, vous devez supprimer tous les agents associés à cette base de données.

Étape suivante

• En savoir plus sur les agents de données.
• Découvrez comment inspecter et appeler un agent de données.