Introducción

wolkvox Studio incorpora el nuevo componente Agentic BD, también denominado Base de Datos Agéntica o Agentic MySQL BD, un módulo de inteligencia artificial diseñado para interactuar directamente con bases de datos MySQL mediante instrucciones en lenguaje natural.

El componente permite que un flujo consulte, inserte, actualice o elimine información y, cuando las directrices lo autoricen, ejecute acciones más avanzadas, como la creación de tablas. De esta manera, el diseñador puede automatizar operaciones de datos sin construir consultas SQL extensas ni desarrollar una API intermedia para cada acción.

Su comportamiento se controla desde el panel de configuración mediante directrices que establecen qué debe hacer el agente, sobre qué información puede trabajar y cuáles son sus restricciones. La solicitud específica puede escribirse directamente o recibirse desde una variable generada por otro componente del flujo.

El resultado de cada ejecución se almacena automáticamente en la variable predeterminada $ResDBAgentic, para que pueda ser utilizada por componentes posteriores del Routing Point.

Agentic BD está disponible en los siguientes tipos de Routing Point:

• Voice Flow
• Chat Flow
• Interaction Flow
• Agentic Engine

El componente no está disponible en Agent Scripting.

¿Para qué puede utilizarse Agentic BD?

El componente puede incorporarse en procesos que necesiten consultar o modificar información de forma automática. Algunos ejemplos son:

• Consultar el estado de una solicitud, pedido, cuenta o servicio.
• Buscar información de un cliente a partir de su documento o número telefónico.
• Registrar leads obtenidos durante una conversación.
• Insertar resultados generados por un componente de investigación.
• Actualizar datos de contacto o preferencias del usuario.
• Cambiar el estado de un caso, ticket o gestión.
• Crear registros de auditoría o seguimiento.
• Validar si un cliente cumple determinadas condiciones.
• Consultar inventarios, saldos, disponibilidad o historial.
• Eliminar o depurar registros cuando las reglas del proceso lo autoricen.
• Crear tablas o estructuras necesarias para un proceso controlado.
• Entregar datos de la base a otro componente del Routing Point.

Por ejemplo, un flujo puede ejecutar primero el componente Investigación Profunda, almacenar sus hallazgos en $ResDeepR y enviar posteriormente esa variable a Agentic BD para estructurar e insertar la información en una tabla MySQL.

Configuración del componente

1. En la barra lateral, selecciona la pestaña “Cognitivos”. Dentro de la sección Agentes, ubica el componente Agentic BD.
2. Arrástralo al lienzo de diseño.
3. Haz doble clic izquierdo sobre el componente para abrir su panel de configuración en el costado derecho.

En la pestaña “Nombre”, escribe una identificación que permita reconocer fácilmente la función del componente dentro del flujo.

Algunos ejemplos son:

• Consultar cliente.
• Registrar prospecto.
• Actualizar estado de solicitud.
• Guardar resultado de investigación.
• Validar saldo.

Selecciona la pestaña “Descripción” e ingresa información complementaria sobre el objetivo del componente.

Puedes indicar qué base de datos utiliza, qué operación ejecuta o en qué momento del flujo debe activarse.

Completa los campos de conexión:

• Usuario BD: nombre del usuario autorizado para acceder a la base de datos.
• Password DB: contraseña correspondiente al usuario configurado.
• Servidor IP: dirección IP del servidor donde se encuentra alojada la base de datos MySQL.
• Nombre Base de datos: nombre exacto de la base de datos sobre la cual trabajará el agente.

Verifica que la información sea correcta antes de realizar la prueba del componente.

En el campo “Directrices del BD Agentico”, escribe el contexto general, el objetivo y las reglas que debe cumplir el agente al trabajar con la base de datos.

Las directrices pueden especificar:

• El rol que debe asumir el agente.
• La tabla sobre la cual puede operar.
• Los campos que debe consultar o modificar.
• El formato esperado de los datos.
• Las operaciones permitidas.
• Las acciones que no debe ejecutar.
• La forma de tratar datos ausentes.
• Las condiciones necesarias para insertar o actualizar información.

Ejemplo:

# Rol y objetivo

Eres un agente especializado en extracción de datos y administración de bases de datos.

Debes analizar la información recibida, identificar los datos del prospecto e insertarlos en la tabla `prospectos`.

# Campos

- empresa
- ciudad
- telefono
- correo
- direccion
- notas
- fuente

# Reglas

- No inventes información.
- Cuando un dato no esté disponible, utiliza `null`.
- No elimines registros.
- No modifiques tablas diferentes a `prospectos`.
- Antes de insertar, valida que el registro no esté duplicado.

Las directrices deben establecer con claridad el alcance del agente. El componente utilizará estas instrucciones como referencia para interpretar cada solicitud.

En “Solicitud de BD”, escribe la tarea específica que debe ejecutar el agente.

La solicitud puede contener texto directo:

Consulta el cliente con documento 123456789 y devuelve su nombre, estado y saldo.

También puede utilizar una variable del flujo:

$ResDeepR

En este caso, Agentic BD recibe el contenido almacenado en la variable y lo procesa según las directrices configuradas. Esto permite conectar el componente con resultados de Investigación Profunda, mensajes del cliente, formularios, consultas anteriores u otros componentes.

Haz clic en “Probar Agente” para validar la configuración antes de incorporarla al flujo productivo.

El sistema genera un archivo HTML local en una ruta similar a:

C:/ipdialbox/download/wolkvox_agentic_mysql_test_20260724_132420.html

El reporte de prueba incluye información como:

• Fecha y hora de generación.
• Identificador del componente.
• Estado de la memoria de sesión.
• Servidor o host configurado.
• Usuario de la base de datos.
• Nombre de la base de datos.
• Directrices enviadas al agente.
• Solicitud procesada.
• Resultado de la ejecución.

El campo Result permite comprobar si la operación se realizó correctamente o conocer por qué no pudo completarse. Por ejemplo, puede indicar que faltaron datos obligatorios, que la solicitud no contenía información suficiente o que la operación solicitada no pudo ejecutarse en la base de datos.

Activa el checkbox “Habilitar Memoria de Sesión” cuando necesites que el componente conserve el contexto de ejecuciones anteriores durante la misma sesión.

• Activada: el agente puede considerar solicitudes y resultados anteriores.
• Desactivada: cada ejecución se procesa de manera independiente.

Esta opción puede utilizarse en procesos consecutivos, como consultar primero un registro y después actualizarlo utilizando el contexto ya obtenido.

En Variable resultado DB Agentico se muestra la variable predeterminada:

$ResDBAgentic

El nombre de esta variable es fijo y no puede modificarse.

En ella se almacena la respuesta generada por Agentic BD, que puede incluir:

• Los registros encontrados.
• La confirmación de una inserción.
• El resultado de una actualización.
• La cantidad de registros afectados.
• Un mensaje de validación.
• La explicación de un error o de una operación no ejecutada.

Posteriormente, $ResDBAgentic puede utilizarse para mostrar una respuesta al cliente, evaluar una condición, alimentar otro agente, guardar un registro adicional o continuar la automatización.

Haz clic en “Guardar” para aplicar los cambios realizados.