integración de Copilot

La extensión de PostgreSQL se integra con asistentes de IA a través de tres interfaces: el participante del chat @pgsql (solo disponible en Visual Studio Code), las herramientas del modo Agente y un proveedor de servidor MCP de herramientas de PostgreSQL. Esta página le ayuda a elegir el punto de entrada correcto y a comprender la configuración compartida que se aplica en los tres.

La extensión se ejecuta tanto en Visual Studio Code (con GitHub Copilot) como en cursor (con su IA integrada). La mayoría de las funciones funcionan de la misma manera en ambos editores; los pocos comportamientos específicos de cada editor se señalan a lo largo de este artículo.

Prerequisites

Antes de usar cualquier característica asistida por IA, asegúrese de que se cumplen los siguientes requisitos:

  • La extensión PostgreSQL está instalada y tiene configurada al menos una conexión de base de datos.
  • Un asistente de IA está disponible en el editor:
    • Visual Studio Code: instale GitHub Copilot o GitHub Copilot Chat e inicie sesión con una suscripción activa.
    • Cursor: sin instalación adicional; la inteligencia artificial integrada se usa automáticamente.

Nota:

Las características de Copilot están activadas de forma predeterminada (pgsql.copilot.enable es true). Al establecer este valor en false, se ocultan el participante de chat @pgsql (solo en Visual Studio Code), el submenú del editor AI Query Actions, las herramientas del modo Agente y el proveedor del servidor MCP.

Tip

La asistencia de IA funciona mejor cuando ya tiene una conexión de base de datos activa. Si aún no se ha conectado, comience con Conexiones e identidad.

Elegir el punto de entrada correcto

Si quieres... Comience aquí Disponibilidad Aprende más
Haz una pregunta basada en el esquema sobre tu base de datos @pgsql participante del chat solo Visual Studio Code participante del chat @pgsql
Iniciar el modo de agente con una base de datos específica ya seleccionada Conectar IA desde un nodo de base de datos en el árbol de Conexiones Visual Studio Code y Cursor Modo de agente
Explicar, reescribir o analizar SQL desde el editor Submenú Acciones de consulta de IA en el menú contextual del editor Visual Studio Code y Cursor Acciones del editor
Automatización de una tarea de base de datos de varios pasos Conexión de IA en un nodo de base de datos para iniciar el modo del agente Visual Studio Code y Cursor Modo de agente
Exposición de herramientas de PostgreSQL a hosts compatibles con MCP Proveedor de servidor MCP de herramientas de PostgreSQL Visual Studio Code y Cursor Servidor MCP

Usa @pgsql para chat compatible con esquemas

Nota:

El participante de chat de @pgsql solo se registra en Visual Studio Code, donde se conecta a GitHub Copilot Chat. En Cursor, usa Connect AI desde un nodo de base de datos en el árbol Connections para iniciar el modo Agente con el mismo contexto de esquema, o utiliza el servidor MCP en la interfaz de chat nativa de Cursor.

La extensión registra un participante de chat @pgsql (ID: vscode-postgresql.chat-agent) para conversaciones basadas en esquemas en GitHub Copilot Chat. Escriba @pgsql seguido de su pregunta, y el participante responde utilizando el contexto del esquema en tiempo real de su base de datos conectada.

Para iniciar un flujo de trabajo controlado por herramientas con una base de datos ya en el ámbito, haga clic con el botón derecho en un nodo de base de datos en el árbol Conexiones y seleccione Conectar IA.

Para obtener guía para el usuario final, indicaciones de ejemplo y ayuda para la resolución de problemas, continúe en @pgsql chat participant.

Usa acciones del editor para obtener ayuda orientada a consultas

Cuando tenga SQL abierto en el editor de consultas, haga clic con el botón derecho para buscar el submenú Acciones de consulta de IA . Contiene las siguientes acciones:

Acción Description
Explicar consulta Devuelve una explicación en lenguaje simple de lo que hace la consulta.
Reescritura de consulta Sugiere una versión alternativa de la consulta a la vez que conserva el resultado previsto.
Análisis del rendimiento de las consultas Se ejecuta EXPLAIN ANALYZE en la base de datos conectada y, a continuación, envía el plan de ejecución a la inteligencia artificial para su análisis.

