Cómo conectar PostgreSQL a un agente de IA paso a paso

· DoubleX

Respuesta rápida

Para conectar PostgreSQL a un agente de IA, crea un usuario de solo lectura en la base, agrega el conector PostgreSQL en la pantalla Conectores de DoubleX Agentes con sus credenciales, elige el alcance de la conexión, asigna el conector a los agentes y prueba una consulta revisando el historial en Tareas.

Conectar una base PostgreSQL a un agente de IA permite que tu equipo consulte datos de la empresa sin escribir SQL a mano cada vez. Lo importante es hacerlo con cuidado: un usuario con los permisos justos, una conexión de alcance adecuado y un historial que puedas auditar. Esta guía se centra en la configuración y en los controles de acceso para equipos técnicos.

¿Qué permite el conector PostgreSQL y por qué es de solo lectura?#

El conector PostgreSQL permite que un agente consulte directamente las tablas de un banco PostgreSQL, en modo de solo lectura. Un conector es un sistema ligado a la plataforma cuyas herramientas pueden usar los agentes.

El modo de solo lectura es el valor por defecto en los conectores de bases de datos (PostgreSQL y MySQL). Así el agente puede leer y analizar la información, pero no puede insertar, modificar ni borrar registros de tu base de producción. Para un equipo técnico, esto reduce el riesgo desde el diseño.

El agente trabaja sobre la base que ya tienes: no la reemplaza ni la migra.

¿Qué preparar antes de conectar (credenciales y usuario de lectura)?#

Antes de conectar, prepara los datos de acceso y, sobre todo, un usuario de base de datos dedicado solo a lectura. No uses el usuario administrador ni el que usa tu aplicación.

Reúne esta información con tu equipo de infraestructura:

ElementoQué definirRecomendación
Host y puertoDirección del servidor PostgreSQLConfirma que sea accesible desde internet o que exista una ruta segura de acceso
Nombre de la baseBase a consultarUna base por conexión
UsuarioCuenta exclusiva para el agenteCon permiso de lectura (SELECT) solo sobre las tablas necesarias
ContraseñaCredencial del usuarioGenérala solo para este uso, para poder rotarla sin afectar otros sistemas
Tablas visiblesEsquemas y tablas permitidosExcluye tablas con datos sensibles que el agente no necesite

¿Cómo agregar PostgreSQL en la pantalla Conectores?#

Se agrega desde la pantalla Conectores de DoubleX Agentes, eligiendo PostgreSQL e ingresando los datos de conexión. Las contraseñas, tokens y claves de las conexiones se guardan cifrados con AES-256-GCM.

  1. Entra a DoubleX Agentes y abre la pantalla Conectores.
  2. Busca PostgreSQL en la categoría de datos y selecciónalo.
  3. Ingresa los datos de conexión: servidor, puerto, base, usuario de lectura y contraseña.
  4. Elige el alcance de la conexión (personal, del equipo o de la empresa; lo vemos en la siguiente sección).
  5. Guarda la conexión y confirma que aparece como conectada.

Si aún no tienes cuenta, puedes crearla gratis y sin tarjeta. El Inicio rápido explica el recorrido inicial, y la documentación de Conectores describe cómo gestionarlos para quienes prefieren la API.

¿Conexión personal, del equipo o de la empresa: cuál elegir?#

Elige según quién debe poder usar la base. Una conexión puede ser personal (vale solo para la persona), del equipo o de la empresa.

AlcanceCuándo usarloCuidado
PersonalPruebas iniciales o consultas de una sola persona técnicaSolo esa persona la usa; no queda disponible para otros
Del equipoUn área (por ejemplo datos o producto) que consulta la misma baseLimita el acceso a ese equipo
De la empresaBase de uso transversal con datos poco sensiblesRevisa bien qué tablas expone el usuario de lectura

Una buena práctica es empezar con una conexión personal para validar, y pasar a una del equipo cuando el flujo esté probado. Los roles de dueño, administrador y miembro también ayudan a decidir quién gestiona la conexión.

¿Cómo elegir qué agentes y acciones tienen acceso a la base?#

Para cada agente, la empresa decide qué sistemas usa y, dentro de cada sistema, qué acciones puede ejecutar. Esto se define en la configuración del agente, en la pantalla Agentes.

  1. Abre el agente que necesita consultar la base (por ejemplo, un agente de análisis).
  2. Activa el conector PostgreSQL solo en ese agente.
  3. Revisa las acciones disponibles y deja habilitadas únicamente las que necesita.
  4. Mantén los demás agentes sin acceso a la base.

Así, un agente de atención al cliente, por ejemplo, no tendrá visibilidad sobre tablas que solo debe consultar un agente de finanzas. Como el conector es de solo lectura, el riesgo de alterar datos queda acotado, y aun así conviene aplicar el principio de mínimo privilegio también en el usuario de la base.

Para más contexto sobre cómo se organizan agentes y permisos, consulta la Introducción.

¿Cómo probar la conexión y revisar el historial en la pantalla Tareas?#

Prueba con una consulta simple a un agente que tenga el conector y revisa después la tarea en la pantalla Tareas. Cada pedido queda como una tarea con historial completo: el pedido, cada herramienta usada y el resultado.

  1. Abre una conversación con el agente que tiene PostgreSQL.
  2. Haz una pregunta acotada, como pedir la lista de tablas visibles o contar los registros de una tabla.
  3. Verifica que la respuesta coincide con lo que esperas de la base.
  4. Abre la pantalla Tareas y entra en esa tarea.
  5. Revisa qué consultas ejecutó el agente y cuándo, y quién hizo el pedido.

Si la conexión falla, revisa host, puerto, credenciales y las reglas de red o firewall de tu servidor. Una vez validado el acceso, los pedidos y rutinas concretos están en la guía de ejemplos de pedidos y rutinas con PostgreSQL. Si tu base está en Neon, mira también cómo conectar Neon a un agente de IA.

Preguntas frecuentes#

¿El agente puede modificar o borrar datos en PostgreSQL?#

No con este conector: PostgreSQL se conecta en modo de solo lectura. El agente consulta tablas, pero no cambia la base.

¿Mis datos se usan para entrenar modelos?#

No. El contenido de la empresa no se usa para entrenar modelos, y los pedidos solo van a proveedores de IA que no usan lo que reciben para entrenamiento. También existe la opción de retención cero en la pantalla Modelos.

¿Debo crear un usuario especial en PostgreSQL?#

Sí, es lo recomendable. Crea un usuario exclusivo con permiso de lectura solo sobre las tablas necesarias, para poder rotar su contraseña o revocarlo sin afectar otros sistemas.

¿Puedo ver qué consultó el agente?#

Sí. Cada pedido queda registrado como una tarea en la pantalla Tareas, con el pedido, las herramientas que usó el agente y el resultado.

¿Puedo conectar también MySQL?#

Sí, MySQL y MariaDB también tienen conector, igualmente en modo de solo lectura por defecto.

Guías relacionadas

Más guías de PostgreSQL