Paso 6: Conexiones de Base de Datos
Conectar una base de datos a tu agente es como entregarle las llaves de una hoja de calculo (piensa en Excel o Google Sheets) y dejar que trabaje las filas por ti — puede buscar entradas, agregar nuevas, actualizar las existentes y eliminar lo que ya no sirve, todo conversando en lenguaje natural. Una vez conectado, tu agente puede responder preguntas y hacer cambios sobre tus datos reales en lugar de adivinar.
Puedes conectar una o mas bases de datos de Nirvai a un mismo agente.
Antes de empezar
- Un agente guardado (al menos con el paso de Perfil completado)
- Al menos una base de datos creada en tu espacio de trabajo — consulta Crear bases de datos
- Una idea clara de lo que quieres que el agente haga con los datos (solo buscar informacion, o tambien cambiarla)
Como funciona
Cuando conectas una base de datos a un agente, Nirvai prepara automaticamente un conjunto de herramientas para esa base de datos. El agente usa estas herramientas para trabajar con tus datos, igual que usa cualquier otra herramienta.
Paso a paso
- Abre tu agente en el Panel de Control de Agentes
- Ve al panel de Bases de Datos
- Haz clic en Conectar Base de Datos
- Selecciona una base de datos de tu espacio de trabajo
- Elige un nivel de permisos (lo que el agente puede hacer — ver mas abajo)
- Las herramientas de base de datos se agregan automaticamente a tu agente
Image: The databases panel showing connected databases with permission levels
Tambien puedes empezar desde la propia base de datos. Abre una base de datos, haz clic en el menu de herramientas en el encabezado y elige Crear Herramientas de IA o Crear Agente de IA. El recorrido completo esta en Funciones de IA de Base de Datos.
Niveles de permisos
Cuando conectas una base de datos, decides lo que el agente puede hacer con ella. Elige el nivel mas bajo que aun cumpla con la tarea.
| Permiso | Herramientas otorgadas | Que puede hacer el agente |
|---|---|---|
| Lectura | 2 | Buscar registros y leer la estructura de la tabla |
| Escritura | 5 | Todo lo de Lectura, mas agregar registros (uno por uno o en lote) y actualizar los existentes |
| Completo | 7 | Todo lo de Escritura, mas eliminar registros y ejecutar busquedas personalizadas |
Herramientas por nivel de permisos
| Herramienta | Lectura | Escritura | Completo |
|---|---|---|---|
| Obtener info de tabla | Si | Si | Si |
| Seleccionar registros | Si | Si | Si |
| Insertar registro | — | Si | Si |
| Insercion masiva | — | Si | Si |
| Actualizar registros | — | Si | Si |
| Eliminar registros | — | — | Si |
| Consulta personalizada | — | — | Si |
Elige el nivel de permisos minimo que tu agente necesita. Un bot de preguntas frecuentes que solo busca informacion deberia tener Lectura. Un agente que gestiona prospectos o procesa pedidos necesita Escritura o Completo.
Las herramientas de base de datos y el limite de herramientas
Las herramientas de base de datos cuentan para el limite de 25 herramientas que tu agente comparte con sus herramientas personalizadas. Cada base de datos conectada agrega herramientas segun su nivel de permisos:
| Permiso | Herramientas agregadas por base de datos |
|---|---|
| Lectura | 2 |
| Escritura | 5 |
| Completo | 7 |
Por ejemplo, conectar 3 bases de datos con permiso Completo usa 21 herramientas — dejando espacio para 4 herramientas personalizadas.
Si estas cerca del limite, da permiso de Lectura a las bases de datos que el agente solo necesita consultar. Reserva Escritura y Completo para las bases de datos que realmente debe cambiar.
Como usa el agente las herramientas de base de datos
El agente decide cuando usar una herramienta de base de datos segun la solicitud del usuario y tus instrucciones. Por ejemplo:
| El usuario dice | El agente hace |
|---|---|
| "Muestrame todos los prospectos de la semana pasada" | Usa Seleccionar registros con un filtro de fecha |
| "Agrega un nuevo contacto: Juan, juan@email.com" | Usa Insertar registro con los valores proporcionados |
| "Marca la tarea #42 como completada" | Usa Actualizar registros para cambiar el estado |
| "Elimina la entrada duplicada de Acme Corp" | Usa Eliminar registros que coincidan con la condicion |
| "Cuantos pedidos procesamos este mes?" | Usa Seleccionar registros con un conteo |
El agente conoce la forma de tus datos (que columnas tiene y que tipo de valor admite cada una) y formatea los valores correctamente. Una columna de moneda recibe numeros decimales, una columna de seleccion multiple recibe una lista de valores, y asi sucesivamente.
Notificaciones en tiempo real
Cuando un agente cambia tu base de datos (agrega, actualiza o elimina un registro), aparece una alerta en tu navegador de inmediato si tienes esa base de datos abierta. La alerta muestra:
- Que operacion se realizo
- Cuantos registros fueron afectados
- Que agente hizo el cambio
De esta manera siempre sabes cuando un agente esta cambiando tus datos, incluso cuando no estas en el chat.
Casos de uso
| Escenario | Configuracion |
|---|---|
| Bot de busqueda de clientes | Conecta tu base de datos de clientes con permiso de Lectura. El agente encuentra registros por email, nombre o numero de pedido. |
| Agente de gestion de prospectos | Conecta tu base de datos de prospectos con permiso de Escritura. El agente agrega nuevos prospectos desde WhatsApp, actualiza su estado y marca duplicados. |
| Rastreador de inventario | Conecta tu base de datos de productos con permiso Completo. El agente ejecuta busquedas personalizadas para reportes de stock y actualiza cantidades en lote. |
| Asistente de entrada de datos | Conecta cualquier base de datos con permiso de Escritura. El agente lee datos entrantes (emails, formularios, mensajes) y agrega registros ordenados. |
Solucion de problemas
| Problema | Solucion |
|---|---|
| El agente no encuentra registros | Verifica el nivel de permisos — necesita al menos Lectura. Asegurate de que la redaccion del usuario coincida con los nombres de tus columnas. |
| El agente agrega datos incorrectamente | Verifica los tipos de columna. El agente sigue las indicaciones de formato de tu base de datos. Si los datos son consistentemente incorrectos, agrega una instruccion como "La columna de estado acepta: Abierto, En Progreso, Listo." |
| Error de "demasiadas herramientas" | Superaste el limite de 25 herramientas. Conecta menos bases de datos o baja sus niveles de permisos. |
| El agente cambia los registros equivocados | Agrega instrucciones mas claras sobre cuando actualizar o eliminar. Considera usar permiso de Lectura hasta que hayas probado como se comporta el agente. |
Que sigue
Despues de conectar tus datos, continua a Paso 7: Skills para darle a tu agente habilidades adicionales mas alla de las herramientas y el conocimiento.