También puede seleccionar Preguntar ia sobre esta consulta en la barra de herramientas del editor para abrir una conversación de chat con base en el contenido actual del editor.

Para restablecer las opciones de inclusión de consultas recordadas para el análisis del plan, ejecute Borrar preferencias de inclusión de consultas para el análisis de IA desde la paleta de comandos.

Uso del modo de agente para flujos de trabajo controlados por herramientas

El modo agente proporciona al asistente de IA acceso a las herramientas de PostgreSQL para que pueda conectarse, inspeccionar el esquema, ejecutar consultas, abrir scripts y trabajar en tareas de varios pasos en una conversación. Haga clic con el botón derecho en un nodo de base de datos en el árbol Conexiones y seleccione Conectar IA para iniciar una sesión de modo agente.

En el caso de las familias de herramientas, flujos de trabajo de ejemplo y solución de problemas, continúe con el modo agente.

Usa el servidor MCP en hosts compatibles

La extensión registra un proveedor de servidor MCP para las herramientas de PostgreSQL (ID: pgsql-tools-mcp-server-provider) que expone el mismo conjunto de herramientas de PostgreSQL a través de Model Context Protocol. Los hosts compatibles con MCP pueden detectar e invocar estas herramientas sin usar los flujos de trabajo de chat integrados.

Para consultar los hosts compatibles, el comportamiento de registro automático y las familias de herramientas expuestas a través de MCP, continúe en Servidor MCP.

Configurar el modo de acceso

La pgsql.copilot.accessMode configuración controla la cantidad de acceso a la base de datos que recibe el asistente de IA a través del modo agente y las herramientas de MCP. El valor predeterminado es Lectura y escritura (rw).

Valor de configuración Etiqueta de interfaz de usuario Qué puede hacer el asistente de IA
ro Solo lectura Operaciones de solo lectura: SELECT, SHOW, EXPLAIN, inspección del esquema
rw Lectura y escritura Operaciones de lectura más instrucciones de modificación de datos y DDL, con confirmación explícita

Anulación por conexión

También puede establecer el modo de acceso en conexiones individuales. En el cuadro de diálogo de conexión, expanda la sección Copilot (IA en Cursor) y configure Copilot access mode (AI access mode en Cursor) con una de las siguientes opciones:

Option Comportamiento
Usar la configuración global Vuelve al valor global pgsql.copilot.accessMode (valor predeterminado)
Solo lectura Fuerza el acceso de solo lectura para esta conexión, independientemente de la configuración global.
Lectura y escritura Fuerza el acceso de lectura/escritura para esta conexión, independientemente de la configuración global.

La extensión resuelve el modo de acceso efectivo mediante esta cadena de prioridad: valor por conexión → la configuración global pgsql.copilot.accessMode → valor predeterminado (rw).

Caution

Utilice Solo lectura en las bases de datos de producción, a menos que quiera permitir cambios en el esquema o en los datos a través del asistente de IA.

Configurar opciones adicionales

Configuración Qué controla Valor predeterminado
pgsql.copilot.enable Habilita o deshabilita toda la integración de IA en la extensión true
pgsql.copilot.accessMode Modo de acceso global a IA (Solo lectura o Lectura/escritura) rw
pgsql.copilot.autoAttachQuery Indica si el texto de la consulta SQL se incluye al analizar planes con IA: Preguntar cada vez, Incluir siempre o Nunca incluir ask
pgsql.copilot.modelOptions Optimización avanzada de modelos (tokens máximos, temperatura, top_p) para los flujos de trabajo de IA de la extensión -

Los identificadores de configuración mantienen el prefijo pgsql.copilot.* en ambos editores por compatibilidad con versiones anteriores, incluso cuando las etiquetas visibles para el usuario muestren "IA".

Integraciones de IA específicas para cada función

Varias características incluyen puntos de integración de IA dedicados:

Feature Capacidad de IA
Visualizador de planes de consulta Analiza los datos del plan de ejecución con Analyze with Copilot (o Analyze with AI en Cursor)
Panel del servidor Abra sesiones de chat desde los botones Pregunta a Copilot (Preguntar a la IA en Cursor) de los paneles Consultas, Esperas, Sesiones y gráficos de métricas
Visualizador de esquema Visualización de relaciones de esquema desde un flujo de trabajo del modo agente

Contenido relacionado

  • Last updated on