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:

ItemO que definir
Endereço do servidorHost e porta do PostgreSQL, acessíveis pela internet ou liberados para a conexão
Nome do bancoO banco que será consultado
UsuárioUm usuário exclusivo para o agente, só com SELECT
SenhaGerada só para esse usuário, guardada em local seguro
TabelasApenas 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:

  1. Entre no DoubleX Agentes e abra a tela Conectores.
  2. Procure por PostgreSQL (categoria dados) e inicie a conexão.
  3. Preencha os dados de acesso do banco: servidor, banco, usuário de leitura e senha.
  4. Escolha o escopo da conexão (pessoal, do time ou da empresa, explicado a seguir).
  5. Salve e confirme que o conector aparece como conectado.
  6. 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.

EscopoQuando usarCuidado
PessoalTeste inicial ou análise individual de quem administra o bancoSó essa pessoa usa a conexão
Do timeTime de dados, produto ou operações que consulta as mesmas tabelasUse um usuário de leitura limitado ao que o time precisa
Da empresaConsultas que várias áreas fazem sobre um conjunto de dados liberadoRevise 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.

  1. Abra uma conversa com o agente que recebeu o conector.
  2. Peça algo básico, como listar as tabelas disponíveis ou mostrar as colunas de uma tabela.
  3. Abra a tela Tarefas e entre na tarefa criada.
  4. Confira quais consultas o agente rodou e se o resultado bate com o banco.
  5. 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

Mais guias de PostgreSQL