Integração do copilot

A extensão PostgreSQL integra-se a assistentes de IA por meio de três formas de integração: o participante de chat @pgsql (somente no Visual Studio Code), ferramentas do modo Agente e um Provedor de servidor MCP das Ferramentas do PostgreSQL. Esta página ajuda você a escolher o ponto de entrada certo e a entender a configuração compartilhada que se aplica entre os três.

A extensão é executada em Visual Studio Code (com GitHub Copilot) e cursor (com sua IA interna). A maioria das funcionalidades funciona da mesma maneira em ambos os editores; os poucos comportamentos específicos de cada editor são destacados ao longo deste artigo.

Pré-requisitos

Antes de usar qualquer recurso assistido por IA, verifique se os seguintes requisitos são atendidos:

  • A extensão PostgreSQL está instalada e você tem pelo menos uma conexão de banco de dados configurada.
  • Um assistente de IA está disponível em seu editor:
    • Visual Studio Code: instale GitHub Copilot ou GitHub Copilot Chat e entre com uma assinatura ativa.
    • Cursor: nenhuma instalação extra; a IA interna é usada automaticamente.

Note

Os recursos do Copilot são ativados por padrão (pgsql.copilot.enable é true). Quando você define isso comofalse, o participante do chat @pgsql (somente Visual Studio Code), o submenu do editor de Ações de Consulta de IA, as ferramentas de modo agente e o provedor de servidor MCP ficam todos ocultos.

Dica

A assistência à IA funciona melhor quando você já tem uma conexão de banco de dados ativa. Se você ainda não se conectou, comece com Conexões e identidade.

Escolha o ponto de entrada certo

Se você quiser... Comece por aqui Availability Saiba mais
Faça uma pergunta com reconhecimento do esquema sobre seu banco de dados @pgsql participante do chat Visual Studio Code somente participante do chat @pgsql
Iniciar o modo Agente com um banco de dados específico já definido no escopo Conectar a IA de um nó de banco de dados na árvore Conexões Visual Studio Code e Cursor Modo de agente
Explicar, reescrever ou analisar o SQL do editor submenu Ações de Consulta de IA no menu de contexto do editor Visual Studio Code e Cursor Ações do editor
Automatizar uma tarefa de banco de dados de várias etapas Conecte a IA a um nó de banco de dados para iniciar o modo Agente Visual Studio Code e Cursor Modo de agente
Expor ferramentas do PostgreSQL a hosts compatíveis com MCP Provedor de Servidor MCP de Ferramentas do PostgreSQL Visual Studio Code e Cursor Servidor MCP

Usar @pgsql para chat com reconhecimento de esquema

Note

O participante do chat @pgsql é registrado apenas em Visual Studio Code, em que ele se conecta ao GitHub Copilot Chat. No Cursor, use Connect AI a partir de um nó de banco de dados na árvore Conexões para iniciar o modo Agente com o mesmo contexto de esquema, ou conte com o servidor MCP na interface de chat nativa do Cursor.

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

Para iniciar um fluxo de trabalho controlado por ferramentas com um banco de dados já no escopo, clique com o botão direito do mouse em um nó de banco de dados na árvore Conexões e selecione Conectar IA.

Para orientações para o usuário final, exemplos de prompts e solução de problemas, acesse @pgsql chat participant.

Use as ações do editor para ajuda focada em consultas

Quando você tiver o SQL aberto no editor de consultas, clique com o botão direito do mouse para localizar o submenu ações de consulta de IA . Ele contém as seguintes ações:

Ação Description
Explicar a consulta Retorna uma explicação em linguagem simples do que a consulta faz.
Reformular consulta Sugere uma versão alternativa da consulta preservando o resultado pretendido.
Analisar o desempenho da consulta Executa EXPLAIN ANALYZE no banco de dados conectado e envia o plano de execução para a IA para análise.

Você também pode selecionar Perguntar à IA sobre essa consulta na barra de ferramentas do editor para abrir uma conversa de chat aterrada no conteúdo atual do editor.

