Integração com Copilot

A extensão PostgreSQL integra-se com assistentes de IA através de três interfaces: o participante de chat @pgsql (apenas no Visual Studio Code), ferramentas do modo Agente e um Fornecedor de servidor MCP das Ferramentas PostgreSQL. Esta página ajuda-o a escolher o ponto de entrada certo e a compreender a configuração partilhada que se aplica a todos os três.

A extensão corre tanto no Visual Studio Code (com GitHub Copilot) como no Cursor (com a sua IA incorporada). A maioria das funcionalidades funciona da mesma forma em ambos os editores; O pequeno número de comportamentos específicos dos editores é destacado ao longo deste artigo.

Pré-requisitos

Antes de usar qualquer funcionalidade assistida por IA, certifique-se de que os seguintes requisitos são cumpridos:

  • A extensão PostgreSQL está instalada e tem pelo menos uma ligação à base de dados configurada.
  • Um assistente de IA está disponível no seu editor:
    • Visual Studio Code: instala o GitHub Copilot ou o GitHub Copilot Chat e inicia sessão com uma subscrição ativa.
    • Cursor: sem instalação extra; a IA incorporada é usada automaticamente.

Note

As funcionalidades do Copilot estão ativadas por defeito (pgsql.copilot.enable é true). Quando definir isto como false, o participante de chat @pgsql (apenas no Visual Studio Code), o submenu do editor Ações de Consulta de IA, as ferramentas do modo de Agente e o fornecedor de servidor MCP ficam ocultos.

Sugestão

A assistência de IA funciona melhor quando já tem uma ligação ativa à base de dados. Se ainda não te ligaste, começa por Ligações e Identidade.

Escolha o ponto de entrada certo

Se você quiser... Comece aqui Availability Mais informações
Faça uma pergunta com conhecimento do esquema da sua base de dados @pgsql participante do chat Apenas Visual Studio Code @pgsql participante do chat
Iniciar o modo Agente com uma base de dados específica já dentro do âmbito Ligar a IA a partir de um nó da base de dados na árvore Connections Visual Studio Code e Cursor Modo agente
Explique, reescreva ou analise SQL a partir do editor submenu Ações de Consulta de IA no menu contextual do editor Visual Studio Code e Cursor Ações do editor
Automatizar uma tarefa de base de dados em vários passos Liga IA num nó de base de dados para iniciar o modo Agente Visual Studio Code e Cursor Modo agente
Expor ferramentas PostgreSQL a hosts compatíveis com MCP Fornecedor do servidor MCP para ferramentas do PostgreSQL Visual Studio Code e Cursor Servidor MCP

Utilize @pgsql para chat com reconhecimento de esquemas

Note

O participante do chat @pgsql está registado apenas no Visual Studio Code, onde se liga ao GitHub Copilot Chat. No Cursor, utilize Connect AI a partir de um nó da base de dados na árvore de Connections para iniciar o modo Agente com o mesmo contexto do esquema, ou recorra ao servidor MCP na interface de chat nativa do Cursor.

A extensão regista um participante de chat @pgsql (ID: vscode-postgresql.chat-agent) para conversas com reconhecimento do esquema no GitHub Copilot Chat. Digite @pgsql seguido da sua pergunta, e o participante responde usando o contexto do esquema em tempo real da sua base de dados conectada.

Para iniciar um fluxo de trabalho orientado por ferramentas com uma base de dados já dentro do âmbito, clique com o botão direito num nó da base de dados na árvore de Conexões e selecione Conectar IA.

Para orientação do utilizador final, exemplos de instruções e resolução de problemas, prossiga para @pgsql participante de chat.

Utilize as ações do editor para ajuda centrada em consultas

Quando tiver SQL aberto no editor de consultas, clique com o botão direito para encontrar o submenu de Ações de Consulta da IA . Contém as seguintes ações:

Ação Description
Explicar consulta Devolve uma explicação em linguagem simples do que a consulta faz.
Consulta de Reescrita Sugere uma versão alternativa da consulta, preservando o resultado pretendido.
Analisar o desempenho das consultas Executa EXPLAIN ANALYZE contra a base de dados ligada, depois envia o plano de execução para a IA para análise.

