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 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 :
Préparer une instance Spanner
- Assurez-vous qu'une instance Spanner est disponible. Pour en savoir plus, consultez Créer une instance.
- Remplissez la base de données avec les données et le schéma auxquels l'utilisateur final souhaite accéder.
Rôles et autorisations nécessaires
- Ajoutez un compte d'utilisateur ou de service IAM au cluster. Pour en savoir plus, consultez Appliquer des rôles IAM.
- Attribuez les rôles
spanner.databaseReaderà l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Ajouter une liaison de stratégie IAM pour un projet. - Attribuez 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 :
Dans la console Google Cloud , accédez à la page Spanner.
Sélectionnez une instance dans la liste, puis sélectionnez une base de données.
Dans le menu de navigation, cliquez sur Spanner Studio.
Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.
Cliquez sur Create agent (Créer un agent).
Dans 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.
Facultatif. Dans Description de l'agent, ajoutez une description pour votre agent.
Facultatif. Cliquez sur Afficher les options avancées, puis sélectionnez une région pour stocker le contexte de l'agent dans Sélectionner un emplacement.
Cliquez sur Créer.
Créer le contexte de l'agent
Après avoir créé un agent, suivez les étapes décrites dans Créer des contextes à l'aide de la Gemini CLI 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 :
Dans la console Google Cloud , accédez à la page Spanner.
Sélectionnez une instance dans la liste, puis sélectionnez une base de données.
Dans le menu de navigation, cliquez sur Spanner Studio.
Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.
Cliquez sur Modifier l'agent.
Facultatif : Modifiez la description de l'agent.
Cliquez sur Parcourir dans la section Importer le fichier de contexte de l'agent, puis sélectionnez le fichier de contexte de l'agent.
Cliquez sur Enregistrer.
Supprimer un agent de données
Pour supprimer un agent de données, procédez comme suit :
Dans la console Google Cloud , accédez à la page Spanner.
Sélectionnez une instance dans la liste, puis sélectionnez une base de données.
Dans le menu de navigation, cliquez sur Spanner Studio.
Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.
Cliquez sur Supprimer l'agent.
Dans la boîte de dialogue de confirmation Supprimer l'agent, saisissez le nom de l'agent.
Cliquez sur Confirmer pour supprimer l'agent.
Étapes suivantes
- En savoir plus sur les agents de données
- Découvrez comment inspecter et appeler un agent de données.