@pgsql participante do chat

A extensão PostgreSQL regista um participante @pgsql chat no GitHub Copilot Chat. Use-o quando quiser ajuda consciente do esquema sobre a base de dados que já usa na extensão, como descoberta de objetos, redação de consultas, explicação de consultas ou sugestões de próximo passo.

O participante funciona melhor quando já existe uma ligação ativa, porque pode usar o esquema dessa base de dados em tempo real.

Importante

O @pgsql participante do chat está disponível apenas no Visual Studio Code. Liga-se ao GitHub Copilot Chat, que não está disponível no Cursor ou noutros forks. No Cursor, utilize Connect AI a partir de um nó da base de dados na árvore de Connections para iniciar o modo Agent com o contexto do mesmo esquema, ou invoque diretamente as ferramentas PostgreSQL da extensão a partir do chat nativo do Cursor por meio do servidor MCP.

Pré-requisitos

Antes de começar, certifique-se de que:

  • GitHub Copilot ou GitHub Copilot Chat instalado e ativo no Visual Studio Code.
  • A extensão PostgreSQL instalada.
  • Funcionalidades do Copilot/IA ativadas na extensão (pgsql.copilot.enable é true).
  • Uma ligação PostgreSQL configurada na extensão.

Observação

Se fizer @pgsql uma pergunta sem uma ligação ativa, ele ainda pode responder a perguntas gerais do PostgreSQL, mas não poderá referenciar o seu esquema, tabelas ou colunas reais.

Inicie uma conversa com base em esquemas

  1. Ligue-se à base de dados alvo na extensão PostgreSQL.
  2. Abra o GitHub Copilot Chat.
  3. Escreve @pgsql seguido da tua pergunta.
  4. Revê a resposta e decide se precisas de uma pergunta de seguimento, de um rascunho da proposta ou de um fluxo de trabalho mais aprofundado no modo Agente.

Traz o contexto da base de dados para o modo Agente

Se já sabe com que base de dados quer trabalhar, comece a partir do nó da base de dados na árvore Connections e selecione Connect AI para abrir o modo Agente com o contexto da base de dados já definido. Este caminho funciona tanto no Visual Studio Code como no Cursor.

Use esse caminho quando quiser que o assistente de IA se ligue, inspecione o esquema e trabalhe numa tarefa como:

  • "Que tabelas estão nesta base de dados?"
  • Quais tabelas parecem relacionadas com clientes e encomendas?
  • "Escreva uma query que mostre os 10 principais clientes por número de encomendas."

Faça perguntas que funcionem bem com @pgsql

O participante @pgsql do chat é especialmente útil para estes tipos de tarefas:

Goal Exemplo de prompt
Explorar o esquema @pgsql What tables are in the public schema?
Compreender as relações @pgsql Which tables connect orders to customers?
Rascunho de SQL @pgsql Write a query that shows monthly revenue by region.
Explique o SQL existente @pgsql Explain what this query is doing and where it might be slow.
Planeie os próximos passos @pgsql I need to add a customer status field. What should I review before I change the schema?

Peça uma decisão de cada vez quando quiser os resultados mais claros. Se precisar de um fluxo de trabalho em vários passos que ligue, inspecione o esquema, execute uma consulta e devolva resultados numa só conversa, passe para o modo Agente.

Revise e use a resposta

Use @pgsql as respostas como orientação de trabalho, não como resultado final não revisto.

  • Revise o SQL gerado antes de o executar.
  • Usa o editor de consultas quando quiseres testar ou refinar uma consulta manualmente.
  • Use a árvore Connections ou o visualizador de esquemas para confirmar os objetos mencionados pelo participante.
  • Usa o modo Agente quando quiseres que o assistente IA tome ações em vez de apenas responder.

Gorjeta

Comece com perguntas de descoberta de esquemas antes de pedir grandes reescritas de consultas. Quanto melhor o participante compreender o contexto da sua base de dados, melhores tendem a ser as próximas respostas.

Respostas de resolução @pgsql de problemas

A resposta é demasiado genérica

Certifica-te de que estás ligado à base de dados correta e faz uma pergunta específica do esquema em vez de uma pergunta geral do PostgreSQL.

O participante não consegue encontrar os objetos certos

Confirme primeiro os nomes dos objetos na árvore Connections e depois inclua os nomes do esquema ou das tabelas diretamente no seu prompt.

Estou no Cursor e não vejo nada @pgsql

O participante do chat está registado apenas no Visual Studio Code. No Cursor, usa Connect AI da árvore de Conexões para iniciar o modo Agente, ou confia no servidor MCP para expor as mesmas ferramentas ao chat nativo do Cursor.

Quero que a IA faça mais do que responder

Use o modo Agente quando quiser que a IA combine ligação, inspeção de esquemas, consultas, scripts ou operações de dados num único fluxo de trabalho.