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.
O modo de agente permite que o assistente de IA em seu editor use as ferramentas do PostgreSQL da extensão como parte de uma única conversa de várias etapas. Em vez de responder apenas a uma pergunta, o assistente pode se conectar a um banco de dados, inspecionar o esquema, executar consultas, abrir scripts e ajudá-lo a percorrer um fluxo de trabalho de ponta a ponta.
O modo de agente é executado em Visual Studio Code (com GitHub Copilot) e Cursor (com sua IA interna). A extensão expõe a mesma superfície de ferramenta PostgreSQL em ambos os editores; somente o painel de chat aberto difere.
Use o modo Agente quando quiser que a IA realize ações estruturadas, não apenas explique ou elabore rascunhos de SQL.
Pré-requisitos
Antes de começar, verifique se você tem estes itens:
- A extensão PostgreSQL instalada.
- Os recursos do Copilot/de IA habilitados na extensão (
pgsql.copilot.enableétrue). - Pelo menos uma conexão de banco de dados configurada na extensão.
- Um assistente de IA disponível em seu editor:
- Visual Studio Code: GitHub Copilot ou chat GitHub Copilot instalado e ativo.
- Cursor: nenhuma instalação extra; a IA interna é usada automaticamente.
Iniciar modo Agente
- Conecte-se ao servidor de destino ou banco de dados na extensão PostgreSQL.
- Na árvore Conexões , clique com o botão direito do mouse no banco de dados que você deseja usar.
- Selecione Conectar IA.
- Continue a conversa no painel de chat que é aberto com o fluxo de trabalho que você deseja concluir.
- Em Visual Studio Code, este é o painel Copilot Chat do GitHub no modo Agente.
- No Cursor, este é o painel de IA nativo do Cursor; a extensão fornece um breve preâmbulo orientado a MCP para que o assistente saiba sobre as ferramentas postgreSQL disponíveis.
Depois que a sessão começa, a IA pode combinar ferramentas do PostgreSQL nos bastidores enquanto processa sua solicitação.
Escolher o modo de acesso correto
A pgsql.copilot.accessMode configuração controla a quantidade de acesso de banco de dados que o modo do Agente recebe. O ID da configuração mantém o prefixo pgsql.copilot.* para compatibilidade; o rótulo visível para o usuário é modo de acesso do Copilot no Visual Studio Code e modo de acesso à IA no Cursor.
| Mode | O que a IA pode fazer | Uso recomendado |
|---|---|---|
ro |
Operações somente de leitura, como SELECT, SHOW, EXPLAIN, inspeção do esquema e análise |
Sistemas de produção ou ambientes compartilhados em que você deseja investigar sem alterações |
rw |
Operações de leitura, além de instruções de modificação de dados e DDL, com confirmação explícita antes da execução | Desenvolvimento local, ambientes isolados descartáveis e ambientes de teste controlados |
Caution
Use o modo ro para bancos de dados de produção, a menos que você queira intencionalmente que alterações no esquema ou nos dados fiquem disponíveis por meio do modo Agente.
Entender as famílias de ferramentas
O modo de agente pode usar várias famílias de ferramentas dependendo do fluxo de trabalho.
| Família de ferramentas | O que faz | Quando você o usa |
|---|---|---|
| Ferramentas de conexão | Listar perfis, conectar, desconectar, listar bancos de dados | Iniciar ou alternar o contexto |
| Ferramentas de contexto do esquema | Buscar definições de objeto ou visualizar esquema | Entender tabelas, exibições, funções, índices e relações |
| Ferramentas de consulta | Executar consultas de leitura, inspecionar planos de consulta, abrir scripts | Investigar dados, validar ideias ou examinar o SQL gerado |
| Ferramentas de modificação | Executar DDL ou DML com confirmação | Aplicar alterações controladas de esquema ou de dados no modo rw |
| Ferramentas de importação de dados | Descrever arquivos CSV e fazer o carregamento em massa | Planejar e executar fluxos de trabalho de importação CSV |
Dica
No Cursor, as mesmas ferramentas também são exibidas por meio do registro do servidor MCP. O chat nativo do Cursor pode chamá-los diretamente sem usar o ponto de entrada Connect AI. Consulte o servidor MCP para obter detalhes.
Usar o modo agent para fluxos de trabalho comuns
Os exemplos a seguir mostram como usar o modo Agent para tarefas que vão desde explorar um novo banco de dados até refinar consultas.
Explorar um banco de dados desconhecido
Peça à IA para se conectar ao banco de dados, listar objetos de chave e resumir as áreas de esquema que importam para sua tarefa.
Exemplo:
Conecte-se ao meu banco de dados de desenvolvimento, liste as tabelas no esquema público e diga-me quais parecem relacionadas a clientes e pedidos.
Investigar o desempenho da consulta
Peça à IA para combinar o contexto do esquema com a execução da consulta ou a inspeção do plano.
Exemplo:
Conecte-se ao banco de dados de preparo, execute essa consulta no modo somente leitura e explique qual parte do plano de execução está gerando o custo.
Carregar ou remodelar dados
Use o modo Agent quando o fluxo de trabalho incluir scripts ou operações baseadas em CSV.
Exemplo:
Examine este arquivo CSV, diga-me o esquema que ele implica e prepare um plano de importação seguro para a
sales.recordstabela.
Passar do rascunho para a revisão manual
Quando você quiser um ponto de verificação de revisão humana antes da execução, peça à IA para abrir o SQL gerado no editor de consultas em vez de executá-lo imediatamente.
Saber quando usar o modo agent em vez de @pgsql
Use o participante do chat @pgsql quando você quiser uma resposta ciente do esquema ou um rascunho de consulta. O @pgsql participante está disponível apenas no Visual Studio Code.
Use o modo Agente (disponível no Visual Studio Code e no Cursor) quando quiser que a IA:
- conectar-se ao banco de dados certo para você,
- encadear várias ferramentas em uma conversa,
- inspecionar os resultados antes da próxima etapa ou
- preparar um script ou um fluxo de trabalho de modificação controlado.
Note
No Cursor, o modo Agente é o caminho principal porque o @pgsql participante do chat não está disponível lá. A mesma interface de ferramentas também pode ser acessada pelo chat nativo do Cursor por meio do servidor MCP.
Solucionar problemas do modo agente
Se o modo agent não se comportar conforme o esperado, verifique primeiro o modo de acesso e a disponibilidade da ferramenta.
A IA não pode modificar o banco de dados
Verifique pgsql.copilot.accessMode e confirme que a conexão ativa não é resolvida para ro.
A ferramenta esperada não está disponível
Verifique se Copilot integração está habilitada e se você começou a partir de um banco de dados com um contexto de conexão PostgreSQL válido.
Falha na solicitação de conexão
Confirme se o perfil de conexão ainda existe, as credenciais estão disponíveis e se a extensão pode se conectar ao mesmo banco de dados fora do modo agent.
Quero um fluxo de trabalho mais simples, centrado no chat
Em Visual Studio Code, use participante de chat @pgsql quando quiser explicações, elaboração de consultas ou dúvidas sobre o esquema sem automação orientada por ferramentas. No Cursor, faça os mesmos tipos de perguntas do chat nativo. As ferramentas MCP da extensão ainda são detectáveis, mas o chat se comporta mais conversacionalmente sem uma entrada de modo de agente explícita.