Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le mode Agent permet à l’Assistant IA dans votre éditeur d’utiliser les outils PostgreSQL de l’extension dans le cadre d’une conversation multi-étape unique. Au lieu de répondre uniquement à une question, l’Assistant peut se connecter à une base de données, inspecter un schéma, exécuter des requêtes, ouvrir des scripts et vous aider à passer par un flux de travail de bout en bout.
Le mode agent s’exécute à la fois dans Visual Studio Code (avec GitHub Copilot) et cursor (avec son IA intégrée). L’extension expose la même surface d’outil PostgreSQL dans les deux éditeurs ; seul le panneau de conversation qui s’ouvre diffère.
Utilisez le mode Agent lorsque vous souhaitez que l’IA effectue des actions structurées, pas seulement pour expliquer ou rédiger du SQL.
Prerequisites
Avant de commencer, vérifiez que vous disposez des éléments suivants :
- Extension PostgreSQL installée.
- fonctionnalités Copilot/IA activées dans l’extension (
pgsql.copilot.enableesttrue). - Au moins une connexion de base de données configurée dans l’extension.
- Assistant IA disponible dans votre éditeur :
- Visual Studio Code : GitHub Copilot ou GitHub Copilot Chat installé et actif.
- Curseur : aucune installation supplémentaire ; l’IA intégrée est utilisée automatiquement.
Démarrer le mode Agent
- Connectez-vous au serveur ou à la base de données cible dans l’extension PostgreSQL.
- Dans l’arborescence Connexions , cliquez avec le bouton droit sur la base de données que vous souhaitez utiliser.
- Sélectionnez Connecter l’IA.
- Poursuivez la conversation dans le panneau de conversation qui s’ouvre avec le flux de travail que vous souhaitez terminer.
- Dans Visual Studio Code, il s’agit du panneau Copilot Chat GitHub en mode Agent.
- Dans Cursor, il s’agit du panneau d’IA natif de Cursor ; l’extension fournit un bref préambule axé sur MCP afin que l’assistant connaisse les outils PostgreSQL disponibles.
Une fois la session démarrée, l’IA peut combiner les outils PostgreSQL en arrière-plan pendant qu’elle traite votre demande.
Choisir le mode d’accès approprié
Le paramètre pgsql.copilot.accessMode contrôle le niveau d’accès à la base de données accordé au mode Agent. L’ID du paramètre conserve son préfixe pgsql.copilot.* pour des raisons de compatibilité ; le libellé visible par l’utilisateur est Mode d’accès Copilot dans Visual Studio Code et Mode d’accès IA dans Cursor.
| Mode | Ce que l’IA peut faire | Utilisation recommandée |
|---|---|---|
ro |
Opérations en lecture seule telles que SELECT, , SHOWEXPLAIN, inspection de schéma et analyse |
Systèmes de production ou environnements partagés où vous souhaitez examiner sans modification |
rw |
Lire les opérations ainsi que les instructions de modification des données et DDL, avec confirmation explicite avant l’exécution | Développement local, bacs à sable jetables et environnements de test contrôlés |
Avertissement
Utilisez ro le mode pour les bases de données de production, sauf si vous souhaitez intentionnellement que des modifications de schéma ou de données soient disponibles via le mode Agent.
Comprendre les familles d’outils
Le mode Agent peut utiliser plusieurs familles d’outils en fonction du flux de travail.
| Famille d’outils | Qu’est-ce que cela fait ? | Quand vous l’utilisez |
|---|---|---|
| Outils de connexion | Profils de liste, connexion, déconnexion, bases de données de liste | Démarrer ou changer de contexte |
| Outils de contexte du schéma | Récupérer des définitions d’objets ou visualiser un schéma | Comprendre les tables, les vues, les fonctions, les index et les relations |
| Outils de requête | Exécuter des requêtes en lecture, inspecter des plans de requête, ouvrir des scripts | Examiner les données, valider des idées ou passer en revue SQL généré |
| Outils de modification | Exécuter DDL ou DML avec confirmation | Appliquer des modifications de schéma ou de données contrôlées en rw mode |
| Outils d’importation de données | Décrire les fichiers CSV et les charger en bloc | Planifier et exécuter des flux de travail d’importation CSV |
Tip
Dans Cursor, les mêmes outils sont aussi accessibles via l’enregistrement du serveur MCP. Le chat natif de Cursor peut les invoquer directement sans utiliser le point d’entrée Connect AI. Pour plus d’informations, consultez le serveur MCP .
Utiliser le mode Agent pour les flux de travail courants
Les exemples suivants montrent comment utiliser le mode Agent pour les tâches qui vont de l’exploration d’une nouvelle base de données à l’affinement des requêtes.
Explorer une base de données inconnue
Demandez à l’IA de se connecter à la base de données, de répertorier les objets clés et de résumer les zones de schéma qui comptent pour votre tâche.
Exemple :
Connectez-vous à ma base de données de développement, listez les tables du schéma public et dites-moi celles qui semblent liées aux clients et aux commandes.
Analyser les performances des requêtes
Demandez à l’IA de combiner le contexte de schéma avec l’exécution des requêtes ou l’inspection du plan.
Exemple :
Connectez-vous à la base de données intermédiaire, exécutez cette requête en mode lecture seule et expliquez quelle partie du plan d’exécution entraîne le coût.
Charger ou remodeler des données
Utilisez le mode Agent lorsque le flux de travail inclut des scripts ou des opérations basées sur CSV.
Exemple :
Passez en revue ce fichier CSV, dites-moi quel schéma implique et préparez un plan d’importation sécurisé pour la
sales.recordstable.
Passer d’un brouillon à un examen manuel
Lorsque vous souhaitez qu’un point de contrôle de révision humain soit effectué avant l’exécution, demandez à l’IA d’ouvrir le sql généré dans l’éditeur de requête au lieu de l’exécuter immédiatement.
Savoir quand utiliser le mode Agent au lieu de @pgsql
Utilisez @pgsql participant de conversation lorsque vous souhaitez obtenir une réponse prenant en compte le schéma ou un brouillon de requête. Le participant @pgsql n’est disponible que dans Visual Studio Code.
Utilisez le mode Agent (disponible à la fois dans Visual Studio Code et le curseur) lorsque vous souhaitez que l’IA :
- se connecter à la base de données appropriée pour vous,
- chaîner plusieurs outils dans une conversation,
- inspecter les résultats avant l’étape suivante, ou
- préparer un script ou un flux de travail de modification contrôlé.
Note
Dans Curseur, le mode Agent est le chemin principal, car le @pgsql participant de conversation n’y est pas disponible. La même interface d’outils est également accessible depuis le chat natif de Cursor via le serveur MCP.
Résoudre les problèmes liés au mode Agent
Si le mode Agent ne se comporte pas comme prévu, vérifiez d’abord le mode d’accès et la disponibilité des outils.
L’IA ne peut pas modifier la base de données
Vérifiez pgsql.copilot.accessMode et confirmez que la connexion active n’est pas résolue vers ro.
L’outil attendu n’est pas disponible
Vérifiez que l’intégration de Copilot est activée et que vous êtes parti d’une base de données disposant d’un contexte de connexion PostgreSQL valide.
Une demande de connexion échoue
Vérifiez que le profil de connexion existe toujours, les informations d’identification sont disponibles et l’extension peut se connecter à la même base de données en dehors du mode Agent.
Je veux un flux de travail plus simple, axé sur le chat
Dans Visual Studio Code, utilisez @pgsql participant de conversation lorsque vous souhaitez obtenir des explications, rédiger des requêtes ou poser des questions de schéma sans automatisation pilotée par les outils. Dans Cursor, posez les mêmes types de questions à partir de la conversation native. Les outils MCP de l’extension sont toujours détectables, mais la conversation se comporte plus conversationnellement sans entrée explicite en mode Agent.