Cómo conectar Neon a un agente de IA y consultar Postgres

· DoubleX

Respuesta rápida

Para conectar Neon a un agente de IA, abre Conectores en DoubleX Agentes, agrega Neon, autoriza el acceso y elige si la conexión es personal, del equipo o de la empresa. Luego define qué acciones puede ejecutar el agente, empezando en solo lectura, y haz una primera consulta de prueba.

Neon es una plataforma de bases de datos Postgres con proyectos y branches. Cuando la conectas a un agente de IA, puedes pedirle en lenguaje natural que revise tablas, ejecute consultas o gestione branches, sin abrir una consola SQL. Este guía muestra cómo hacerlo con cuidado, empezando por lo más seguro.

¿Qué permite el conector de Neon al agente?#

El conector de Neon permite al agente gestionar proyectos y branches Postgres y ejecutar SQL. Es decir, el agente puede usar las herramientas de Neon para consultar datos y, si tú lo autorizas, también para cambiar cosas.

TareaCómo ayuda el agenteSistema
Revisar el contenido de una tablaEjecuta una consulta SQL y resume el resultadoNeon (Postgres)
Entender la estructura de una baseExplora proyectos y tablas y las describeNeon
Preparar un cambio de esquemaTrabaja en un branch aparte para no tocar el principalNeon (branches)
Entregar un informe con los datosGenera un artefacto con la consulta y el resultadoNeon + Artefactos

¿Qué necesito tener listo antes de conectar?#

Necesitas una cuenta en DoubleX Agentes, una cuenta de Neon con acceso al proyecto que quieres consultar y claridad sobre qué datos debe ver el agente. Crear la cuenta es gratis y no pide tarjeta.

  • Una cuenta de DoubleX Agentes (si aún no la tienes, el primer diagnóstico también es gratis).
  • Acceso a tu cuenta de Neon para autorizar la conexión.
  • Una decisión previa: ¿solo lectura o también cambios?
  • Un agente creado, o el diagnóstico hecho para que te proponga uno. Si es tu primera vez, revisa el Inicio rápido.

¿Cómo conectar Neon en DoubleX Agentes paso a paso?#

La conexión se hace desde la pantalla Conectores y se termina asignando el conector a un agente. Estos son los pasos:

  1. Entra en DoubleX Agentes y abre la pantalla Conectores.
  2. Busca Neon en la lista y elige conectarlo.
  3. Autoriza el acceso con tu cuenta de Neon.
  4. Elige el alcance de la conexión: personal, del equipo o de la empresa (te explico la diferencia abajo).
  5. Abre la pantalla Agentes, selecciona el agente que usará Neon y agrégale el conector.
  6. Define qué acciones puede ejecutar en Neon (ver sección de permisos).
  7. Pídele una primera consulta desde Tareas o en la conversación con el agente.

Si quieres conocer los detalles técnicos de los conectores por API, consulta la documentación de Conectores.

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

Elige según quién debe poder usar el acceso a Neon. Una conexión personal solo vale para ti; una del equipo o de la empresa la pueden usar otros agentes y personas con permiso.

TipoCuándo usarlaCuidado
PersonalPruebas tuyas, exploración inicialSolo funciona con tus credenciales; no sirve para rutinas de otras personas
Del equipoUn equipo técnico que comparte la baseRevisa quién pertenece al equipo
De la empresaAcceso común para varias áreasÚsala solo si de verdad todos deben llegar a esos datos

Como regla práctica, empieza con una conexión personal para probar y súbela de nivel cuando el flujo esté validado. Recuerda que una rutina programada corre con los permisos de quien la creó.

¿Cómo limitar las acciones del agente y mantener solo lectura?#

Para cada agente eliges qué sistemas usa y, dentro de cada sistema, qué acciones puede ejecutar. Las acciones que modifican datos pueden quedar desactivadas, de modo que el agente solo lea.

  1. En el agente, abre la configuración del conector de Neon.
  2. Deja activas las acciones de consulta y lectura.
  3. Desactiva las acciones que crean, modifican o eliminan datos o branches.
  4. Guarda y vuelve a probar con una consulta.

Si lo que necesitas es una conexión directa y de solo lectura a un Postgres que no está en Neon, mira cómo conectar PostgreSQL a un agente de IA.

¿Cómo probar con el primer pedido y revisar el historial de la tarea?#

Haz una consulta simple y de bajo riesgo, y luego revisa en Tareas qué hizo el agente. Cada pedido queda como una tarea con el historial completo: el pedido, cada herramienta usada y el resultado.

Ejemplos de pedidos que puedes copiar:

  • "Lista los proyectos de Neon a los que tienes acceso y dime cuántas tablas tiene cada uno."
  • "Describe la estructura de la tabla de clientes: columnas y tipos de datos."
  • "Ejecuta una consulta que cuente los registros creados en los últimos 7 días y preséntalo en una tabla."
  • "Revisa los branches del proyecto y dime cuál es el más reciente."

Después, abre la tarea en la pantalla Tareas y comprueba que la consulta SQL ejecutada es la que esperabas y que no hubo acciones fuera de lo pedido. Cuando estés conforme, puedes programar una rutina (por ejemplo, un resumen semanal). Para ver casos más avanzados, lee Neon con agente de IA: SQL, branches y rutinas.

Preguntas frecuentes#

¿Necesito saber SQL para usar Neon con un agente?#

No. Describes lo que necesitas con tus palabras y el agente arma la consulta. Aun así, conviene revisar el SQL en el historial de la tarea.

¿El agente puede modificar mi base de datos?#

Solo si tú lo permites. Las acciones que alteran datos pueden quedar desactivadas, y aun activadas el agente pide confirmación antes de alterar algo.

¿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. Además, puedes activar la opción de retención cero en Modelos.

¿Dónde se guardan las credenciales de la conexión?#

Las contraseñas, tokens y claves de las conexiones se almacenan cifrados con AES-256-GCM.

¿Puedo programar que el agente consulte Neon cada semana?#

Sí. Puedes crear una rutina con horario (por ejemplo, cada lunes), y corre con los permisos de quien la creó. Mira la documentación de Disparadores.

Guías relacionadas

Más guías de Neon