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.
| Tarefa | Como o agente ajuda | Cuidado recomendado |
|---|---|---|
| Consultar dados | Roda um SQL de leitura e resume o resultado | Começar só com leitura |
| Conferir estrutura | Lista projetos e branches do Neon | Leitura é suficiente |
| Alterar dados ou estrutura | Executa SQL que modifica o banco | Liberar 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:
- 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.
- Abra a tela Conectores e escolha o Neon na lista.
- Siga a autorização do Neon para dar acesso à sua conta. Senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM.
- Escolha o tipo de conexão: pessoal, do time ou da empresa (veja a próxima seção).
- No agente, selecione o Neon entre os sistemas que ele pode usar.
- Defina as ações permitidas em cada sistema, deixando só leitura no começo.
- 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.
| Tipo | Quando usar | Exemplo |
|---|---|---|
| Pessoal | Testes e uso individual | Você explorando um branch de teste |
| Do time | Uma equipe usa o mesmo banco | Time de dados consultando métricas |
| Da empresa | Acesso comum a várias áreas | Consulta 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:
- Libere apenas consulta e listagem.
- Rode pedidos reais por alguns dias e leia o histórico.
- Se precisar de alterações, crie um agente separado para isso, com a permissão ligada.
- 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
- Como conectar o PostgreSQL a um agente de IA passo a passoVeja como conectar o PostgreSQL a um agente de IA em modo somente leitura: usuário de leitura, conexão, permissões por agente e teste no histórico.
- Como conectar o Box a um agente de IA passo a passoVeja como conectar o Box a um agente de IA: do cadastro ao primeiro pedido, com permissões, modo só leitura e histórico para controlar o acesso aos arquivos.