Construye tu agente
Conexiones de Base de Datos
Conecta tu agente a bases de datos de Nirvai para que pueda leer, escribir y gestionar tus datos
Conectar una base de datos a tu agente es como entregarle las llaves de una hoja de cálculo (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 más 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 información, o también cambiarla)
Cómo funciona
Cuando conectas una base de datos a un agente, Nirvai prepara automáticamente 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
- En el constructor, elige Bases de datos en el menú de la izquierda
- Haz clic en Agregar tabla y elige una tabla de tus bases de datos
- Elige un nivel de permisos (lo que el agente puede hacer — ver más abajo). El menú muestra cuántas herramientas agrega ese nivel
- Las herramientas de base de datos se agregan automáticamente a tu agente, y las columnas de la tabla aparecen como vista previa
Bases de datos
Tablas en las que este agente puede consultar datos y, si se lo permites, mantener actualizadas.
Este agente puede leer estos registros, y agregarlos, actualizarlos o eliminarlos.
También puedes empezar desde la propia base de datos. Abre una base de datos, haz clic en el menú de herramientas en el encabezado y elige Crear Herramientas de IA o Crear Agente de IA. El recorrido completo está 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 más bajo que aún cumpla con la tarea.
| Permiso | Herramientas otorgadas | Qué puede hacer el agente |
|---|---|---|
| Lectura | 1 | Buscar registros |
| Escritura | 5 | Todo lo de Lectura, más agregar registros, actualizar los existentes y leer/actualizar campos de contenido extenso |
| Completo | 6 | Todo lo de Escritura, más eliminar registros |
Herramientas por nivel de permisos
| Herramienta | Lectura | Escritura | Completo |
|---|---|---|---|
| Buscar registros | Sí | Sí | Sí |
| Agregar registros | — | Sí | Sí |
| Actualizar registros | — | Sí | Sí |
| Leer contenido extenso | — | Sí | Sí |
| Actualizar contenido extenso | — | Sí | Sí |
| Eliminar registros | — | — | Sí |
Elige el nivel de permisos mínimo que tu agente necesita. Un bot de preguntas frecuentes que solo busca información debería tener Lectura. Un agente que gestiona prospectos o procesa pedidos necesita Escritura o Completo.
Cuántas herramientas agregan las bases de datos
Todas tus bases de datos conectadas comparten un mismo conjunto de herramientas de base de datos — el agente simplemente apunta cada acción a la tabla correcta — así que conectar más bases de datos no sigue agregando herramientas. Lo que agregan depende del permiso más alto entre ellas:
| Permiso más alto entre tus bases de datos | Herramientas agregadas |
|---|---|
| Solo lectura | 1 |
| Escritura | 5 |
| Completo | 6 |
No hay límite de herramientas por agente, pero elige el permiso más bajo que cada base de datos necesite — por seguridad, y porque una lista de herramientas más corta ayuda al agente a elegir bien.
Cómo usa el agente las herramientas de base de datos
El agente decide cuándo usar una herramienta de base de datos según la solicitud del usuario y tus instrucciones. Por ejemplo:
| El usuario dice | El agente hace |
|---|---|
| "Muéstrame 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 condición |
| "¿Cuántos pedidos procesamos este mes?" | Usa Seleccionar registros con un conteo |
El agente conoce la forma de tus datos (qué columnas tiene y qué tipo de valor admite cada una) y formatea los valores correctamente. Una columna de moneda recibe números decimales, una columna de selección múltiple recibe una lista de valores, y así 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:
- Qué operación se realizó
- Cuántos registros fueron afectados
- Qué agente hizo el cambio
De esta manera siempre sabes cuándo un agente está cambiando tus datos, incluso cuando no estás en el chat.
Casos de uso
| Escenario | Configuración |
|---|---|
| Bot de búsqueda de clientes | Conecta tu base de datos de clientes con permiso de Lectura. El agente encuentra registros por email, nombre o número de pedido. |
| Agente de gestión 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 búsquedas 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. |
Solución de problemas
| Problema | Solución |
|---|---|
| El agente no encuentra registros | Verifica el nivel de permisos — necesita al menos Lectura. Asegúrate de que la redacción 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 instrucción como "La columna de estado acepta: Abierto, En Progreso, Listo." |
| El agente cambia los registros equivocados | Agrega instrucciones más claras sobre cuándo actualizar o eliminar. Considera usar permiso de Lectura hasta que hayas probado cómo se comporta el agente. |
Qué sigue
Luego, agrega rutinas que tu agente repite exactamente igual con Habilidades.