Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A extensão PostgreSQL registra um participante de chat @pgsql no GitHub Copilot Chat. Use-o quando quiser ajuda com reconhecimento de esquema sobre o banco de dados que você já usa na extensão, como descoberta de objeto, rascunho de consulta, explicação de consulta ou sugestões da próxima etapa.
O participante funciona melhor quando você já tem uma conexão ativa porque pode usar o contexto de esquema dinâmico desse banco de dados.
Importante
O @pgsql participante do chat está disponível somente em Visual Studio Code. Ele se integra ao GitHub Copilot Chat, que não está disponível no Cursor nem em outros forks. No Cursor, use o 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 invoque diretamente as ferramentas PostgreSQL da extensão do chat nativo do Cursor por meio do servidor MCP.
Pré-requisitos
Antes de começar, verifique se você tem estes itens:
- GitHub Copilot ou GitHub Copilot Chat instalados e ativos no Visual Studio Code.
- A extensão PostgreSQL instalada.
- Os recursos do Copilot/de IA habilitados na extensão (
pgsql.copilot.enableétrue). - Uma conexão PostgreSQL configurada na extensão.
Note
Se você fizer @pgsql uma pergunta sem uma conexão ativa, ela ainda poderá responder a perguntas gerais do PostgreSQL, mas ela não será capaz de referenciar seu esquema, tabelas ou colunas reais.
Iniciar um chat com reconhecimento de esquema
- Conecte-se ao banco de dados de destino na extensão PostgreSQL.
- Abra o GitHub Copilot Chat.
- Digite
@pgsqlseguido de sua pergunta. - Examine a resposta e decida se você precisa de uma pergunta de acompanhamento, um rascunho de consulta ou um fluxo de trabalho mais profundo no modo agent.
Adicionar o contexto do banco de dados ao modo Agente
Se você já souber com qual banco de dados deseja trabalhar, comece pelo nó do banco de dados na árvore Conexões e selecione Conectar a IA para abrir o modo Agente com o contexto do banco de dados já em escopo. Esse caminho funciona tanto no Visual Studio Code quanto no Cursor.
Use esse caminho quando quiser que o assistente de IA se conecte, inspecione o esquema e trabalhe por meio de uma tarefa como:
- "Quais tabelas estão neste banco de dados?"
- "Quais tabelas parecem relacionadas a clientes e pedidos?"
- "Escreva uma consulta que mostre os 10 principais clientes por contagem de pedidos."
Faça perguntas que funcionam bem com @pgsql
O @pgsql participante do chat é especialmente útil para esses tipos de tarefa:
| Objetivo | Prompt de exemplo |
|---|---|
| Explorar esquema | @pgsql What tables are in the public schema? |
| Entender os relacionamentos | @pgsql Which tables connect orders to customers? |
| Rascunho do SQL | @pgsql Write a query that shows monthly revenue by region. |
| Explicar o SQL existente | @pgsql Explain what this query is doing and where it might be slow. |
| Planejar as próximas etapas | @pgsql I need to add a customer status field. What should I review before I change the schema? |
Peça uma decisão por vez quando quiser os resultados mais claros. Se você precisar de um fluxo de trabalho de várias etapas que se conecte, inspecione o esquema, execute uma consulta e retorne os resultados em uma conversa, vá para o modo agente.
Examinar e usar a resposta
Use as respostas @pgsql como orientação de trabalho, não como resultado final não revisado.
- Examine o SQL gerado antes de executá-lo.
- Use o editor de consultas quando quiser testar ou refinar uma consulta manualmente.
- Use a árvore Conexões ou o visualizador de esquema para confirmar os objetos mencionados pelo participante.
- Use o modo Agente quando quiser que o assistente de IA execute ações em vez de responder apenas.
Dica
Comece com perguntas para descobrir o esquema antes de solicitar reescritas extensas de consultas. Quanto melhor o participante entender o contexto do banco de dados, melhor as próximas respostas tendem a ser.
Solucionar problemas nas @pgsql respostas
A resposta é muito genérica
Verifique se você está conectado ao banco de dados correto e faça uma pergunta específica ao esquema em vez de uma pergunta ampla do PostgreSQL.
O participante não consegue encontrar os objetos certos
Confirme os nomes de objeto na árvore Conexões primeiro e, em seguida, inclua os nomes de esquema ou tabela diretamente no prompt.
Estou no Cursor e não vejo @pgsql
O participante do chat é registrado apenas em Visual Studio Code. No Cursor, use Connect AI na árvore Conexões para iniciar o Modo Agente ou use o servidor MCP para disponibilizar as mesmas ferramentas ao chat nativo do Cursor.
Quero que a IA faça mais do que responder
Use o modo Agent quando quiser que a IA combine conexão, inspeção de esquema, consultas, scripts ou operações de dados em um fluxo de trabalho.