Ce document explique comment créer un agent de données dans AlloyDB 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 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 un cluster et une instance AlloyDB pour PostgreSQL
- Assurez-vous d'avoir accès à un cluster et à une instance AlloyDB existants, ou créez-en un.
- 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 Identity and Access Management (IAM) au cluster au niveau de la base de données. Pour en savoir plus, consultez Gérer les utilisateurs de la base de données.
- Attribuez le rôle
alloydb.databaseUserà l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Ajouter une association de stratégie IAM pour un projet.
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 AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur AlloyDB Studio.
Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).
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 AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur AlloyDB Studio.
Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).
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 AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur AlloyDB Studio.
Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).
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.