Como conectar o PostgreSQL a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o PostgreSQL a um agente de IA, crie um usuário de banco só com permissão de leitura, adicione o conector PostgreSQL na tela Conectores do DoubleX Agentes, informe as credenciais, escolha o escopo da conexão, libere o conector só para os agentes certos e teste o acesso conferindo o histórico da tarefa.
Times técnicos costumam ser os primeiros a ser chamados quando alguém da empresa precisa de um número que está no banco. Conectar o PostgreSQL a um agente de IA permite que essas perguntas sejam respondidas direto na fonte, sem abrir chamado e sem dar acesso irrestrito a ninguém. Este guia cobre a configuração e os cuidados de acesso. Para exemplos de pedidos e rotinas, veja o guia de PostgreSQL com agente de IA: exemplos de pedidos e rotinas.
O que o conector PostgreSQL permite e por que é somente leitura?#
O conector PostgreSQL permite que o agente consulte as tabelas de um banco PostgreSQL diretamente, em modo somente leitura. Ele lê os dados para responder, mas não grava, não altera e não apaga nada.
O modo somente leitura é o padrão dos conectores de banco de dados no DoubleX Agentes. Isso reduz o risco: mesmo que um pedido seja mal formulado, o agente não consegue modificar registros. Para o time técnico, o ideal é reforçar essa regra também no próprio banco, com um usuário que só tenha permissão de leitura.
O que preparar antes de conectar (credenciais, usuário de leitura)?#
Antes de conectar, prepare os dados de acesso ao banco e crie um usuário dedicado, com permissão apenas de leitura nas tabelas que o agente precisa enxergar. Não use o usuário administrador da aplicação.
Separe estas informações:
| Item | O que definir |
|---|---|
| Endereço do servidor | Host e porta do PostgreSQL, acessíveis pela internet ou liberados para a conexão |
| Nome do banco | O banco que será consultado |
| Usuário | Um usuário exclusivo para o agente, só com SELECT |
| Senha | Gerada só para esse usuário, guardada em local seguro |
| Tabelas | Apenas as que fazem sentido para as perguntas do negócio |
As senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM no DoubleX Agentes, e cada empresa tem o próprio banco de dados, separado das outras.
Como adicionar o PostgreSQL na tela Conectores?#
Você adiciona o PostgreSQL na tela Conectores, escolhendo o conector na lista e informando as credenciais do usuário de leitura. O fluxo é este:
- Entre no DoubleX Agentes e abra a tela Conectores.
- Procure por PostgreSQL (categoria dados) e inicie a conexão.
- Preencha os dados de acesso do banco: servidor, banco, usuário de leitura e senha.
- Escolha o escopo da conexão (pessoal, do time ou da empresa, explicado a seguir).
- Salve e confirme que o conector aparece como conectado.
- Abra a tela Agentes e libere o conector para os agentes que devem consultar o banco.
Se você ainda não tem conta, o Início rápido mostra como criar a conta e fazer o primeiro diagnóstico, ambos grátis e sem cartão.
Conexão pessoal, do time ou da empresa: qual escolher?#
Escolha conforme quem deve poder usar o acesso ao banco. Uma conexão pode ser pessoal (vale só para a pessoa), do time ou da empresa.
| Escopo | Quando usar | Cuidado |
|---|---|---|
| Pessoal | Teste inicial ou análise individual de quem administra o banco | Só essa pessoa usa a conexão |
| Do time | Time de dados, produto ou operações que consulta as mesmas tabelas | Use um usuário de leitura limitado ao que o time precisa |
| Da empresa | Consultas que várias áreas fazem sobre um conjunto de dados liberado | Revise bem quais tabelas o usuário enxerga |
Uma boa prática é começar pessoal, validar o resultado e só depois ampliar para o time. Os papéis de dono, administrador e membro ajudam a controlar quem gerencia as conexões.
Como escolher quais agentes e ações têm acesso ao banco?#
Para cada agente, a empresa escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Assim, só os agentes que precisam do PostgreSQL recebem o conector.
Na prática, crie ou ajuste um agente voltado para dados, como um agente de análise, e ligue o PostgreSQL só a ele. Um agente de atendimento, por exemplo, não precisa enxergar o banco. Como o conector já opera em modo somente leitura, as ações de consulta são o que está disponível.
O conteúdo da empresa não é usado para treinar modelos. Para exigir ainda mais controle, a tela Modelos tem a opção de retenção zero, que usa só provedores que não guardam nada depois da resposta.
Como testar a conexão e conferir o histórico na tela Tarefas?#
Teste fazendo ao agente uma pergunta simples e conferindo, na tela Tarefas, o que ele executou. Cada pedido vira uma tarefa com histórico completo: o pedido, cada ferramenta usada e o resultado.
- Abra uma conversa com o agente que recebeu o conector.
- Peça algo básico, como listar as tabelas disponíveis ou mostrar as colunas de uma tabela.
- Abra a tela Tarefas e entre na tarefa criada.
- Confira quais consultas o agente rodou e se o resultado bate com o banco.
- Se faltar alguma tabela, ajuste as permissões do usuário no PostgreSQL, não no agente.
O histórico mostra quem pediu, o que foi feito e quando, o que facilita a revisão pelo time técnico. Para entender o fluxo geral de conectores, consulte a documentação de Conectores. Se o seu Postgres está hospedado no Neon, veja também como conectar o Neon a um agente de IA.
Perguntas frequentes#
O agente consegue alterar ou apagar dados no PostgreSQL?#
Não. O conector PostgreSQL funciona em modo somente leitura, então o agente apenas consulta as tabelas. Para reforçar, use também um usuário de banco só com permissão de SELECT.
Preciso programar para conectar o PostgreSQL?#
Não. Você adiciona o conector na tela Conectores e informa as credenciais. Quem quiser ir além pode usar a API REST, a linha de comando ou o servidor MCP, descritos na introdução.
Posso usar o usuário administrador do banco?#
É melhor evitar. Crie um usuário exclusivo para o agente, só com leitura nas tabelas necessárias. Assim, o acesso fica restrito e fácil de revogar.
Onde vejo o que o agente consultou no banco?#
Na tela Tarefas. Cada pedido gera um histórico com o que foi solicitado, as ferramentas usadas e o resultado.
Os dados do meu banco 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.
Guias relacionados
- 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.
- Como conectar o Neon a um agente de IA e consultar o PostgresVeja como conectar o Neon a um agente de IA no DoubleX Agentes, escolher o tipo de conexão e começar em modo de leitura antes de liberar alterações.