Para redefinir as opções de inclusão de consulta salvas para a análise do plano, execute Limpar preferências de inclusão de consulta para análise de IA na Paleta de Comandos.

Usar o modo agent para fluxos de trabalho controlados por ferramentas

O modo de agente fornece ao assistente de IA acesso às ferramentas do PostgreSQL para que ele possa se conectar, inspecionar o esquema, executar consultas, abrir scripts e trabalhar em tarefas de várias etapas em uma conversa. Clique com o botão direito do mouse em um nó de banco de dados na árvore Conexões e selecione Conectar IA para iniciar uma sessão do modo Agent.

Para famílias de ferramentas, exemplos de fluxos de trabalho e solução de problemas, prossiga para o modo agente.

Usar o servidor MCP em hosts com suporte

A extensão registra um Provedor do servidor MCP do PostgreSQL Tools (ID: pgsql-tools-mcp-server-provider) que expõe o mesmo conjunto de ferramentas do PostgreSQL por meio do Protocolo de Contexto de Modelo. Hosts compatíveis com MCP podem descobrir e invocar essas ferramentas sem usar os fluxos de trabalho de chat internos.

Para obter informações sobre hosts compatíveis, o comportamento de registro automático e as famílias de ferramentas expostas por meio do MCP, consulte servidor MCP.

Configurar o modo de acesso

A pgsql.copilot.accessMode configuração controla a quantidade de acesso de banco de dados que o assistente de IA recebe entre o modo agente e as ferramentas MCP. O padrão é Leitura/Gravação (rw).

Valor de configuração Rótulo de UI O que o assistente de IA pode fazer
ro Somente leitura Operações somente de leitura: SELECT, SHOW, EXPLAIN, inspeção de esquema
rw Leitura/Escrita Operações de leitura mais instruções de modificação de dados e DDL, com confirmação explícita

Sobrescrita para cada conexão

Você também pode definir o modo de acesso em conexões individuais. Na caixa de diálogo de conexão, expanda a seção Copilot (IA no Cursor) e defina Copilot modo de acesso (modo de acesso à IA no Cursor) como um dos seguintes:

Opção Behavior
Usar Configuração Global Volta para o valor global pgsql.copilot.accessMode (padrão)
Somente leitura Força o acesso de somente leitura para essa conexão, independentemente da configuração global
Leitura/Escrita Força o acesso de leitura e gravação para esta conexão, independentemente da configuração global

A extensão resolve o modo de acesso efetivo usando essa cadeia de fallback: valor por conexão → configuração global pgsql.copilot.accessMode → padrão (rw).

Caution

Use Somente leitura para bancos de dados de produção, a menos que você queira permitir alterações no esquema ou nos dados por meio do assistente de IA.

Definir as configurações adicionais

Configuração O que controla Default
pgsql.copilot.enable Habilita ou desabilita toda a integração de IA na extensão true
pgsql.copilot.accessMode Modo de acesso global à IA (somente leitura ou leitura/gravação) rw
pgsql.copilot.autoAttachQuery Se o texto da consulta SQL está incluído ao analisar planos com IA: Perguntar sempre, Sempre Incluir ou Nunca Incluir ask
pgsql.copilot.modelOptions Ajuste de modelo avançado (tokens máximos, temperatura, top_p) para os fluxos de trabalho de IA da extensão -

Os IDs de configuração mantêm o prefixo pgsql.copilot.* em ambos os editores para compatibilidade com versões anteriores, mesmo quando os rótulos visíveis para o usuário mostram "IA".

Integrações de IA específicas de funcionalidades

Vários recursos incluem pontos de integração de IA dedicados:

Característica Funcionalidade de IA
Visualizador de plano de consulta Analisar dados de plano de execução com Analisar com Copilot (ou Analisar com IA no Cursor)
Painel do servidor Abra sessões de chat pelos botões Perguntar ao Copilot (Ask AI no Cursor) nos painéis Consultas, Esperas, Sessões e de gráficos de métricas
Visualizador de esquema Visualizar relações de esquema de um fluxo de trabalho do modo Agent

Conteúdo relacionado

  • Last updated on