Como conectar o Neon a um agente de IA e consultar o Postgres

· DoubleX

Resposta rápida

Para conectar o Neon a um agente de IA, ligue o conector do Neon na tela Conectores do DoubleX Agentes, escolha se a conexão é pessoal, do time ou da empresa e defina as ações permitidas ao agente. Comece só com leitura e libere alterações depois de testar.

O Neon é uma plataforma de Postgres em que você organiza projetos e branches de banco de dados. Ao ligá-lo a um agente de IA, quem não escreve SQL todo dia consegue fazer perguntas sobre os dados em linguagem natural. Este guia mostra como fazer a ligação com segurança, começando por leitura.

O que o conector do Neon permite ao agente fazer?#

O conector do Neon permite que o agente gerencie projetos e branches Postgres e execute SQL. Na prática, o agente pode consultar tabelas, conferir o que existe em cada branch e rodar comandos SQL, dentro das ações que você liberar.

O que o agente faz de fato depende das permissões que você definir. Ações que alteram dados podem ficar desligadas, deixando o agente apenas com leitura.

TarefaComo o agente ajudaCuidado recomendado
Consultar dadosRoda um SQL de leitura e resume o resultadoComeçar só com leitura
Conferir estruturaLista projetos e branches do NeonLeitura é suficiente
Alterar dados ou estruturaExecuta SQL que modifica o bancoLiberar só após testes e com confirmação

O que preciso ter pronto antes de conectar?#

Você precisa de uma conta no DoubleX Agentes e de acesso ao projeto do Neon que quer usar. Criar a conta é grátis, sem cartão.

Antes de começar, deixe definido:

  • qual projeto e qual branch do Neon o agente vai consultar;
  • quem vai usar o agente (só você, um time ou a empresa toda);
  • quais perguntas você quer responder, para decidir se leitura basta;
  • se existe um branch de teste, para não começar direto nos dados de produção.

Como conectar o Neon no DoubleX Agentes passo a passo?#

Você conecta o Neon pela tela Conectores e depois vincula o conector a um agente. O fluxo é este:

  1. Entre no DoubleX Agentes e, se ainda não tem um agente para essa rotina, crie um na tela Agentes ou faça o diagnóstico e transforme o resultado em uma equipe de agentes.
  2. Abra a tela Conectores e escolha o Neon na lista.
  3. Siga a autorização do Neon para dar acesso à sua conta. Senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM.
  4. Escolha o tipo de conexão: pessoal, do time ou da empresa (veja a próxima seção).
  5. No agente, selecione o Neon entre os sistemas que ele pode usar.
  6. Defina as ações permitidas em cada sistema, deixando só leitura no começo.
  7. Peça a primeira tarefa e confira o resultado.

Para entender melhor a tela e a API de conectores, consulte a documentação de Conectores. Se é a sua primeira vez na plataforma, o Início rápido mostra o caminho completo.

Conexão pessoal, do time ou da empresa: qual escolher?#

Escolha pessoal se só você vai usar, do time se uma equipe compartilha o mesmo acesso e da empresa se vários times dependem dele. Uma conexão pessoal vale apenas para a pessoa que a criou.

TipoQuando usarExemplo
PessoalTestes e uso individualVocê explorando um branch de teste
Do timeUma equipe usa o mesmo bancoTime de dados consultando métricas
Da empresaAcesso comum a várias áreasConsulta padrão liberada a todos

Na dúvida, comece pessoal, valide e só depois amplie. Quanto menor o alcance, menor o risco.

Como limitar as ações do agente e manter só leitura?#

Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Para manter só leitura, deixe desligadas as ações que alteram dados no Neon.

Um caminho prudente:

  1. Libere apenas consulta e listagem.
  2. Rode pedidos reais por alguns dias e leia o histórico.
  3. Se precisar de alterações, crie um agente separado para isso, com a permissão ligada.
  4. Mantenha a confirmação antes de qualquer ação que altere algo: o agente pede sua aprovação e mostra o passo a passo do que fez.

Se a ideia é automatizar com SQL, branches e rotinas, veja o guia Neon com agente de IA: SQL, branches e rotinas para times técnicos.

Como testar com o primeiro pedido e conferir o histórico da tarefa?#

Faça um pedido simples de leitura e abra a tarefa na tela Tarefas. Cada pedido vira uma tarefa com histórico completo: o pedido, cada ferramenta usada e o resultado, com quem pediu e quando.

Exemplos de pedidos para copiar:

  • "Liste os projetos e branches que tenho no Neon."
  • "Mostre as tabelas do branch de teste e o que cada uma guarda."
  • "Consulte quantos pedidos foram criados nos últimos 7 dias e resuma em uma frase."
  • "Rode uma consulta de leitura para listar os 10 clientes mais recentes."

No histórico, confira o SQL executado, o branch usado e se o resultado bate com o que você esperava. Se algo estiver fora do esperado, ajuste as instruções do agente e repita. Se o seu banco é PostgreSQL direto, veja também como conectar o PostgreSQL a um agente de IA.

Perguntas frequentes#

Preciso saber SQL para usar o Neon com o agente?#

Não. Você descreve o que precisa com as próprias palavras e o agente executa o SQL. Mesmo assim, vale ler o SQL no histórico da tarefa para entender o que foi feito.

O agente pode alterar meu banco sem eu saber?#

Só se você liberar essas ações. Ações que alteram dados podem ficar desligadas, e antes de alterar algo o agente pede confirmação. Tudo fica registrado no histórico.

Meus dados do Neon treinam modelos de IA?#

Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores de IA que não usam o que recebem para treinamento. Há também a opção de retenção zero na tela Modelos.

Posso começar pelo meu uso pessoal e depois abrir para o time?#

Sim. Comece com uma conexão pessoal para validar e, quando estiver seguro, crie a conexão do time ou da empresa com as permissões que fizerem sentido.

Dá para rodar consultas em horários agendados?#

Dá. Você pode agendar uma rotina para o agente, por exemplo todo dia às 8h, e ela roda com as permissões de quem a criou. Veja a documentação de Gatilhos.

Guias relacionados

Mais guias de Neon