intégration de Copilot

L’extension PostgreSQL s’intègre aux assistants IA via trois surfaces : le participant de conversation @pgsql (Visual Studio Code uniquement), les outils en mode Agent et un fournisseur de serveur MCP PostgreSQL Tools. Cette page vous aide à choisir le bon point d’entrée et à comprendre la configuration partagée qui s’applique aux trois.

L’extension s’exécute à la fois dans Visual Studio Code (avec GitHub Copilot) et Cursor (avec son IA intégrée). La plupart des fonctionnalités fonctionnent de la même manière dans les deux éditeurs ; les quelques comportements propres à chaque éditeur sont signalés tout au long de cet article.

Prerequisites

Avant d’utiliser une fonctionnalité assistée par l’IA, vérifiez que les exigences suivantes sont remplies :

  • L’extension PostgreSQL est installée et vous disposez d’au moins une connexion de base de données configurée.
  • Un assistant IA est disponible dans votre éditeur :
    • Visual Studio Code : installez GitHub Copilot ou GitHub Copilot Conversation et connectez-vous avec un abonnement actif.
    • Curseur : aucune installation supplémentaire ; l’IA intégrée est utilisée automatiquement.

Note

Copilot fonctionnalités sont activées par défaut (pgsql.copilot.enable est true). Lorsque vous définissez ce paramètre sur false, le participant de chat @pgsql (Visual Studio Code uniquement), le sous-menu de l’éditeur Actions de requête IA, les outils du mode Agent et le fournisseur de serveur MCP sont tous masqués.

Tip

L’assistance IA fonctionne mieux lorsque vous avez déjà une connexion active à une base de données. Si vous n’avez pas encore connecté, commencez par Connexions et identité.

Choisir le point d’entrée approprié

Si vous souhaitez... Commencer ici Availability En savoir plus
Poser une question prenant en compte le schéma sur votre base de données @pgsql participant au chat Visual Studio Code uniquement participant à la discussion @pgsql
Démarrer le mode Agent avec une base de données spécifique déjà dans le contexte Connecter l’IA à partir d’un nœud de base de données dans l’arborescence Connexions Visual Studio Code et curseur Mode agent
Expliquer, réécrire ou analyser SQL à partir de l’éditeur Sous-menu Actions de requête AI dans le menu contextuel de l’éditeur Visual Studio Code et curseur Actions de l’éditeur
Automatiser une tâche de base de données en plusieurs étapes Connecter l’IA sur un nœud de base de données pour démarrer le mode Agent Visual Studio Code et curseur Mode agent
Exposer des outils PostgreSQL aux hôtes compatibles MCP Fournisseur de serveur MCP pour les outils PostgreSQL Visual Studio Code et curseur Serveur MCP

Utiliser @pgsql pour le chat sensible au schéma

Note

Le participant de conversation @pgsql est inscrit uniquement dans Visual Studio Code, où il se connecte à GitHub Copilot Chat. Dans Cursor, utilisez Connect AI à partir d’un nœud de base de données dans l’arborescence Connexions pour démarrer le mode Agent avec le même contexte de schéma, ou utilisez le serveur MCP dans l’aire de conversation native du curseur.

L’extension enregistre un participant de chat @pgsql (ID : vscode-postgresql.chat-agent) pour des conversations tenant compte du schéma dans GitHub Copilot Chat. Tapez @pgsql suivi de votre question, et le participant répond en utilisant le contexte du schéma en direct de votre base de données connectée.

Pour démarrer un flux de travail piloté par les outils avec une base de données déjà dans l’étendue, cliquez avec le bouton droit sur un nœud de base de données dans l’arborescence Connexions , puis sélectionnez Connecter l’IA.

Pour obtenir des conseils destinés aux utilisateurs finaux, des exemples de prompts et de l’aide au dépannage, rendez-vous sur participant de chat @pgsql.

Utiliser les actions de l’éditeur pour l’aide axée sur les requêtes

Lorsque sql est ouvert dans l’éditeur de requête, cliquez avec le bouton droit pour rechercher le sous-menu Actions de requête IA . Il contient les actions suivantes :

Action Description
Expliquer la requête Retourne une explication en langage brut de ce que fait la requête.
Réécrire la requête Suggère une autre version de la requête tout en préservant le résultat prévu.
Analyser les performances des requêtes S’exécute EXPLAIN ANALYZE sur la base de données connectée, puis envoie le plan d’exécution à l’IA à des fins d’analyse.