Também pode selecionar Ask AI sobre esta Consulta na barra de ferramentas do editor para abrir uma conversa de chat baseada no conteúdo atual do editor.

Para repor as preferências de inclusão de consultas guardadas para a análise do plano, execute Clear query inclusion preferences for AI analysis na Paleta de Comandos.

Use o modo Agente para fluxos de trabalho orientados por ferramentas

O modo agente dá ao assistente de IA acesso às ferramentas PostgreSQL para que possa ligar-se, inspecionar esquemas, executar consultas, abrir scripts e trabalhar tarefas em vários passos numa só conversa. Clique com o botão direito num nó de base de dados na árvore de Ligações e selecione Connect AI para iniciar uma sessão em modo Agente.

Para famílias de ferramentas, fluxos de trabalho de exemplo e resolução de problemas, continue para o modo Agente.

Use o servidor MCP em hosts suportados

A extensão regista um Fornecedor do Servidor MCP das Ferramentas do PostgreSQL (ID: pgsql-tools-mcp-server-provider) que expõe o mesmo conjunto de ferramentas do PostgreSQL através do Protocolo de Contexto do Modelo. Os hosts compatíveis com MCP podem descobrir e invocar estas ferramentas sem recorrer aos fluxos de trabalho de chat incorporados.

Para obter informações sobre hosts suportados, comportamento de registo automático e famílias de ferramentas expostas através do MCP, consulte o servidor MCP.

Configurar modo de acesso

A pgsql.copilot.accessMode definição controla quanto acesso à base de dados o assistente de IA recebe através do modo Agente e das ferramentas MCP. O padrão é Read/Write (rw).

Valor de configuração Etiqueta de UI O que o assistente de IA pode fazer
ro Somente leitura Operações de apenas leitura: SELECT, SHOW, EXPLAIN, inspeção de esquemas
rw Ler/Escrever Operações de leitura mais instruções de modificação de dados e DDL, com confirmação explícita

Override por ligação

Também podes definir o modo de acesso em ligações individuais. No diálogo de ligação, expanda a secção Copilot (IA em Cursor) e defina o modo de acesso Copilot (modo de acesso IA em Cursor) para um dos:

Option Comportamento
Usar Configuração Global Volta ao valor global pgsql.copilot.accessMode (por defeito)
Somente leitura Força o acesso apenas de leitura para esta ligação, independentemente da configuração global
Ler/Escrever Força o acesso de leitura/escrita para esta ligação independentemente da configuração global

A extensão resolve o modo de acesso efetivo usando esta cadeia de recurso: valor por ligação → definição global pgsql.copilot.accessMode → padrão (rw).

Atenção

Utilize Read Only para bases de dados em produção, a menos que pretenda deliberadamente disponibilizar alterações ao esquema ou aos dados através do assistente de IA.

Configurar definições adicionais

Configuração O que controla Predefinição
pgsql.copilot.enable Ativa ou desativa toda a integração de IA na extensão true
pgsql.copilot.accessMode Modo de acesso global à IA (Só Leitura ou Leitura/Escrita) rw
pgsql.copilot.autoAttachQuery Se o texto da consulta SQL é incluído ao analisar planos com IA: Pergunte Sempre, Inclua Sempre ou Nunca Inclua ask
pgsql.copilot.modelOptions Ajuste avançado de modelos (max tokens, temperatura, top_p) para os fluxos de trabalho de IA da extensão -

Os IDs de definição mantêm o prefixo pgsql.copilot.* em ambos os editores por retrocompatibilidade, mesmo quando os rótulos visíveis para o utilizador dizem "IA".

Integrações de IA específicas por funcionalidades

Várias funcionalidades incluem pontos dedicados de integração de IA:

Feature Capacidade de IA
Visualizador de plano de consulta Analise dados de planos de execução com Analise com Copilot (ou Analise com IA no Cursor)
Painel do servidor Abrir sessões de chat a partir dos botões Perguntar ao Copilot (Ask AI no Cursor) nos painéis de Consultas, Esperas, Sessões e tabela métrica
Visualizador de esquema Visualizar relações de esquema a partir de um fluxo de trabalho em modo Agente

Conteúdo relacionado

  • Last updated on