Gérer les agents de données dans Spanner Studio

Aperçu : 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.

**Remarque sur l'interface PostgreSQL** : Les exemples de cette rubrique concernent les bases de données utilisant le dialecte GoogleSQL. Cette fonctionnalité n'est pas compatible avec l'interface PostgreSQL.

Ce document explique comment créer un agent de données dans Spanner 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, respectez 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 Spanner

• Assurez-vous qu'une instance Spanner est disponible. Pour en savoir plus, consultez la page Créer une instance.
• Assurez-vous de créer une base de données dans votre instance dans laquelle vous créerez les tables. Pour en savoir plus, consultez la page Créer une base de données sur l' instance Spanner.

Rôles et autorisations requis

• Ajoutez un compte d'utilisateur ou de service IAM au cluster. Pour en savoir plus, consultez la page Appliquer des rôles IAM.
• Attribuez les rôles spanner.databaseReader à l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez la page Ajouter une liaison de stratégie IAM pour un projet.
• Accordez des rôles et des autorisations à l'utilisateur IAM au niveau du projet pour les bases de données requises.

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 Spanner.

   Accéder à Spanner

2. Sélectionnez une instance dans la liste, puis une base de données.

3. Dans le menu de navigation, cliquez sur Spanner Studio.

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

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

6. 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.

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

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

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

9. 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 Spanner.

   Accéder à Spanner

2. Sélectionnez une instance dans la liste, puis une base de données.

3. Dans le menu de navigation, cliquez sur Spanner Studio.

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

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

6. Facultatif : modifiez la description de l'agent.

7. Cliquez sur Browse (Parcourir) dans la section Upload agent context file (Importer un fichier de contexte d'agent), puis sélectionnez le fichier de contexte d'agent.

8. 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 Spanner.

   Accéder à Spanner

2. Sélectionnez une instance dans la liste, puis une base de données.

3. Dans le menu de navigation, cliquez sur Spanner Studio.

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

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

6. Dans la boîte de dialogue de confirmation Delete agent (Supprimer l'agent), saisissez le nom de l'agent.

7. Cliquez sur Confirm (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.