Vous pouvez également sélectionner Interroger l’IA à propos de cette requête dans la barre d’outils de l’éditeur pour ouvrir une conversation de chat basée sur le contenu actuel de l’éditeur.

Pour réinitialiser les choix mémorisés concernant l’inclusion des requêtes pour l’analyse de plan, exécutez Clear query inclusion preferences for AI analysis depuis la palette de commandes.

Utiliser le mode Agent pour les flux de travail pilotés par les outils

Le mode Agent permet à l’Assistant IA d’accéder aux outils PostgreSQL afin qu’il puisse se connecter, inspecter le schéma, exécuter des requêtes, ouvrir des scripts et effectuer des tâches en plusieurs étapes dans une conversation. Cliquez avec le bouton droit sur un nœud de base de données dans l’arborescence Connexions , puis sélectionnez Connecter l’IA pour démarrer une session en mode Agent.

Pour les familles d’outils, les exemples de flux de travail et la résolution des problèmes, passez au mode Agent.

Utiliser le serveur MCP dans les hôtes pris en charge

L’extension enregistre un PostgreSQL Tools MCP Server Provider (ID : pgsql-tools-mcp-server-provider) qui expose le même ensemble d’outils PostgreSQL via le Model Context Protocol. Les hôtes compatibles MCP peuvent découvrir et appeler ces outils sans utiliser les flux de travail de conversation intégrés.

Pour les hôtes pris en charge, le comportement de l’enregistrement automatique et les familles d’outils exposées via MCP, consultez Serveur MCP.

Configurer le mode d’accès

Le pgsql.copilot.accessMode paramètre contrôle la quantité d’accès à la base de données que l’Assistant IA reçoit dans le mode Agent et les outils MCP. La valeur par défaut est Lecture/écriture (rw).

Valeur de réglage Étiquette de l’interface utilisateur Ce que l’assistant IA peut faire
ro En lecture seule Opérations en lecture seule : SELECT, SHOW, EXPLAINinspection du schéma
rw Lecture/Écriture Lire les opérations ainsi que les instructions de modification des données et DDL, avec confirmation explicite

Surcharge par connexion

Vous pouvez également définir le mode d’accès sur des connexions individuelles. Dans la boîte de dialogue de connexion, développez la section Copilot (IA dans Cursor) et définissez mode d’accès à Copilot (mode d’accès à l’IA dans Cursor) sur l’un des modes suivants :

Option Comportement
Utiliser le paramètre global Revient à la valeur globale pgsql.copilot.accessMode (valeur par défaut)
En lecture seule Force l’accès en lecture seule pour cette connexion, quel que soit le paramètre global
Lecture/Écriture Force l’accès en lecture/écriture pour cette connexion, quel que soit le paramètre global

L’extension résout le mode d’accès effectif à l’aide de cette chaîne de repli : valeur propre à chaque connexion → paramètre global pgsql.copilot.accessMode → par défaut (rw).

Avertissement

Utilisez Read Only pour les bases de données de production, sauf si vous souhaitez intentionnellement que des modifications du schéma ou des données puissent être effectuées via l’assistant IA.

Configurer des paramètres supplémentaires

Réglage Qu’est-ce qu’il contrôle ? Default
pgsql.copilot.enable Active ou désactive toute intégration d’IA dans l’extension true
pgsql.copilot.accessMode Mode d’accès à l’IA global (lecture seule ou lecture/écriture) rw
pgsql.copilot.autoAttachQuery Indique si le texte de requête SQL est inclus lors de l’analyse des plans avec l’IA : Demander à chaque fois, Always Include ou Never Include ask
pgsql.copilot.modelOptions Réglage avancé des modèles (jetons max, température, top_p) pour les flux de travail IA de l’extension -

Les identifiants des paramètres conservent le préfixe pgsql.copilot.* dans les deux éditeurs pour des raisons de rétrocompatibilité, y compris lorsque les libellés visibles par l’utilisateur affichent « IA ».

Intégrations d’IA spécifiques aux fonctionnalités

Plusieurs fonctionnalités incluent des points d’intégration IA dédiés :

Fonctionnalité Fonctionnalité d’IA
Visualiseur de plan de requête Analysez les données du plan d’exécution avec Analyser avec Copilot (ou Analyser avec l’IA dans Cursor)
Tableau de bord du serveur Ouvrir des sessions de chat depuis les boutons Demander à Copilot (Demander à l’IA dans Cursor) dans les panneaux Requêtes, Attentes, Sessions et de graphiques de métriques
Visualiseur de schéma Visualiser les relations de schéma à partir d’un flux de travail en mode Agent

Contenu connexe

  • Last updated on