Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O modo agente permite que o assistente de IA no seu editor use as ferramentas PostgreSQL da extensão como parte de uma única conversa em vários passos. Em vez de responder apenas a uma pergunta, o assistente pode ligar-se a uma base de dados, inspecionar esquemas, executar consultas, abrir scripts e ajudá-lo a avançar por um fluxo de trabalho de ponta a ponta.
O modo Agente corre tanto no Visual Studio Code (com GitHub Copilot) como no Cursor (com a sua IA incorporada). A extensão expõe a mesma superfície da ferramenta PostgreSQL em ambos os editores; Apenas o painel de chat que abre é diferente.
Usa o modo Agente quando quiseres que a IA tome ações estruturadas, não apenas expliques ou elabore SQL.
Pré-requisitos
Antes de começar, certifique-se de que:
- A extensão PostgreSQL instalada.
- Funcionalidades do Copilot/IA ativadas na extensão (
pgsql.copilot.enableétrue). - Pelo menos uma ligação à base de dados configurada na extensão.
- Um assistente de IA disponível no seu editor:
- Visual Studio Code: GitHub Copilot ou GitHub Copilot Chat instalado e ativo.
- Cursor: sem instalação extra; a IA incorporada é usada automaticamente.
Iniciar o modo Agente
- Liga-te ao servidor ou base de dados alvo na extensão PostgreSQL.
- Na árvore de Conexões , clique com o botão direito na base de dados que pretende usar.
- Selecione Connect AI.
- Continue a conversa no painel de chat que se abre com o fluxo de trabalho que pretende completar.
- No Visual Studio Code, este é o painel do GitHub Copilot Chat em modo Agente.
- No Cursor, este é o painel nativo de IA do Cursor; a extensão fornece um breve preâmbulo orientado para MCP para que o assistente saiba das ferramentas PostgreSQL disponíveis.
Depois do início da sessão, a IA pode combinar ferramentas PostgreSQL nos bastidores enquanto processa o seu pedido.
Escolha o modo de acesso certo
A pgsql.copilot.accessMode definição controla quanto acesso à base de dados o modo Agente recebe. O ID da definição mantém o seu pgsql.copilot.* prefixo para compatibilidade; o rótulo visível pelo utilizador é modo de acesso Copilot no Visual Studio Code e modo de acesso AI no Cursor.
| Mode | O que a IA pode fazer | Utilização recomendada |
|---|---|---|
ro |
Operações apenas de leitura como SELECT, SHOW, EXPLAIN, inspeção e análise de esquemas |
Sistemas de produção ou ambientes partilhados onde se quer investigação sem alterações |
rw |
Operações de leitura mais instruções de modificação de dados e DDL, com confirmação explícita antes da execução | Desenvolvimento local, sandboxes descartáveis e ambientes de teste controlados |
Atenção
Utilize o modo ro para bases de dados de produção, a menos que pretenda intencionalmente que alterações ao esquema ou aos dados estejam disponíveis no modo Agente.
Compreender as famílias de ferramentas
O modo agente pode usar várias famílias de ferramentas dependendo do fluxo de trabalho.
| Família de ferramentas | O que faz | Quando o usas |
|---|---|---|
| Ferramentas de ligação | Listar perfis, ligar, desconectar, listar bases de dados | Iniciar ou mudar de contexto |
| Ferramentas de contexto do esquema | Buscar definições de objetos ou visualizar esquema | Compreender tabelas, vistas, funções, índices e relações |
| Ferramentas de consulta | Executar consultas de leitura, inspecionar planos de consulta, abrir scripts | Investigar dados, validar ideias ou rever SQL gerado |
| Ferramentas de modificação | Executar DDL ou DML com confirmação | Aplicar alterações controladas ao esquema ou aos dados em modo rw |
| Ferramentas de importação de dados | Descreva ficheiros CSV e carregue-os em massa | Planeia e executa fluxos de trabalho de importação de CSV |
Gorjeta
No Cursor, as mesmas ferramentas também são apresentadas através do registo do servidor MCP. O chat nativo do Cursor pode invocá-los diretamente sem usar a via de acesso Connect AI. Consulte o servidor MCP para mais detalhes.
Use o modo Agente para fluxos de trabalho comuns
Os exemplos seguintes mostram como usar o modo Agente para tarefas que vão desde explorar uma nova base de dados até refinar consultas.
Explore uma base de dados desconhecida
Peça à IA para se ligar à base de dados, listar objetos-chave e resumir as áreas do esquema que são relevantes para a sua tarefa.
Example:
Liga-te à minha base de dados de desenvolvimento, lista as tabelas no esquema público e diz-me quais parecem relacionadas com clientes e encomendas.
Investigar o desempenho da consulta
Peça à IA para combinar o contexto do esquema com execução de consultas ou inspeção de planos.
Example:
Ligue-se à base de dados de staging, execute esta consulta em modo apenas de leitura e explique qual a parte do plano de execução que está a gerar o custo.
Carregar ou remodelar dados
Use o modo Agente quando o fluxo de trabalho incluir scripts ou operações baseadas em CSV.
Example:
Revê este ficheiro CSV, diz-me que esquema implica e prepara um plano de importação seguro para a
sales.recordstabela.
Passagem do rascunho para revisão manual
Quando quiseres um checkpoint de revisão humano antes da execução, pede à IA para abrir o SQL gerado no editor de consultas em vez de o executar imediatamente.
Saiba quando usar o modo Agente em vez de @pgsql
Use o participante @pgsql no chat quando quiser uma resposta com conhecimento do esquema ou um rascunho de consulta. O @pgsql participante está disponível apenas no Visual Studio Code.
Use o modo Agente (disponível tanto no Visual Studio Code como no Cursor) quando quiser que a IA:
- liga-te à base de dados certa para ti,
- encadear várias ferramentas numa só conversa,
- inspecionar os resultados antes do passo seguinte, ou
- Prepara um script ou um fluxo de trabalho de modificação controlada.
Note
No Cursor, o modo Agente é o caminho principal porque o @pgsql participante do chat não está disponível lá. O mesmo conjunto de ferramentas também pode ser acedido a partir do chat nativo do Cursor, através do servidor MCP.
Modo Agente de Resolução de Problemas
Se o modo Agente não funcionar como esperado, verifique primeiro o modo de acesso e a disponibilidade da ferramenta.
A IA não pode modificar a base de dados
Verifique pgsql.copilot.accessMode e confirme que a ligação ativa não está resolvida para ro.
A ferramenta que esperas não está disponível
Certifique-se de que a integração com o Copilot está ativada e que começou a partir de uma base de dados com um contexto de ligação PostgreSQL válido.
Um pedido de ligação falha
Confirme que o perfil de ligação ainda existe, as credenciais estão disponíveis e a extensão pode ligar-se à mesma base de dados fora do modo Agente.
Quero um fluxo de trabalho mais simples e focado no chat
No Visual Studio Code, utilize @pgsql participante de conversa sempre que pretender explicações, redação de consultas ou questões sobre o esquema sem automação baseada em ferramentas. No Cursor, faça as mesmas perguntas do chat local. As ferramentas MCP da extensão continuam a poder ser detetadas, mas o chat torna-se mais conversacional sem uma opção explícita de modo Agente.